ngx_http_session_log_module 模块

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

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

以下配置设置会话日志，并根据请求客户端地址和“用户代理”请求头字段将请求映射到会话

    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 字节）。