模块 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可以包含变量。

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

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

$session_log_id

当前会话 ID；

$session_log_binary_id

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