模块 ngx_http_session_log_module

模块 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;
    }

session_log off;

启用指定的会话日志。特殊值 off 取消了从上一配置级别继承的 session_log 指令的影响。

session_log_format combined "...";

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

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

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

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

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

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

$session_log_id

当前会话ID；

$session_log_binary_id

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