.TP 8.BI "\-t \-\-max\-trails" " number"Set the max number of entries in the web trails report..PP.TP 8.BI "\-g \-\-max\-googled" " number"Set the max number of entries in the crawled pages report (google bot)..PP.TP 8.BI "    \-\-max\-adsensed" " number"Set the max number of entries in the crawled pages report (adsense bot)..PP.TP 8.BI "\-k \-\-max\-google\-keyphrases" " number"Set the max number of entries in the Google keyphrases report..PP.TP 8.BI "\-a \-\-max\-referers\-age" " number"Set the max number of entries in the referers by date report..PP.TP 8.BI "\-d \-\-max\-domains" " number"Set the max number of entries in the domains report..PP.TP 8.BI "\-P \-\-prefix" " number"Prefixes specify to visitors how a link should look like to beclassified as internal to your site. This option is required for.B --trailsand will also have the nice effect to avoid that internal links areshown in the referers report. If you are analyzing statistics forhttp://www.your.site.com/, just use:.B --prefix http://www.your.site.comIf your site is reachable using more hostnames you should specify allthese, like in the following example:.br.B --prefix http://www.your.site.com --prefix http://your.site.com.PP.TP 8.BI "\-o \-\-output" " html|text"Output module. You can use text or html. The default is html..PP.TP 8.BI "\-V \-\-graphviz"This option enables the Graphviz mode:.I Visitorswill analyze the log file and create a graph describing the accesspatterns of your web site. The information used to create the graph isthe same as the web trails report (that you can enable with --trails),but as a graph it can be more readable for non trivial sites. An exampleon how to use this feature:% visitors access.log --prefix http://www.hping.org \\  --graphviz > graph.dot% dot /tmp/graph.dot -Tpng > graph.pngOn Debian systems, the.B dotcommand is included in the.B graphvizpackage. The generated graph will have edges of different colors, fromblue to red to specify a low to high level of popularity of a givenmovement from one page to another of the web site.  This option requiresone or more.B --prefixoptions in order to work, just like the.B --trailsoption..PP.TP 8.BI "\-V \-\-graphviz-ignorenode-google"Don't put the google node on the generated graph. Only usefulwith.B --trails.PP.TP 8.BI "\-V \-\-graphviz-ignorenode-external"Don't put the external referer node on the generated graph. Only usefulwith.B --trails.PP.TP 8.BI "\-V \-\-graphviz-ignorenode-noreferer"Don't put the node indicating requests without referer on the generated graph.Only useful with.B --trails.PP.TP 8.BI "\-\-tail"When this option is specified.I Visitorswill emulate the Unix command tail -f --max-unchanged-stats=1 -q. Youcan specify the log file names to monitor for changes, once new data isappended in any of the specified file, visitors will output the new datato the standard output. This option is useful conjunction to the StreamMode (--stream). Files can be log-rotated because.I Visitorsin Tail Mode will always try to reopen the file to check for changes..PP.TP 8.BI "\-\-time\-delta" " delta"If your web server is in a different timezone than most of your visitorsor yourself, you will notice a shift in the reports regarding time anddays of week. By default,.I Visitorswill generate output using the host's locale. You can use the.B --time-deltaoption in order to adjust the output. Positive values will shift on theright (toward future) from the given number of hours, negative valueswill shift on the left (toward past). In the future this option may havesupport to directly specify the output timezone..PP.TP 8.BI "\-\-filter\-spam"Filter referer spam using a keyword-based filter (see blacklist.hfor more information on keywords). If you don't know what refererspam is check this Wikipedia page: http://en.wikipedia.org/wiki/Referer_spam.PP.TP 8.BI "\-\-ignore\-404"When this option is turned on log lines with 404 errors are just used to generate the 404 errors report and not used for other reports..PP.TP 8.BI "\-\-grep" " pattern"Process only log lines matching the specified pattern.Patterns are matched using the glob-style matching (the oneused by the unix shell):.RS.IP \fB*\fR 10Matches any sequence of characters in \fIstring\fR, including a nullstring..IP \fB?\fR 10Matches any single character in \fIstring\fR..IP \fB[\fIchars\fB]\fR 10Matches any character in the set given by \fIchars\fR.  If a sequenceof the form \fIx\fB\-\fIy\fR appears in \fIchars\fR, then anycharacter between \fIx\fR and \fIy\fR, inclusive, will match..IP \fB\e\fIx\fR 10Matches the single character \fIx\fR.  This provides a way of avoidingthe special interpretation of the characters \fB*?[]\e\fR in\fIpattern\fR..REFor default matching is performed in a case sensitive way, butcase insensitive matching may be forced prefixing the patternwith the string \fBcs:\fR, so for example the pattern \fBcs:firefox\fRwill match all the log lines containing the string firefox, FireFox,FIREFOX and so on..PP.TP 8.BI "\-\-exclude" " pattern"Works exactly like \fB--grep\fR, but only lines NOT matchingthe specified pattern are processed. Note that --grep and --excludecan be used multiple times, and are processed sequentially.For example \fBvisitors --grep firefox --exclude download\fR willprocess only lines including the string firefox but not includingthe string download..PP.TP 8.BI "\-\-debug"Show additional information on errors. For example invalid linesare printed on the standard error if found. Mainly useful for developers anderror reporting..PP.TP 8.BI "\-h \-\-help"Show usage and copyright information..PP.TP 8.BI "\-v \-\-version"Show program version..SH EXAMPLESThe simplest usage, to be used interactively when you have a web log tocheck (for example over ssh in your web server), just use:% visitors access.log | lessThat will produce a human readable output in text only. To generate htmlweb stats with much more information you may use instead this:% visitors --output text -A -m 30 access.log -o html > report.htmlIf you want information on the usage patterns for your site you mustprovide the url prefix of your web site, and specify the.B --trailsoption. The next example produces an HTML report with usage patternsinformation.% visitors -A -m 30 access.log --trails \\  --prefix http://www.hping.org > report.htmlNote that it's ok to specify multiple file names, or to provide theinput using the standard input like in the following two examples:% visitors /var/log/apache/access.log.*.br% zcat access.log.*.gz | visitors -.SH STREAM MODE DETAILS.PPThe usual way to run.I Visitorsis to specify some option to control the report generation, and the nameof log files.  For example to generate a report from two Apache's accesslog files you can write:% visitors -A access.log.1 access.log.2 > report.html.I Visitorswill analyze the log files, and will output the report.  Sometimes itcan be more interesting to have web statistics updated continuously,almost in real time, as new data is available. In order to provide thisfeature.I Visitorsimplements a mode called Stream Mode that reads a stream of logs fromthe standard input.  The following command line shows how to use it (butcheck the --stream option documentation for more information).% tail -f /var/log/apache/access.log | \\  visitors --stream -A --update-every 60 \\  --output-file /tmp/report.html.I Visitorswill incrementally update the statistics as new logs are available andwill update the html report every 60 seconds.  As you can see in thismode is required to specify the report file name using the.B --output-fileoption because.I Visitorsneeds to overwrite the report to update it. Note that instead of thetail command in the above example it is possible to use instead.I Visitorsin Tail Mode (an emulation for the tail program):% visitors --tail /var/log/apache/access.log | \\  visitors --stream -A --update-every 60 \\  --output-file /tmp/report.htmlIt's possible to generate real time statistics about the last N secondsof web traffic, where N is configurable and can be from few seconds toone week or more, using the.B --reset-everyoption. The following example generates statistics updated every 30seconds about the last hour of traffic:% visitors --tail /var/log/apache/access.log | \\  visitors --stream -A --update-every 30 --reset-every 3600 \\  --output-file /tmp/report.html.SH "AUTHORS".PP.I Visitorswas written by Salvatore Sanfilippo <antirez@invece.org>..SH "COPYING"Copyright.if t \(co.if n (C)2004,2005 Salvatore Sanfilippo <antirez@invece.org>..PP.I Visitorsis distributed under the GNU General Public License..PPThis manual page was written (based on the original HTML documentation)by Romain Francoise <rfrancoise@debian.org> for the Debian GNU/Linuxsystem, but may be used by others.Salvatore Sanfilippo updated this man page starting from Visitors 0.5, thismanual page is now part of the Visitors tarball.