#
# TAG: access_log file
# Where is the access.log file
-# sarg -l file
+#
+# This option can be repeated up to 256 times to list rotated files or
+# files from different sources.
+#
+# The files named here must exists or sarg aborts. It is intended as a
+# safety against incomplete reporting due to problems occuring with the
+# logs.
+#
+# If some files are passed on the command line with "sarg -l file" or
+# "sarg file", the files listed here are ignored.
#
#access_log /usr/local/squid/var/logs/access.log
#
#date_format u
-# TAG: per_user_limit file MB
-# Saves userid on file if download exceed n MB.
-# This option allow you to disable user access if user exceed a download limit.
+# TAG: per_user_limit file MB ip/id
+# Write the user's ID (if last flag is 'id') or the user's IP address (if last flag is 'ip')
+# in file if download exceed n MB.
+# This option allows you to disable user access if users exceed a download limit.
+# The option may be repeated up to 16 times to generate several files with
+# different content type or limit.
+#
+# Examples:
+# per_user_limit userlimit_1G.txt 1000 ip
+# per_user_limit /var/log/sarg/userlimit_500M.log 500 id
#
#per_user_limit none
+# TAG: per_user_limit_file_create always/as_required
+# When to create a per_user_limit file.
+#
+# Use 'always' to always create the file requested by per_user_limit
+# even if it is empty.
+#
+# Use 'as_required' to create a per_user_limit file only if at least
+# one user crosses the limit.
+#
+#per_user_limit_file_create purge
+
# TAG: lastlog n
# How many reports files must be keept in reports directory.
# The oldest report file will be automatically removed.
# Only codes matching exactly one of the line is rejected. The
# comparison is not case sensitive.
#
-#exclude_codes /usr/local/sarg/exclude_codes
+#exclude_codes /usr/local/sarg/etc/exclude_codes
# TAG: replace_index string
# Replace "index.html" in the main index file with this string
# default value is 'cn'
#LDAPTargetAttr cn
+# TAG: LDAPNativeCharset charset-iconv-style
+# Character set to convert the LDAP string to.
+# For the list of some available charsets use: "iconv -l".
+# This option requires libiconv and sarg must have been built with --with-iconv.
+# default is empty line (UTF-8)
+#LDAPNativeCharset ISO-8859-1
+
# TAG: long_url yes|no
# If yes, the full url is showed in report.
# If no, only the site will be showed
# TAG: topuser_fields
# Which fields must be in Topuser report.
#
+# Valid columns are
+# NUM Report line number.
+# DATE_TIME Icons to display the date and time reports.
+# USERID Display the user's ID. It may be a name or the IP address depending on other settings.
+# USERIP Display the user's IP address.
+# CONNECT Number of connections made by the user.
+# BYTES Number of bytes downloaded by the user.
+# %BYTES Percent of the total downloaded volume.
+# IN-CACHE-OUT Percent of cache hit and miss.
+# USED_TIME How long it took to process the requests from that user.
+# MILISEC The same in milliseconds
+# %TIME Percent of the total processing time of the reported users.
+# TOTAL Add a line to the report with the total of every column.
+# AVERAGE Add a line to the report with the average of every column.
#topuser_fields NUM DATE_TIME USERID CONNECT BYTES %BYTES IN-CACHE-OUT USED_TIME MILISEC %TIME TOTAL AVERAGE
# TAG: user_report_fields
# TAG: realtime_types: GET,PUT,CONNECT,ICP_QUERY,POST
# Which records must be in realtime report.
#
-# realtime_types GET,PUT,CONNECT
+# realtime_types GET,PUT,CONNECT,POST
# TAG: realtime_unauthenticated_records: ignore|show
# What to do with unauthenticated records in realtime report.
# re:/([\w-]+)\.(\w*[a-zA-Z]\w*)(?::\d+)?$/\1.\2
#hostalias /usr/local/sarg/hostalias
+# TAG: useralias
+# The name of a text file containing the user names one per line and the
+# optional alias to use in the report instead of that user name.
+# User names may contain wildcards denoted by a *.
+# The user name may be followed by an optional alias but if no alias is
+# provided, the user name, including the wildcard, replaces any matching
+# user name found in the log.
+# User names replaced by identical aliases are grouped together in the
+# reports.
+# IP addresses are supported and accept the CIDR notation both for IPv4 and
+# IPv6 addresses.
+# Regular expressions can also be used if sarg was compiled with libpcre.
+# A regular expression is formated as re:/regexp/ alias
+# The regexp is a perl regular expression (see man perlre).
+# Subpatterns are allowed in the alias. Sarg recognizes sed (\1) or perl ($1)
+# subpatterns. Only 9 subpatterns are allowed in the replacement string.
+#useralias /usr/local/sarg/useralias
+
# TAG: keep_temp_log yes|no
# Keep temporary files created by sarg to produce its reports. The normal
# operation mode is to delete those files when they are not necessary any more.
# Use this option only to diagnose a problem with your reports. A better
# alternative is to run sarg from the command line with optino -k.
#keep_temp_log no
+
+# TAG: max_successive_log_errors n
+# Set the number of consecutive errors allowed in the input log file before
+# the reading is aborted with an error.
+#max_successive_log_errors 3
+
+# TAG: max_total_log_errors n
+# The reading of the input log file is interrupted if too many errors are found
+# in the log file. This parameter set the number of errors before the reading
+# is aborted. Set it to -1 to keep reading the logs irrespective of the
+# errors found.
+#
+# Note that the max_successive_log_errors is still taken into account and
+# cannot be disabled.
+#max_total_log_errors 50