模块 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 |
---|---|
默认值: |
session_log off; |
上下文: |
http , ,server location |
允许使用指定的会话日志。
特殊值取消效果
Directives
继承自之前的配置级别。off
session_log
语法: |
session_log_format
|
---|---|
默认值: |
session_log_format combined "..."; |
上下文: |
http |
指定日志的输出格式。
变量的值在
会话中的所有请求。
可用于日志记录的所有其他变量的值对应于
会话中的第一个请求。$body_bytes_sent
语法: |
session_log_zone
|
---|---|
默认值: | — |
上下文: |
http |
设置日志文件的路径并配置使用的共享内存区域 来存储当前活动的会话。
会话被视为活动状态的持续时间为
会话中的最后一个请求不超过指定的时间(默认情况下为 30 秒)。
一旦会话不再处于活动状态,它就会被写入日志。timeout
该参数标识
请求映射到的会话。
该参数设置为十六进制表示形式
的 MD5 哈希值(例如,使用变量从 Cookie 获取)。
如果未指定此参数或不表示有效
MD5 哈希,nginx 根据
参数并使用此哈希创建新会话。
和 参数
可以包含变量。id
id
md5
id
md5
该参数设置自定义会话日志
session_log_format格式。
如果未指定,则预定义的
使用了 “” 格式。format
format
combined
嵌入变量
该模块支持
两个嵌入变量:ngx_http_session_log_module
$session_log_id
- 当前会话 ID;
$session_log_binary_id
- 二进制形式的当前会话 ID(16 字节)。