SARG

Section: User Commands (1)
Updated: april 28, 2002
Index Return to Main Contents

NAME

sarg - Squid Analysis Report Generator

SYNOPSIS

sarg [options]

DESCRIPTION

This manual page documents briefly the sarg command. This manual page was written for the Debian distribution because the original program does not have a manual page. Instead, it has documentation in the GNU Info format; see below.

sarg is a tool da allow you to view "where" your users are going to on the Internet. sarg generates reports in html, with fields such: users, IP Addresses, bytes, sites and times.

OPTIONS

A summary of options is included below.

-h: Show summary of options.
-a [hostname|ip address]: Limits report to records containing the specified hostname/ip address
-b filename: Enables UserAgent log and writes it to filename.
-c filename: Uses filename as the exclude files to select records that are not counted.
-d date: Uses date as the timelimit during logfile processing. Format for date is dd/mm/yyyy-dd/mm/yyyy
-e email: Sends report to email (stdout for console).
-f filename: Reads configuration from filename.
-g e|u: Sets date format in generated reports.
e = Europe -> dd/mm/yy
u = USA -> mm/dd/yy
-i: Generates reports by user and ip address.
NOTE: This requires the 'report_type' option in config file to contain "users_sites".
-l filename: Uses filename as the input log.
-n: Enables ip address resolution.
-o dir: Writes report in dir.
-p: Generates reports using ip address instead of userid.
-s string: Limits report to the site specified by string [eg. www.debian.org]
-t string: Limits records counted in statistics based on time-of-day. Format for string is HH or HH:MM or HH:MM:SS.
-u user: Limits reports to user activities.
-w dir: Uses dir for temporary files.
-x: Writes messages on processes to STDOUT
-x: Writes debug messages to STDOUT
-convert: Convert the logfile's date/time field to human-readable.
-split: Split the log file by date in -d parameter.

FILES

/etc/squid/sarg.conf

AUTHOR

This manual page was written by Luigi Gangitano <gangitano@lugroma3.org>, for the Debian GNU/Linux system (but may be used by others).