"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "sarg.conf" between
sarg-2.3.11.tar.gz and sarg-2.4.0.tar.gz

About: SARG ia a Squid Analysis Report Generator.

sarg.conf  (sarg-2.3.11):sarg.conf  (sarg-2.4.0)
# sarg.conf # sarg.conf
# #
# TAG: access_log file # TAG: access_log file
# Where is the access.log file # Where is the access.log file
# sarg -l file #
# This option can be repeated multiple 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 the file globbing was compiled in, the file name can contain shell
# wildcards such as * and ?. Tilde expension and variable expension are
# not supported. Special characters can be escaped with a backslash.
#
# 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 #access_log /usr/local/squid/var/logs/access.log
# TAG: graphs yes|no # TAG: graphs yes|no
# Use graphics where is possible. # Use graphics where is possible.
# graph_days_bytes_bar_color blue|green|yellow|orange|brown|red # graph_days_bytes_bar_color blue|green|yellow|orange|brown|red
# #
#graphs yes #graphs yes
#graph_days_bytes_bar_color orange #graph_days_bytes_bar_color orange
skipping to change at line 116 skipping to change at line 129
# If used, generate reports just for that users. # If used, generate reports just for that users.
# #
#password none #password none
# TAG: temporary_dir # TAG: temporary_dir
# Temporary directory name for work files # Temporary directory name for work files
# sarg -w dir # sarg -w dir
# #
#temporary_dir /tmp #temporary_dir /tmp
# TAG: temporary_dir_path
# Path to append after the temporary_dir.
# For historical reasons it used to be /sarg before v2.4. The full tempora
ry
# dir was, therefore, always the predicatble path /tmp/sarg. As it was con
sidered
# unsafe to use a predictable name in the world writable /tmp directory, t
he path
# now used is a random unique name.
# When this parameter is left empty, sarg uses a unique temporary path suc
h as
# sargXXXXXX where XXXXXX is replaced with a string to make the temporary
dir unique
# on the system.
# The main drawback is that any temporary directory left over by a previou
s run of sarg
# pollutes /tmp and may fill the disk up if sarg tends to crash often.
# If you want to use a known fixed temporary path as it used to be prior t
o v2.4, you are
# advised to set temporary_dir to /var/lib and set temporary_dir_path to /
sarg. Sarg must
# run as a user with the right to write to /var/lib/sarg.
#
#temporary_dir_path /sarg
# TAG: output_dir # TAG: output_dir
# The reports will be saved in that directory # The reports will be saved in that directory
# sarg -o dir # sarg -o dir
# #
#output_dir /var/www/html/squid-reports #output_dir /var/www/html/squid-reports
# TAG: anonymous_output_files yes/no # TAG: anonymous_output_files yes/no
# Use anonymous file and directory names in the report. If it is set to # Use anonymous file and directory names in the report. If it is set to
# no (the default), the user id/ip/name is slightly mangled to create a # no (the default), the user id/ip/name is slightly mangled to create a
# suitable file name to store the report of the user but the user's # suitable file name to store the report of the user but the user's
skipping to change at line 193 skipping to change at line 223
# #
#topuser_sort_field BYTES reverse #topuser_sort_field BYTES reverse
# TAG: user_sort_field field normal/reverse # TAG: user_sort_field field normal/reverse
# Sort field for the User Report. # Sort field for the User Report.
# Allowed fields: SITE CONNECT BYTES TIME # Allowed fields: SITE CONNECT BYTES TIME
# #
#user_sort_field BYTES reverse #user_sort_field BYTES reverse
# TAG: exclude_users file # TAG: exclude_users file
# users within the file will be excluded from reports. # Users within the file will be excluded from reports.
# you can use indexonly to have only index.html file. # Write one user per line. Lines beginning with # are ignored.
# #
#exclude_users none #exclude_users none
# TAG: exclude_hosts file # TAG: exclude_hosts file
# Hosts, domains or subnets will be excluded from reports. # Hosts, domains or subnets will be excluded from reports.
# #
# Eg.: 192.168.10.10 - exclude ip address only # Eg.: 192.168.10.10 - exclude ip address only
# 192.168.10.0/24 - exclude full C class # 192.168.10.0/24 - exclude full C class
# s1.acme.foo - exclude hostname only # s1.acme.foo - exclude hostname only
# *.acme.foo - exclude full domain name # *.acme.foo - exclude full domain name
# #
#exclude_hosts none #exclude_hosts none
# TAG: useragent_log file # TAG: useragent_log file
# useragent.log file patch to generate useragent report. # useragent.log file to generate useragent report.
#
# This option may be repeated multiple times to process several files.
#
# Wildcards are allowed (see access_log).
#
# When this option is used the user_agent report is implicitly
# selected in report_type.
# #
#useragent_log none #useragent_log none
# TAG: date_format # TAG: date_format
# Date format in reports: e (European=dd/mm/yy), u (American=mm/dd/yy), w (Weekly=yy.ww) # Date format in reports: e (European=dd/mm/yy), u (American=mm/dd/yy), w (Weekly=yy.ww)
# #
#date_format u #date_format u
# TAG: per_user_limit file MB # TAG: per_user_limit file MB ip/id
# Saves userid on file if download exceed n MB. # Write the user's ID (if last flag is 'id') or the user's IP address (if
# This option allow you to disable user access if user exceed a download l last flag is 'ip')
imit. # 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 #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 always
# TAG: lastlog n # TAG: lastlog n
# How many reports files must be keept in reports directory. # How many reports files must be keept in reports directory.
# The oldest report file will be automatically removed. # The oldest report file will be automatically removed.
# 0 - no limit. # 0 - no limit.
# #
#lastlog 0 #lastlog 0
# TAG: remove_temp_files yes # TAG: remove_temp_files yes
# Remove temporary files: geral, usuarios, top, periodo from root report di rectory. # Remove temporary files: geral, usuarios, top, periodo from root report di rectory.
# #
skipping to change at line 330 skipping to change at line 385
# TAG: max_elapsed milliseconds # TAG: max_elapsed milliseconds
# If elapsed time is recorded in log is greater than max_elapsed use 0 for elapsed time. # If elapsed time is recorded in log is greater than max_elapsed use 0 for elapsed time.
# Use 0 for no checking # Use 0 for no checking
# #
#max_elapsed 28800000 #max_elapsed 28800000
# 8 Hours # 8 Hours
# TAG: report_type type # TAG: report_type type
# What kind of reports to generate. # What kind of reports to generate.
# topusers - users, sites, times, bytes, connects, links to acce ssed sites, etc # topusers - users, sites, times, bytes, connects, links to acce ssed sites, etc
# topsites - site, connect and bytes report # topsites - site, connect and bytes report
# sites_users - users and sites report # sites_users - users and sites report
# users_sites - accessed sites by the user report # users_sites - accessed sites by the user report
# date_time - bytes used per day and hour report # date_time - bytes used per day and hour report
# denied - denied sites with full URL report # denied - denied sites with full URL report
# auth_failures - autentication failures report # auth_failures - autentication failures report
# site_user_time_date - sites, dates, times and bytes report # site_user_time_date - sites, dates, times and bytes report
# downloads - downloads per user report # downloads - downloads per user report
# user_agent - user agent identification strings report (this repo
rt is always selected
# if at least one file is provided with useragent opt
ion)
# #
# Eg.: report_type topsites denied # Eg.: report_type topsites denied
# #
#report_type topusers topsites sites_users users_sites date_time denied auth_fai lures site_user_time_date downloads #report_type topusers topsites sites_users users_sites date_time denied auth_fai lures site_user_time_date downloads user_agent
# TAG: usertab filename # TAG: usertab filename
# You can change the "userid" or the "ip address" to be a real user name on the reports. # You can change the "userid" or the "ip address" to be a real user name on the reports.
# If resolve_ip is active, the ip address is resolved before being looked u p into this # If resolve_ip is active, the ip address is resolved before being looked u p into this
# file. That is, if you want to map the ip address, be sure to set resolv_i p to no or # file. That is, if you want to map the ip address, be sure to set resolv_i p to no or
# the resolved name will be looked into the file instead of the ip address. Note that # the resolved name will be looked into the file instead of the ip address. Note that
# it can be used to resolve any ip address known to the dns and then map th e unresolved # it can be used to resolve any ip address known to the dns and then map th e unresolved
# ip addresses to a name found in the usertab file. # ip addresses to a name found in the usertab file.
# Table syntax: # Table syntax:
# userid name or ip address name # userid name or ip address name
skipping to change at line 402 skipping to change at line 459
# %s - will be changed to userlogins from access.log file # %s - will be changed to userlogins from access.log file
# filter string can have up to 5 '%s' tags # filter string can have up to 5 '%s' tags
# default value is '(uid=%s)' # default value is '(uid=%s)'
#LDAPFilterSearch (uid=%s) #LDAPFilterSearch (uid=%s)
# TAG: LDAPTargetAttr attributename # TAG: LDAPTargetAttr attributename
# Name of the attribute containing a name of the user # Name of the attribute containing a name of the user
# default value is 'cn' # default value is 'cn'
#LDAPTargetAttr 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-i
conv.
# default is empty line (UTF-8)
#LDAPNativeCharset ISO-8859-1
# TAG: long_url yes|no # TAG: long_url yes|no
# If yes, the full url is showed in report. # If yes, the full url is showed in report.
# If no, only the site will be showed # If no, only the site will be showed
# #
# YES option generate very big sort files and reports. # YES option generate very big sort files and reports.
# #
#long_url no #long_url no
# TAG: date_time_by bytes|elap # TAG: date_time_by bytes|elap
# Date/Time reports show the downloaded volume or the elapsed time or both. # Date/Time reports show the downloaded volume or the elapsed time or both.
skipping to change at line 468 skipping to change at line 532
# Records from access.log file that contain one of listed strings will be i gnored. # Records from access.log file that contain one of listed strings will be i gnored.
# #
#exclude_string none #exclude_string none
# TAG: show_successful_message yes|no # TAG: show_successful_message yes|no
# Shows "Successful report generated on dir" at end of process. # Shows "Successful report generated on dir" at end of process.
# #
#show_successful_message yes #show_successful_message yes
# TAG: show_read_statistics yes|no # TAG: show_read_statistics yes|no
# Shows some reading statistics. # Shows how many lines have been read from the current input log file.
# #
#show_read_statistics yes #show_read_statistics no
# TAG: show_read_percent yes|no
# Shows how many percents have been read from the current input log file.
#
# Beware that this feature requires to read the input log file once to
# count the number of lines and then a second time to actually parse it.
# You can save some time by disabling it.
#
#show_read_percent no
# TAG: topuser_fields # TAG: topuser_fields
# Which fields must be in Topuser report. # 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 dep
ending 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 #topuser_fields NUM DATE_TIME USERID CONNECT BYTES %BYTES IN-CACHE-OUT USED_TIME MILISEC %TIME TOTAL AVERAGE
# TAG: user_report_fields # TAG: user_report_fields
# Which fields must be in User report. # Which fields must be in User report.
# #
#user_report_fields CONNECT BYTES %BYTES IN-CACHE-OUT USED_TIME MILISEC %TIME TO TAL AVERAGE #user_report_fields CONNECT BYTES %BYTES IN-CACHE-OUT USED_TIME MILISEC %TIME TO TAL AVERAGE
# TAG: bytes_in_sites_users_report yes|no # TAG: bytes_in_sites_users_report yes|no
# Bytes field must be in Site & Users Report ? # Bytes field must be in Site & Users Report ?
# #
skipping to change at line 625 skipping to change at line 712
# TAG: dansguardian_report_limit n # TAG: dansguardian_report_limit n
# TAG: download_report_limit n # TAG: download_report_limit n
# report limits (lines). # report limits (lines).
# '0' no limit # '0' no limit
# #
#authfail_report_limit 10 #authfail_report_limit 10
#denied_report_limit 10 #denied_report_limit 10
#siteusers_report_limit 0 #siteusers_report_limit 0
#squidguard_report_limit 10 #squidguard_report_limit 10
#dansguardian_report_limit 10 #dansguardian_report_limit 10
#user_report_limit 10 #user_report_limit 0
#user_report_limit 50 #download_report_limit 50
# TAG: www_document_root dir # TAG: www_document_root dir
# Where is your Web DocumentRoot # Where is your Web DocumentRoot
# Sarg will create sarg-php directory with some PHP modules: # Sarg will create sarg-php directory with some PHP modules:
# - sarg-squidguard-block.php - add urls from user reports to squidGuard DB # - sarg-squidguard-block.php - add urls from user reports to squidGuard DB
# #
#www_document_root /var/www/html #www_document_root /var/www/html
# TAG: block_it module_url # TAG: block_it module_url
# This tag allow you to pass urls from user reports to a cgi or php module, # This tag allow you to pass urls from user reports to a cgi or php module,
skipping to change at line 711 skipping to change at line 798
# You need to run sarg as root to use ulimit tag. # You need to run sarg as root to use ulimit tag.
# If you run sarg with a low privilege user, set to 'none' to disable ulimit # If you run sarg with a low privilege user, set to 'none' to disable ulimit
# #
#ulimit 20000 #ulimit 20000
# TAG: ntlm_user_format user|domainname+username # TAG: ntlm_user_format user|domainname+username
# NTLM users format. # NTLM users format.
# #
#ntlm_user_format domainname+username #ntlm_user_format domainname+username
# TAG: strip_user_suffix suffix
# Remove a suffix from the user name. The suffix may be
# a Kerberos domain name. It must be at the end of the
# user name (as is implied by a suffix).
#
# This is a lightweight easy to configure option. For a
# more complete solution, see useralias.
#strip_user_suffix @example.com
# TAG: realtime_refresh_time num sec # TAG: realtime_refresh_time num sec
# How many time to auto refresh the realtime report # How many time to auto refresh the realtime report
# 0 = disable # 0 = disable
# #
# realtime_refresh_time 3 # realtime_refresh_time 3
# TAG: realtime_access_log_lines num # TAG: realtime_access_log_lines num
# How many last lines to get from access.log file # How many last lines to get from access.log file
# #
# realtime_access_log_lines 1000 # realtime_access_log_lines 1000
# TAG: realtime_types: GET,PUT,CONNECT,ICP_QUERY,POST # TAG: realtime_types: GET,PUT,CONNECT,ICP_QUERY,POST
# Which records must be in realtime report. # Which records must be in realtime report.
# #
# realtime_types GET,PUT,CONNECT # realtime_types GET,PUT,CONNECT,POST
# TAG: realtime_unauthenticated_records: ignore|show # TAG: realtime_unauthenticated_records: ignore|show
# What to do with unauthenticated records in realtime report. # What to do with unauthenticated records in realtime report.
# #
# realtime_unauthenticated_records: show # realtime_unauthenticated_records: show
# TAG: byte_cost value no_cost_limit # TAG: byte_cost value no_cost_limit
# Cost per byte. # Cost per byte.
# Eg. byte_cost 0.01 100000000 # Eg. byte_cost 0.01 100000000
# per byte cost = 0.01 # per byte cost = 0.01
skipping to change at line 765 skipping to change at line 861
# one level above output_dir. # one level above output_dir.
# #
# If this entry is set, each sortable table will have the "sortable" class set. # If this entry is set, each sortable table will have the "sortable" class set.
# You may have a look at http://www.kryogenix.org/code/browser/sorttable/ # You may have a look at http://www.kryogenix.org/code/browser/sorttable/
# for the implementation on which sarg is based. # for the implementation on which sarg is based.
# #
# sorttable /sorttable.js # sorttable /sorttable.js
# TAG: hostalias # TAG: hostalias
# The name of a text file containing the host names one per line and the # The name of a text file containing the host names one per line and the
# optional alias to use in the report instead of that host name. # optional alias to use in the report instead of that host name. If the
# alias is missing, the host name is replaced by the matching pattern
# (that is, including the wildcard). For instance, in the example below,
# any host matching *.gstatic.com is grouped, in the report, under the
# text "*.gstatic.com".
#
# Host names may contain up to one wildcard denoted by a *. The wildcard # Host names may contain up to one wildcard denoted by a *. The wildcard
# must not end the host name. # must not end the host name.
#
# The host name may be followed by an optional alias but if no alias is # The host name may be followed by an optional alias but if no alias is
# provided, the host name, including the wildcard, replaces any matching # provided, the host name, including the wildcard, replaces any matching
# host name found in the log. # host name found in the log.
#
# Host names replaced by identical aliases are grouped together in the # Host names replaced by identical aliases are grouped together in the
# reports. # reports.
#
# IP addresses are supported and accept the CIDR notation both for IPv4 and # IP addresses are supported and accept the CIDR notation both for IPv4 and
# IPv6 addresses. # IPv6 addresses.
#
# Regular expressions can also be used if sarg was compiled with libpcre. # Regular expressions can also be used if sarg was compiled with libpcre.
# A regular expression is formated as re:/regexp/ alias # A regular expression is formated as re:/regexp/ alias
# The regexp is a perl regular expression (see man perlre). # The regexp is a perl regular expression (see man perlre).
# Subpatterns are allowed in the alias. Sarg recognizes sed (\1) or perl ($ 1) # Subpatterns are allowed in the alias. Sarg recognizes sed (\1) or perl ($ 1)
# subpatterns. Only 9 subpatterns are allowed in the replacement string. # subpatterns. Only 9 subpatterns are allowed in the replacement string.
# Regex are case sensitive by default. To have a case insensitive regex,
# defined it like this: re:/regexp/i alias
# The option "i" must be written with a lower case.
# #
# Example: # Example:
# *.gstatic.com # *.gstatic.com
# mt*.google.com # mt*.google.com
# *.myphone.microsoft.com # *.myphone.microsoft.com
# *.myphone.microsoft.com:443 *.myphone.microsoft.com:secure # *.myphone.microsoft.com:443 *.myphone.microsoft.com:secure
# *.freeav.net antivirus:freeav # *.freeav.net antivirus:freeav
# *.mail.live.com # *.mail.live.com
# 65.52.00.00/14 *.mail.live.com # 65.52.00.00/14 *.mail.live.com
# re:/\.dropbox\.com(:443)?/ dropbox # re:/\.dropbox\.com(:443)?/ dropbox
# re:/([\w-]+)\.(\w*[a-zA-Z]\w*)(?::\d+)?$/\1.\2 # re:/([\w-]+)\.(\w*[a-zA-Z]\w*)(?::\d+)?$/ \1.\2
#hostalias /usr/local/sarg/hostalias #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.
# See the description of hostalias. It uses the same file format as the
# useralias option.
#
# Example:
# user454 John
# admin* Administrator
# re:/^(.*)@example.com$/i \1
#useralias /usr/local/sarg/useralias
# TAG: keep_temp_log yes|no # TAG: keep_temp_log yes|no
# Keep temporary files created by sarg to produce its reports. The normal # 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 m ore. # operation mode is to delete those files when they are not necessary any m ore.
# #
# Never leave that option to "yes" for normal operation as temporary files # Never leave that option to "yes" for normal operation as temporary files
# left over by previous run can be included in subsequent reports. # left over by previous run can be included in subsequent reports.
# #
# Use this option only to diagnose a problem with your reports. A better # 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. # alternative is to run sarg from the command line with optino -k.
#keep_temp_log no #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 f
ound
# in the log file. This parameter set the number of errors before the readi
ng
# 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
# TAG: include conffile
# Include the specified conffile. The full path must be provided to
# make sure the correct file is loaded.
#
# Use this option to store common options in one file and include it
# in multiple sarg.conf dedicated to various reporting tasks.
#
# Options declared last take precedence. Use it to include a file and
# then override some options after the include statement. Beware that
# some options are cumulative such as access_log, useragent_log or
# redirector_log. You can't override those options as explained here.
# Declaring them in the common file and the including file will merely
# add the latter to the list.
#include /etc/sarg/sarg-common.conf
 End of changes. 25 change blocks. 
21 lines changed or deleted 154 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)