sarg - Squid Analysis Report Generator
sarg [options] [logfile...]
sarg is a log file parser and analyzer for the Squid Web Proxy Cache. It allows you to view "where" your users are going to on the Internet.
sarg generates reports in HTML with fields such as: users, IP Addresses, bytes, sites, and times. These HTML files can appear in your web server's directory for browsing by users or administrators. You may also have sarg email the reports to the Squid Cache administrator.
sarg can read squid or Microsoft ISA access logs. Optionally, it can complement the reports with the log of a Squid filter/redirector such as squidGuard.
A summary of options is included below.
-a hostname|ip address
Using an external css can reduce the size of the report file. If you are short on disk space, you may consider exporting the css as explained above.
This requires the report_type option in config file to contain "users_sites".
This option is kept for compatibility with older versions of sarg but, starting with sarg 2.3, the log files may be named on the command line without the -l option. It allows the use of wildcards on the command line. Make sure you don't exceed the limit of 255 files.
-P prefix --splitprefix prefix
The output files are written in the output directory specified with -o or in the current directory.
Combined with -P, the log is written in several files each containing one day of the original log.
HOST EXCLUSION FILE
Sarg can be told to exclude visited hosts from the report by providing it with a file containing one host to exclude per line. The "host" may be one of the following:
Example 1. Example of a hosts exclusion file
Sarg cannot exclude IPv6 addresses at the moment.
This manual page was written by Luigi Gangitano<email@example.com>, for the Debian GNU/Linux system (but may be used by others). Revised by Billy Newsom.
Currently maintained by Frédéric Marchal<firstname.lastname@example.org>.
Frédéric Marchal <email@example.com>
Luigi Gangitano <firstname.lastname@example.org>
Copyright © 2012 Frédéric Marchal
- Squid Web Proxy Cache
|12 Nov 2015||sarg|