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 name | off; 默认值:session_log off; 上下文:http, server, location
允许使用指定的会话日志。 特殊值 off 取消了从先前配置级别继承的 session_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 秒),就认为会话处于活动状态。 一旦会话不再处于活动状态,就会将其写入日志。
id 参数标识请求映射到的会话。 id 参数设置为 MD5 哈希的十六进制表示(例如,使用变量从 cookie 中获取)。 如果未指定此参数或不代表有效的 MD5 哈希,则 nginx 根据 md5 参数的值计算 MD5 哈希并使用此哈希创建新会话。 id 和 md5 参数都可以包含变量。
format 参数设置 session_log_format 指令配置的自定义会话日志格式。 如果未指定格式,则使用预定义的“组合”格式。
ngx_http_session_log_module 模块支持两个嵌入式变量:
当前会话 ID;
二进制形式的当前会话 ID(16 字节)。