模块 ngx_http_session_log_module

session_log
session_log_format
session_log_zone
嵌入变量的配置
Directives
示例

该模块启用日志记录 sessions(即多个 HTTP 请求的聚合)而不是 单个 HTTP 请求。ngx_http_session_log_module

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

示例配置

以下配置设置会话日志并将请求映射到 根据请求客户端地址和 “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;
    }

Directives

语法: session_log name | off;
默认值:
session_log off;
上下文: http, ,serverlocation

允许使用指定的会话日志。 特殊值取消效果 Directives 继承自之前的配置级别。offsession_log

语法: session_log_format name string ...;
默认值:
session_log_format combined "...";
上下文: http

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

语法: session_log_zone path zone=name:size [format=format] [timeout=time] [id=id] [md5=md5] ;
默认值:
上下文: http

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

会话被视为活动状态的持续时间为 会话中的最后一个请求不超过指定的时间(默认情况下为 30 秒)。 一旦会话不再处于活动状态,它就会被写入日志。timeout

该参数标识 请求映射到的会话。 该参数设置为十六进制表示形式 的 MD5 哈希值(例如,使用变量从 Cookie 获取)。 如果未指定此参数或不表示有效 MD5 哈希,nginx 根据 参数并使用此哈希创建新会话。 和 参数 可以包含变量。ididmd5idmd5

该参数设置自定义会话日志 session_log_format格式。 如果未指定,则预定义的 使用了 “” 格式。formatformatcombined

嵌入变量

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

$session_log_id
当前会话 ID;
$session_log_binary_id
二进制形式的当前会话 ID(16 字节)。