OUTPUT FILES

A statistics report is created in the current directory or in the output directory specified at invocation of http-analyze. All output files are placed into separate subdirectories to reduce the number of directory entries per report. Those subdirectories are named wwwYYYY, where YYYY is the year of the period covered by the report.

The analyzer can be instructed to place files with "private" data such as overviews and detailed lists of files, hosts, browser types, and referrer URLs in a separate ("private") subdirectory. The web server then can be configured to request authentication for access of files in this directory. See also the option -p and the PrivateDir directive in the configuration file.

Note: for protection of the whole report, you would configure your web server to request authentication for any file in the statistics output directory. A separate private area is needed only if you want to secure certain lists while granting access to the rest of the statistics report.

The following list shows all output files of a full statistics report in a wwwYYYY directory:

index.html
is the main page for the year and contains the total numbers of hits, files sent, cached files, pageviews, sessions and data sent per month in tabular and graphical form for the last 12 months. At the end of the year, this file contains the values for the whole year, while the values for the last 12 months then will be continued in the index file for the new year. This page is displayed in the Main window.
statsMMYY.html and totalsMMYY.html
contain the total summary for the month MM of year YY in tabular form. The file totalsMMYY.html is the frames version of the report in statsMMYY.html. In the conventional interface, this page is displayed in the Main window.
jsnav.html and navMMYY.html
navigation panels for JavaScript-enabled browsers, shown in the Navigation window.
daysMMYY.html
contains the numbers of hits, files sent, cached files, pageviews, sessions and data sent per day for the month MM of year YY. This report is displayed in the Main window.
avloadMMYY.html
contains a graphical representation of the average hits per weekday/hour and the top seconds, minutes, hours, and days of the period. This list appears in the Main window.
countryMMYY.html
contains the list of all countries the visitors of your web server came from. This information is determined by analyzing the top-level domain (TLD) of the hostname assigned to a system in the Domain Name System (DNS). The country report is displayed in the Main window.
Note that the country list is meaningful only for hostnames with ISO two-letter domains. All other domains (.com, .org, .net, etc.) are used by organizations world-wide, so they are not assigned a country, but listed literally in the charts. The ISO country code for the U.S. is .us, by the way, not .com ...
3DstatsMMYY.html, 3DstatsMMYY.wrl.gz, 3DstatsYYYY.html, 3DstatsYYYY.wrl.gz
are pre-requisite files for the 3D statistics models in the Virtual Reality Modeling Language (VRML). Those models are created if the option -3 is given at invocation of http-analyze. To view those models, you need a VRML2.0 compatible plug-in such as the free CosmoPlayer from Cosmo Software, which is currently available for Silicon Graphics, Windows and Macintosh systems. All 3D models are displayed in the 3D window, so that you can compare them with the graphs in the conventional report.
topurlMMYY.html, topdomMMYY.html, topuagMMYY.html, toprefMMYY.html
These files contain the Top Ten lists (actually it's Top N, where N is a configurable number) of the files, sites, browser types and referrer URLs. The URLs shown in topurlMMYY.html are either the real URLs requested by the visitor or an item (arbitrary text) you choosed to collect certain file names under (see the HideURL directive in the configuration file).
The domain names shown in topdomMMYY.html are either the second-level domains of the hosts accessing your server if the DNS name is available or an item you choosed to collect certain hostnames under (see the HideSys directive in the configuration file). Unresolved IP numbers show up as Unresolved.
The file topuagMMYY.html contains a list of all different user agents, which have been used by visitors to access your web site. The user agent information is an identification sent by the browser and logged by the web server. Although the format for this identification is well-defined, it isn't obeyed by any browser. If possible, http-analyze reduces the name of the user agent in the Top lists to the browser type including the first digit of its version number. If it is not possible to isolate the browser type from the user agent, the full identification string as sent by the browser is stored.
A referrer URL is the URL of the page containing a link to your web site, which has been followed by someone to reach your site. Note that for manually entered URLs no referrer URL gets logged. Also, some browsers do not send a referrer URL or send a faked one. Entries without a referrer URL are collected under Unknown in the referrer list. The list of referrer URLs is displayed in the Main window.
filesMMYY.html, sitesMMYY.html, agentsMMYY.html, refersMMYY.html
Those files contain a complete overview of the files, sites, browser types and referrer URLs, similar to the Top N lists.
lfilesMMYY.html, lsitesMMYY.html, lagentsMMYY.html, lrefersMMYY.html
Those files contain the detailed lists of all files, sites, browser types and referrer URLs, similar to the previous lists, but sorted by item (if any) and hits. On frequently accessed sites those lists can become rather large, so they are shown in the separate List window.
rfilesMMYY.html
contains all invalid URLs which caused the server to respond with a Code 404 (Not found) status. If there are large number of hits for certain files the server couldn't find, it's probably due to missing inline images or other HTML objects embedded in other pages. This report is displayed in the Main window.
rsitesMMYY.html
contains the list of reverse domains. This report is displayed in the Main window.
frames.html, header.html
This two files are required for the frames-based user interface. All other files are shared with the ones for the non-frames UI. In the frames-based UI, the Main window is inside the frame, while the List window is still an external window. The 3D window may be inside the frame or an external window (see the 3DWindow directive).
gr-icon.png
This small icon showing the graph from the main page is displayed on the main page under the base directory for each statistics report.