ngx_http_session_log_module

ngx_http_session_log_module模块

• 示例配置

• 指令

• session_log_format

• session_log_zone

• session_log

• 嵌入式变量

该ngx_http_session_log_module模块启用日志记录会话（即多个HTTP请求的聚合）而不是单独的HTTP请求。

此模块可作为我们商业订阅的一部分。

示例配置

以下配置根据请求客户端地址和“User-Agent”请求标头字段设置会话日志并将请求映射到会话：

    session_log_zone /path/to/log format=combined
                     zone=one:1m timeout=30s
                     md5=$binary_remote_addr$http_user_agent;

    location /media/ {
        session_log one;
    }

指令

指定日志的输出格​​式。$body_bytes_sent变量的值在会话中的所有请求中汇总。可用于记录的所有其他变量的值对应于会话中的第一个请求。

设置日志文件的路径并配置用于存储当前活动会话的共享内存区域。

只要会话中上次请求的时间不超过指定时间timeout（默认为30秒），就认为会话处于活动状态。一旦会话不再有效，它将被写入日志。

该id参数标识请求映射到的会话。该id参数设置为MD5哈希的十六进制表示（例如，使用变量从cookie中获取）。如果未指定此参数或者不代表有效的MD5散列值，nginx会根据md5参数值计算MD5散列值，并使用此散列值创建新会话。无论是id和md5参数可以包含变量。

该format参数设置由session_log_format指令配置的自定义会话日志格式。如果format未指定，则使用预定义的“ combined”格式。

启用使用指定的会话日志。 特殊值关闭会取消从以前的配置级别继承的所有session_log指令。

嵌入式变量

该ngx_http_session_log_module模块支持两个嵌入式变量：

$ session_log_id当前会话ID; $ session_log_binary_id二进制形式的当前会话ID（16字节）。