模块 ngx_http_session_log_module

这ngx_http_session_log_module模块启用日志记录 sessions（即多个 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;
    }

session_log off;

允许使用指定的会话日志。 特殊值off取消效果 的session_logDirectives 继承自之前的配置级别。

session_log_format combined "...";

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

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

会话被视为活动状态的持续时间为 会话中的最后一个请求不超过指定的timeout（默认情况下为 30 秒）。 一旦会话不再处于活动状态，它就会被写入日志。

这id参数标识 请求映射到的会话。 这idparameter 设置为十六进制表示形式 的 MD5 哈希值（例如，使用变量从 Cookie 获取）。 如果未指定此参数或不表示有效 MD5 哈希，nginx 根据 这md5参数，并使用此哈希创建新会话。 这id和md5参数 可以包含变量。

这format参数设置自定义会话日志 session_log_format格式。 如果format未指定，则预定义的 “combined“ 格式。

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

$session_log_id

当前会话 ID;

$session_log_binary_id

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