AgentLog Directive

Top - Docs - General - Server - Resource - Access - FAQ - Tutorials

Purpose

The AgentLog directive tells HTTPd where to record client agent software. The UserAgent header, if present, is recorded in the format sent by the client. If LogOptions is set to Combined, this directive does nothing.

This is for statistical purposes and the tracing of protocol violations. It should be included by all clients. The first white space delimited word must be the software product name, with an optional slash and version designator. Other products which form part of the user agent may be put as separate words.

A User Agent Log Example

The timestamp is the same from the access_log. 
[02/Oct/1995:12:00:28] SPRY_Mosaic/v7.36 (Windows 16-bit) SPRY_package/v4.00
[02/Oct/1995:12:00:28] Mozilla/1.1N (X11; I; SunOS 5.3 sun4c)
[02/Oct/1995:12:00:29] Mozilla/1.0N (Windows)
[02/Oct/1995:12:00:29] Mozilla/1.22 (Windows; I; 16bit)
[02/Oct/1995:12:00:29] NCSA Mosaic for the X Window System/2.4  libwww/2.12 modified
[02/Oct/1995:12:00:30] Mozilla/1.0N (Windows)
[02/Oct/1995:12:00:30] IBM WebExplorer DLL /v1.02  via proxy gateway  CERN-HTTPD/3.0pre5 libwww/2.16pre  via proxy gateway  CERN-HTTPD/3.0pre5 libwww/2.16pre
[02/Oct/1995:12:00:31] NCSA Mosaic for the X Window System/2.4  libwww/2.12 modified
[02/Oct/1995:12:00:32] MacWeb/1.00ALPHA3  libwww/2.17

Syntax

AgentLog file

file is the name of the file to which user agents will be logged. It is either a full pathname, or a partial pathname relative to ServerRoot.

Virtual Host

This directive is valid in the virtual host section.

Default

If you do not specify an AgentLog, HTTPd assumes:

AgentLog logs/agent_log

Compile Option: DEFAULT_AGENTLOG

Examples

AgentLog logs/agents

This logs user agents to the file logs/agents in the ServerRoot directory.

AgentLog /tmp/httpd-agents

This logs user agents to the file /tmp/httpd-agents.

AgentLog /dev/null

This effectively turns off agent logging.

[Back] Return to Server Configuration File Overview
NCSA HTTPd Development Team / httpd@ncsa.uiuc.edu / 10-02-95