Item Reports
TR produces several reports that are based on the individual items it finds in your Logs. These items include information about the software being used by your visitors to access your site, your visitors DNS and IP addresses, the resources theyre requesting from your site, and so on.
Reports can be produced on the following items:
- Agent - The browser being used by a visitor to access your site.
- From - A somewhat obsolete log field that typically contains the visitors e-mail address. If your server Logs this kind of information, this report may interest you if youd like to correspond with your visitors.
- Hostname - The DNS and IP addresses of your visitors.
- Path Args - Contained in a log entrys URL, its meaning varies from site to site.
- Referrer - Visitors navigate your site by clicking its various links. The Referrer is the page that contained a link to the URL the visitor asks for. This is valuable information since referring pages outside of your web site tell you how your visitors found your web site.
- Search Args - Contained in a log entrys URL, its meaning varies from site to site.
- URL - The resource being requested from your site, such as an HTML page or image.
- User - Sometimes visitors may be required to provide a username and password to access part of your web site. This item contains their usernames.
In reports on the above items, TR displays successful file transfers (hits) and unsuccessful file transfers (errors) for each item. Items are sorted by hits.

In the above picture, the report shows that an Agent called mozilla/3.0gold (Win95: i) was involved in 324 successful file transfers. Each of the Item Reports requires that your log entries include the item corresponding to each report. The log entries also need to include Result information. See Appendix A for how these would appear in the log format you use.