📄 doc.html
字号:
<html><head><title>Visitors - fast web log analyzer</title><link rel=stylesheet href="visitors.css"></head><body><center><table border="0" width="60%" cellpadding="0" cellspacing="0"><tr><td align="center"><img width="247" height="56" src="visitors.png" alt="VISITORS" title="Visitors web log analyzer"></tr><tr><td align="center"></td></tr><tr> <td align="center" class="maintitle">Visitors, on line documentation for 0.7</td></tr><tr> <td align="center"><a href="http://www.hping.org/visitors">(click here for the home page)</a></td></tr><tr><td><A HREF="#toc">Table of Contents</A><P><H2><A NAME="sect0" HREF="#toc0">Name</A></H2>visitors - a fast web server log analyzer <H2><A NAME="sect1" HREF="#toc1">Synopsis</A></H2><B>visitors</B> [<I>options]<I><filename> [<I><filename> ...] <H2><A NAME="sect2" HREF="#toc2"></I></I></I>Description</A></H2><P><I>Visitors</I> generates access statistics fromspecified web log files. <P> The resulting reports contain a number of usefulinformations and statistics: <DL><DD>Requested pages </DD><DD>Requested images </DD><DD>Referersby number of visits and age </DD><DD>Unique visitors in each day </DD><DD>Page viewsper visit </DD><DD>Pages accessed by the Google crawler (and the date of google'slast access on every page) </DD><DD>Pages accessed by the AdSense crawler (andthe date of adsense's last access on every page) </DD><DD>Percentage of visitsoriginated from Google searches for every day </DD><DD>User navigation patterns(web trails) </DD><DD>Keyphrases used in Google searches </DD><DD>Human languagesused in google searches </DD><DD>User agents </DD><DD>Weekdays and Hours distributionsof accesses </DD><DD>Weekdays/Hours combined bidimensional map </DD><DD>Month/Daycombined bidimensional map </DD><DD>Visual path analysis with Graphviz </DD><DD>Operatingsystems, browsers and domains popularity </DD><DD>Visitors screen resolutionand color depth </DD><DD>404 errors </DD></DL><P>The web log files don't need to follow astrict format, except: the date MUST be included between [ and ] chars,the client hostname MUST be the first entry in the log, referers and requestsMUST be included between double quote chars. Out of the box Apache log filewill work without problems. <P> It's possible to use Visitors with IIS log filesconverting them using the iis2apache.pl utility distributed with Visitors(The utility is the same you can find at <A HREF="http://www.jammed.com/~jwa/hacks/">http://www.jammed.com/~jwa/hacks/</A>and is distributed under the GPL license). <P> Note that logfile can be a -character to use the standard input. <P><H3><A NAME="sect3" HREF="#toc3">Available options:</A></H3><DL><DT><B>-A --all</B> </DT><DD>Activate allthe optional reports. This option is equivalent to <B>-GKUWRDOB.</B> Note that <B>--trails</B>is not implicitly included in this option because it also requires <B>--prefix.</B>See the <B>--trails</B> option documentation for details. </DD></DL><P><DL><DT><B>-T --trails</B> </DT><DD>Enable the WebTrails feature. The report will show what are the more frequent moves betweenpages of your site. This option requires the <B>--prefix</B> option to work. </DD></DL><P><DL><DT><B>-G --google</B></DT><DD>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 thatwas accessed. </DD></DL><P><DL><DT><B>-K --google-keyphrases</B> </DT><DD>Activate a report that shows common searchkeyphrases used to found your web site from Google. </DD></DL><P><DL><DT><B>-Z --google-keyphrases-age</B></DT><DD>Activate a report that shows common the lastest keyphrases used to foundyour site from Google. </DD></DL><P><DL><DT><B>-H --google-human-language</B> </DT><DD>Activate a report that showscommon human languages used to serach from Google. This feature uses the'hl' variable of the Google referer URL. </DD></DL><P><DL><DT><B>-U --user-agents</B> </DT><DD>Show information aboutcommon user agents. </DD></DL><P><DL><DT><B>-W --weekday-hour-map</B> </DT><DD>Activate the generation of a combinedweekdays/hours bidimensional map that shows information about traffic inevery 168 different hours of a 7 days week. Brighter colors mean highertraffic. This is ideal to figure what's the best moment on a week for a maintenancedowntime, what's the target of the site, if people are accessing it fromwork or from home, and so on. The map is generated as pure html inside thereport. </DD></DL><P><DL><DT><B>-M --month-day-map</B> </DT><DD>Activate the generation of a combined month/day bidimensionalmap that shows information about traffic in every 365 different days ofthe year. Brighter colors mean higher traffic. This is useful in order tofigure with a quick look traffic trends and days with particuarly highor low traffic. The map is generated as pure html inside the report. </DD></DL><P><DL><DT><B>-R --referers-age</B></DT><DD>Shows referers ordered by age. The 'age' of a referer is the date it appearedthe first time. In the report, newer referers are on top. This report isuseful to check for new external links. </DD></DL><P><DL><DT><B>-D --domains</B> </DT><DD>Activate the generationof information about Top Level Domains popularity. This information maybe useful to guess the amount of visits from different countries. Note thatVisitors will not resolve numerical IP addresses if they are not alreadyresolved in the log file. All the unresolved IP addresses will be shownin this report under the entry Unresolved IP. </DD></DL><P><DL><DT><B>-O --operating-systems</B> </DT><DD>Activatethe report about Operating Systems popularity, sorted by number of accesses.All the common operating systems are listed in the report, while unknownoperating systems will be summed in the unknown entry. </DD></DL><P><DL><DT><B>-B --browsers</B> </DT><DD>Activatethe report about Browsers popularity, sorted by number of accesses. Allthe common browsers are listed in the report, while unknown browsers willbe summed in the unknown entry. Browsers are listed by family (for exampleInternet Explorer, Opera, and so on), and not by specific version. </DD></DL><P><DL><DT><B>-X --error404</B></DT><DD>Activate the generation of missing documents (404 error) report. This reportwill show files requested, but missing, ordered by number of requests. Thereport is useful in order to discover if for some mistake there is somefile missing in the web site, but often you will see bizarre requests performedby users or internet worms and security scans. </DD></DL><P><DL><DT><B>-Y --pageviews</B> </DT><DD>Activate thegeneration of a report that shows (and approximation) of the percentageof pages viewed per unique visit. The goal of this report is to understandthe usage pattern of the site and the level of interest of the visitors.For example, in a site that provides a number of pages with interestingcontents, the percentage of visitors performing a single page view pervisit is probably searching for something else. </DD></DL><P><DL><DT><B>-S --robots</B> </DT><DD>Activate the generationof a report that shows user agents of clients requesting the file robots.txt,with the exception of the MSIE Crawler requests. The result is a list ofweb robots and spieders that accessed your web site, ordered by numberof requests of robots.txt. </DD></DL><P><DL><DT><B>--screen-info</B> </DT><DD>Activate the screen resolution andcolor depth reports. Note that for this report to work you have to inserton your HTML pages the javascript code you can find in the README filein the visitors tarball. </DD></DL><P><DL><DT><B>--stream</B> </DT><DD>Enable the Stream Mode (see the <B>STREAMMODE DETAILS</B> section for more information). Shortly: when in stream mode<I>Visitors</I> will process all the log files specified (possibly none, that'svalid in this mode) as usual, producing the report. Then the stream modeis entered and <I>Visitors</I> will start to read from standard input for a continuousstream of web logs, updating the statistics incrementally as new data isavailable. A new report is produced periodically if new data arrived, accordinglyto the <B>--update-every</B> option (default is to update the statistics every tenminutes). It's possible to ask <I>Visitors</I> to reset the statistics after someperiod of time using the <B>--reset-every</B> option. This allows to have a snapshotof what is going on in the last five minutes, hour, day or week. Note that<B>--stream</B> requires <B>--output-file</B> because <I>Visitors</I> needs to overwrite the reportfor every update, so can't output to standard output as usually. If youplan to use the stream mode, also check the <B>--tail</B> option. </DD></DL><P><DL><DT><B>--update-every</B><I> seconds</I></DT><DD>By default in Stream Mode statistics are updated every 10 minutes. Thisoption specifies a different period in seconds. </DD></DL><P><DL><DT><B>--reset-every</B><I> seconds</I> </DT><DD>By defaultin Stream Mode statistics are never reset, but continuously updated incrementally.This option specifies to reset statistics after the given amount of timein seconds. This is useful to have a snapshot of the web site usage. </DD></DL><P><DL><DT><B>-f --output-file</B><I>file</I> </DT><DD>Write output to <I>file</I> instead of stdout. </DD></DL><P><DL><DT><B>-m --max-lines</B><I> number</I> </DT><DD>Set the maxnumber of entries that should be shown in reports like referers, keyphrasesand so on. This option sets all the reports max number of entries for allthe reports at once. </DD></DL><P><DL><DT><B>-r --max-referers</B><I> number</I> </DT><DD>Set the max number of entriesin the referer report. </DD></DL><P><DL><DT><B>-p --max-pages</B><I> number</I> </DT><DD>Set the max number of entries inthe accessed pages report. </DD></DL><P><DL><DT><B>-i --max-images</B><I> number</I> </DT><DD>Set the max number of entriesin the accessed images report. </DD></DL>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -