Apache模块 mod_log_config

说明	允许记录日志和定制日志文件格式
状态	基本(B)
模块名	log_config_module
源文件	mod_log_config.c

概述

本模块提供了灵活的方法将客户请求记录到日志。日志可以用自定义的格式直接写入文件，或者传送到一个外部程序继续处理。条件日志功能可以实现根据请求的特征来决定一个日志信息是否被包含在最终的日志记录里面。

本模块提供了三个指令：TransferLog指令用来指定日志文件，LogFormat指令用来定义日志格式，CustomLog指令可以同时完成指定日志文件和定义日志格式。TransferLog和CustomLog指令在每个服务器上都可以被多次使用，以便将同一个请求记录到多个文件中。

定制日志文件格式

LogFormat和CustomLog指令的格式化参数是一个字符串。这个字符串会在每次请求发生的时候，被记录到日志中去。它可以包含将被原样写入日志的文本字符串以及C风格的控制字符"\n"和"\t"以实现换行与制表。文本中的引号和反斜杠应通过"\"来转义。

请求本身的情况将通过在格式字符串中放置各种"%"转义符的方法来记录，它们在写入日志文件时，根据下表的定义进行转换：

格式字符串描述

%% 百分号(Apache2.0.44或更高的版本)

%a 远端IP地址

%A 本机IP地址

%B 除HTTP头以外传送的字节数

%b 以CLF格式显示的除HTTP头以外传送的字节数，也就是当没有字节传送时显示'-'而不是0。

%{Foobar}C 在请求中传送给服务端的cookieFoobar的内容。

%D 服务器处理本请求所用时间，以微为单位。

%{FOOBAR}e 环境变量FOOBAR的值

%f 文件名

%h 远端主机

%H 请求使用的协议

%{Foobar}i 发送到服务器的请求头Foobar:的内容。

%l 远端登录名(由identd而来，如果支持的话)，除非IdentityCheck设为"On"，否则将得到一个"-"。

%m 请求的方法

%{Foobar}n 来自另一个模块的注解Foobar的内容。

%{Foobar}o 应答头Foobar:的内容。

%p 服务器服务于该请求的标准端口。

%P 为本请求提供服务的子进程的PID。

%{format}P 服务于该请求的PID或TID(线程ID)，format的取值范围为：pid和tid(2.0.46及以后版本)以及hextid(需要APR1.2.0及以上版本)

%q 查询字符串(若存在则由一个"?"引导，否则返回空串)

%r 请求的第一行

%s 状态。对于内部重定向的请求，这个状态指的是原始请求的状态，---%>s则指的是最后请求的状态。

%t 时间，用普通日志时间格式(标准英语格式)

%{format}t 时间，用strftime(3)指定的格式表示的时间。(默认情况下按本地化格式)

%T 处理完请求所花时间，以秒为单位。

%u 远程用户名(根据验证信息而来；如果返回status(%s)为401，可能是假的)

%U 请求的URL路径，不包含查询字符串。

%v 对该请求提供服务的标准ServerName。

%V 根据UseCanonicalName指令设定的服务器名称。

%X

请求完成时的连接状态：

`X`=	连接在应答完成前中断。
`+`=	应答传送完后继续保持连接。
`-`=	应答传送完后关闭连接。

(在1.3以后的版本中，这个指令是%c，但这样就和过去的SSL语法：%{var}c冲突了)

%I 接收的字节数，包括请求头的数据，并且不能为零。要使用这个指令你必须启用mod_logio模块。

%O 发送的字节数，包括请求头的数据，并且不能为零。要使用这个指令你必须启用mod_logio模块。

通用日志格式(CLF): "%h %l %u %t \"%r\" %>s %b"
带虚拟主机的通用日志格式: "%v %h %l %u %t \"%r\" %>s %b"
NCSA扩展/组合日志格式: "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\""
Referer日志格式: "%{Referer}i -> %U"
Agent(Browser)日志格式: "%{User-agent}i"

安全方面的提示。

说明在将日志写入磁盘前先在内存中进行缓冲语法 `BufferedLogs On|Off` 默认值 `BufferedLogs Off` 作用域 server config 状态基本(B) 模块 mod_log_config 兼容性仅在 Apache 2.0.41 及以后的版本中可用
`BufferedLogs`指令使得`mod_log_config`先在内存中缓冲一些日志内容，然后一次性写入磁盘，而不是立即写入。在一些系统上这样做可以提高磁盘性能。这个设置仅能够针对全局进行设置，不能单独针对虚拟主机进行设置。

这是一个试验性的指令，请在使用中多加小心。

说明设定针对cookies的日志文件名语法 `CookieLog filename` 作用域 server config, virtual host 状态基本(B) 模块 mod_log_config 兼容性反对使用该指令
`CookieLog`指令使用cookies作为日志文件名。文件是相对于`ServerRoot`目录的。包含本指令仅仅是为了保持与`mod_cookies`模块的兼容，并且反对使用。

说明设定日志的文件名和格式语法 `CustomLog file|pipe format|nickname [env=[!]environment-variable]` 作用域 server config, virtual host 状态基本(B) 模块 mod_log_config
`CustomLog`指令用来对服务器的请求进行日志记录。可以指定日志的格式，也可以使用环境变量根据请求的特征来自由地组织日志。

第一个参数指定了日志记录的位置，可以使用以下两种方式来设定：

`file`

相对于`ServerRoot`的日志文件名。

`pipe`

管道符"`|`"后面紧跟着一个把日志输出当作标准输入的处理程序路径。

安全

如果这里用到了程序，那么这个程序是以启动`httpd`的用户来执行的。因此如果启动httpd的用户是root ，那这个程序也将以root身份来运行；你需要确认这个程序是安全的。

注意

当在非UNIX平台上输入文件路径的时候，要特别注意即使平台本身是使用反斜杠(\)来分隔路径的，在这里也只能使用正斜杠(/)。通常在配置文件里只用正斜杠(/)来分隔路径总是不会错的。

第二个参数指定了写入日志文件的内容。它既可以是由前面的`LogFormat`指令定义的`nickname` ，也可以是直接按日志格式一节所描述的规则定义的`format`字符串。

例如：以下两组指令的结果是完全一样的：

`# 使用nickname LogFormat "%h %l %u %t \"%r\" %>s %b" common CustomLog logs/access_log common # 明确使用格式格式字符串 CustomLog logs/access_log "%h %l %u %t \"%r\" %>s %b"`

第三个参数是可选的，它根据服务器上特定的环境变量是否被设置来决定是否对某一特定的请求进行日志记录。如果这个特定的环境变量被设置(或者在"`env=!name`"的情况下未被设置)，那么这个请求将被记录。

可以使用`mod_setenvif`和/或`mod_rewrite`模块来为每个请求设置环境变量。例如：如果你想在服务器上将所有对GIF图片的请求记录在不同于主日志文件的另一个日志文件中，你可以使用下面的指令：

`SetEnvIf Request_URI \.gif$ gif-image CustomLog gif-requests.log common env=gif-image CustomLog nongif-requests.log common env=!gif-image`

或者为了复制旧有的RefererIgnore指令的行为，你可以使用下面的指令：

`SetEnvIf Referer example\.com localreferer CustomLog referer.log referer env=!localreferer`

说明定义访问日志的记录格式语法 `LogFormat format|nickname [nickname]` 默认值 `LogFormat "%h %l %u %t \"%r\" %>s %b"` 作用域 server config, virtual host 状态基本(B) 模块 mod_log_config
本指令定义访问日志的记录格式。

`LogFormat`指令可以使用两种定义格式中的一种。在第一种格式中，指令只带一个参数，以定义后续的`TransferLog`指令定义的日志格式。这个唯一的参数可以按上述自定义日志格式小节所描述的`format`来定义。另外它也可以通过下述的方法使用`nickname`来引用某个之前的`LogFormat`定义的日志格式。

第二种定义`LogFormat`指令的格式中，将一个直接的`format`和一个`nickname`联系起来。这样在后续的`LogFormat`或`CustomLog`指令中，就不用一再重复整个冗长的格式串。定义别名的`LogFormat`指令仅仅用来定义一个`nickname` ，而不做其它任何事情：也就是说，它只是定义了这个别名，它既没有实际应用这个别名，也不是把它设为默认的格式。因此，它不会影响后续的`TransferLog`指令。另外，`LogFormat`不能用一个别名来定义另一个别名。注意，别名不能包含百分号(`%`)。

示例

`LogFormat "%v %h %l %u %t \"%r\" %>s %b" vhost_common`

说明指定日志文件的位置语法 `TransferLog file|pipe` 作用域 server config, virtual host 状态基本(B) 模块 mod_log_config
本指令除不允许直接定义日志格式或根据条件进行日志记录外，与`CustomLog`指令有完全相同的参数和功能。实际应用中，日志的格式是由最近的非别名定义的`LogFormat`指令指定。如果没有定义任何日志格式，则使用通用日志格式。

示例

`LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\"" TransferLog logs/access_log`

Apache2.2 中文手册

Apache模块 mod_log_config

概述

定制日志文件格式

修饰符

一些说明

示例

安全方面的提示。

安全

注意

示例

示例