.TH VISITORS "1" "April 2005" "Visitors 0.7".SH NAMEvisitors \- a fast web server log analyzer.SH SYNOPSIS.B visitors[\fIoptions] \fI<filename> [\fI<filename> ...].SH DESCRIPTION.PP.I Visitorsgenerates access statistics from specified web log files.The resulting reports contain a number of useful informations andstatistics:.IP \[bu] 2Requested pages.IP \[bu]Requested images.IP \[bu]Referers by number of visits and age.IP \[bu]Unique visitors in each day.IP \[bu]Page views per visit.IP \[bu]Pages accessed by the Google crawler (and the date of google's lastaccess on every page).IP \[bu]Pages accessed by the AdSense crawler (and the date of adsense's lastaccess on every page).IP \[bu]Percentage of visits originated from Google searches for every day.IP \[bu]User navigation patterns (web trails).IP \[bu]Keyphrases used in Google searches.IP \[bu]Human languages used in google searches.IP \[bu]User agents.IP \[bu]Weekdays and Hours distributions of accesses.IP \[bu]Weekdays/Hours combined bidimensional map.IP \[bu]Month/Day combined bidimensional map.IP \[bu]Visual path analysis with Graphviz.IP \[bu]Operating systems, browsers and domains popularity.IP \[bu]Visitors screen resolution and color depth.IP \[bu]404 errors.PPThe web log files don't need to follow a strict format, except: the dateMUST be included between [ and ] chars, the client hostname MUST be thefirst entry in the log, referers and requests MUST be included betweendouble quote chars. Out of the box Apache log file will work withoutproblems.It's possible to use Visitors with IIS log files converting them usingthe iis2apache.pl utility distributed with Visitors (The utility isthe same you can find at http://www.jammed.com/~jwa/hacks/ andis distributed under the GPL license).Note that logfile can be a \- character to use the standard input..PP.SS "Available options:".TP 8.BI "\-A \-\-all"Activate all the optional reports. This option is equivalent to.B -GKUWRDOB.Note that .B --trailsis not implicitly included in this option because it also requires.B --prefix.See the.B --trailsoption documentation for details..PP.TP 8.BI "\-T \-\-trails"Enable the Web Trails feature. The report will show what are the morefrequent moves between pages of your site. This option requires the.B --prefixoption to work..PP.TP 8.BI "\-G \-\-google"Activate two reports about pages accessed by the Google and Adsense webcrawlers. Pages are shown ordered accordingly to the last time the Googleweb crawler requested the page. The first page shown is the latest that wasaccessed..PP.TP 8.BI "\-K \-\-google\-keyphrases"Activate a report that shows common search keyphrases used to found yourweb site from Google..PP.TP 8.BI "\-Z \-\-google\-keyphrases-age"Activate a report that shows common the lastest keyphrases used to found yoursite from Google..PP.TP 8.BI "\-H \-\-google\-human-language"Activate a report that shows common human languages used to serachfrom Google. This feature uses the 'hl' variable of the Googlereferer URL..PP.TP 8.BI "\-U \-\-user\-agents"Show information about common user agents..PP.TP 8.BI "\-W \-\-weekday\-hour\-map"Activate the generation of a combined weekdays/hours bidimensional mapthat shows information about traffic in every 168 different hours of a 7days week. Brighter colors mean higher traffic. This is ideal to figurewhat's the best moment on a week for a maintenance downtime, what's thetarget of the site, if people are accessing it from work or from home,and so on. The map is generated as pure html inside the report..PP.TP 8.BI "\-M \-\-month\-day\-map"Activate the generation of a combined month/day bidimensional mapthat shows information about traffic in every 365 different days ofthe year. Brighter colors mean higher traffic. This is useful in orderto figure with a quick look traffic trends and days with particuarly highor low traffic. The map is generated as pure html inside the report..PP.TP 8.BI "\-R \-\-referers\-age"Shows referers ordered by age. The 'age' of a referer is the date itappeared the first time. In the report, newer referers are on top.  Thisreport is useful to check for new external links..PP.TP 8.BI "\-D \-\-domains"Activate the generation of information about Top Level Domainspopularity. This information may be useful to guess the amount of visitsfrom different countries. Note that Visitors will not resolve numericalIP addresses if they are not already resolved in the log file. All theunresolved IP addresses will be shown in this report under the entryUnresolved IP..PP.TP 8.BI "\-O \-\-operating\-systems"Activate the report about Operating Systems popularity, sorted by numberof accesses. All the common operating systems are listed in the report,while unknown operating systems will be summed in the unknown entry..PP.TP 8.BI "\-B \-\-browsers"Activate the report about Browsers popularity, sorted by number ofaccesses. All the common browsers are listed in the report, whileunknown browsers will be summed in the unknown entry. Browsers arelisted by family (for example Internet Explorer, Opera, and so on), andnot by specific version..PP.TP 8.BI "\-X \-\-error404"Activate the generation of missing documents (404 error) report.  Thisreport will show files requested, but missing, ordered by number ofrequests. The report is useful in order to discover if for some mistakethere is some file missing in the web site, but often you will seebizarre requests performed by users or internet worms and securityscans..PP.TP 8.BI "\-Y \-\-pageviews"Activate the generation of a report that shows (and approximation) ofthe percentage of pages viewed per unique visit. The goal of this reportis to understand the usage pattern of the site and the level of interestof the visitors. For example, in a site that provides a number of pageswith interesting contents, the percentage of visitors performing asingle page view per visit is probably searching for something else..PP.TP 8.BI "\-S \-\-robots"Activate the generation of a report that shows user agents of clientsrequesting the file robots.txt, with the exception of the MSIE Crawlerrequests. The result is a list of web robots and spieders that accessedyour web site, ordered by number of requests of robots.txt..PP.TP 8.BI "\-\-screen\-info"Activate the screen resolution and color depth reports. Note that for thisreport to work you have to insert on your HTML pages the javascript codeyou can find in the README file in the visitors tarball..PP.TP 8.BI "\-\-stream"Enable the Stream Mode (see the .B STREAM MODE DETAILSsection for more information). Shortly: when in stream mode.I Visitorswill process all the log files specified (possibly none, that's valid inthis mode) as usual, producing the report. Then the stream mode isentered and.I Visitorswill start to read from standard input for a continuous stream of weblogs, updating the statistics incrementally as new data is available.  Anew report is produced periodically if new data arrived, accordingly tothe.B --update-everyoption (default is to update the statistics every ten minutes). It'spossible to ask.I Visitorsto reset the statistics after some period of time using the.B --reset-everyoption.  This allows to have a snapshot of what is going on in the lastfive minutes, hour, day or week.  Note that.B --streamrequires.B --output-filebecause.I Visitorsneeds to overwrite the report for every update, so can't output tostandard output as usually.  If you plan to use the stream mode, alsocheck the.B --tailoption..PP.TP 8.BI "\-\-update\-every" " seconds"By default in Stream Mode statistics are updated every 10 minutes. Thisoption specifies a different period in seconds..PP.TP 8.BI "\-\-reset\-every" " seconds"By default in Stream Mode statistics are never reset, but continuouslyupdated incrementally. This option specifies to reset statistics afterthe given amount of time in seconds. This is useful to have a snapshotof the web site usage..PP.TP 8.BI "\-f \-\-output\-file" " file"Write output to.I fileinstead of stdout..PP.TP 8.BI "\-m \-\-max\-lines" " number"Set the max number of entries that should be shown in reports likereferers, keyphrases and so on. This option sets all the reports maxnumber of entries for all the reports at once..PP.TP 8.BI "\-r \-\-max\-referers" " number"Set the max number of entries in the referer report..PP.TP 8.BI "\-p \-\-max\-pages" " number"Set the max number of entries in the accessed pages report..PP.TP 8.BI "\-i \-\-max\-images" " number"Set the max number of entries in the accessed images report..PP.TP 8.BI "\-x \-\-max\-error404" " number"Set the max number of entries in the missing documents report..PP.TP 8.BI "\-u \-\-max\-useragents" " number"Set the max number of entries in the user agents report..PP