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