table of contents
SARG(1) | SARG | SARG(1) |
NAME¶
sarg - Squid Analysis Report GeneratorSYNOPSIS¶
sarg [options] [logfile...]
DESCRIPTION¶
sarg is a log file parser and analyzer for the Squid Web Proxy Cache[1]. 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[2].
OPTIONS¶
A summary of options is included below.-h --help
-a hostname|ip address
-b filename
Warning
This option is currently unused.
-c filename
--convert
If the input log file name is -, the input log file is read from standard input.
--css
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.
-d date
-e email
-f filename
-g e|u
-i
Note
This requires the report_type option in config file to contain "users_sites".
--keeplogs
-l filename
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.
--lastlog n
-L filename
-m
-n
-o dir
-p
-P prefix --splitprefix prefix
The output files are written in the output directory specified with -o or in the current directory.
-r
-s string
--split
If the input log file name is -, the input log file is read from standard input.
Combined with -P, the log is written in several files each containing one day worth of the original log.
--statistics
-t string
-u user
-v
-w dir
-x
-z
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.
SEE ALSO¶
squid(8)AUTHORS¶
This manual page was written by Luigi Gangitano gangitano@lugroma3.org, for the Debian GNU/Linux system (but may be used by others). Revised by Billy Newsom.Currently maintained by Frédéric Marchal fmarchal@users.sourceforge.net.
AUTHORS¶
Frédéric Marchal <fmarchal@users.sourceforge.net>Billy Newsom
Luigi Gangitano <gangitano@lugroma3.org>
COPYRIGHT¶
Copyright © 2012 Frédéric MarchalNOTES¶
- 1.
- Squid Web Proxy Cache
- 2.
- squidGuard
27 May 2012 | sarg |