### Apache HTTP Server Version 1.3

Is this the version you want? For more recent versions, check our documentation index.

# Module mod_log_agent

This module provides for logging of the client user agents.

Status: Extension
Source File: mod_log_agent.c
Module Identifier: agent_log_module

## Summary

This module is provided strictly for compatibility with NCSA httpd, and is deprecated. We recommend you use mod_log_config instead.

## Directives

- AgentLog

See also: CustomLog and LogFormat.

## AgentLog

Syntax: AgentLog file-pipe
Default: `AgentLog logs/agent_log`
Context: server config, virtual host
Status: Extension
Module: mod_log_agent

The AgentLog directive sets the name of the file to which the server will log the UserAgent header of incoming requests. File-pipe is one of

A filename
  A filename relative to the ServerRoot.
`|' followed by a command
  A program to receive the agent log information on its standard input. Note the a new program will not be started for a VirtualHost if it inherits the AgentLog from the main server.

Security: if a program is used, then it will be run under the user who started httpd. This will be root if the server was started by root; be sure that the program is secure.

Security: See the security tips document for details on why your security could be compromised if the directory where logfiles are stored is writable by anyone other than the user that starts the server.

This directive is provided for compatibility with NCSA 1.4. The same result can be obtained by using the LogFormat and CustomLog directives as shown in the following example:

        LogFormat "%{User-agent}i" agent
        CustomLog logs/agent_log agent

### Apache HTTP Server Version 1.3