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