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 指令

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

允许使用指定的会话日志。 特殊值 off 取消了从先前配置级别继承的 session_log 指令的效果。

session_log_format 指令

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

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

session_log_zone 指令

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

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

只要自会话中的最后一个请求以来经过的时间不超过指定的超时(默认为 30 秒),就认为会话处于活动状态。 一旦会话不再处于活动状态,就会将其写入日志。

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

format 参数设置 session_log_format 指令配置的自定义会话日志格式。 如果未指定格式,则使用预定义的“组合”格式。

内嵌变量

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

$session_log_id

当前会话 ID;

$session_log_binary_id

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

说说我的看法
全部评论(
没有评论
关于
本网站属于个人的非赢利性网站,转载的文章遵循原作者的版权声明,如果原文没有版权声明,请来信告知:hxstrive@outlook.com
公众号