Module ngx_http_session_log_module

• Example Configuration
• Directives
  • session_log
  • session_log_format
  • session_log_zone
• Embedded Variables
  

ngx_http_session_log_module模块启用日志记录会话(即，多个 HTTP 请求的聚集)，而不是单个 HTTP 请求。

Example Configuration

以下配置根据请求客户端地址和“ User-Agent”请求 Headers 字段设置会话日志并将请求映射到会话：

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

Syntax:	session_log name | off;
Default:	session_log off;
Context:	http , server , location

启用对指定会话日志的使用。特殊值off取消从上一个配置级别继承的所有session_log指令。

Syntax:	session_log_format name string ...;
Default:	session_log_format combined "...";
Context:	http

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

Syntax:	session_log_zone path zone=name:size [format=format] [timeout=time] [id=id] [md5=md5] ;
Default:	—
Context:	http

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

只要会话中的最后一个请求没有超过指定的timeout(默认为 30 秒)，该会话就被视为活动状态。一旦会话不再活动，它将被写入日志。

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

format参数设置由session_log_format指令配置的自定义会话日志格式。如果未指定format，则使用 sched 义的“ combined”格式。

Embedded Variables

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

$session_log_id

• 当前会话 ID；

$session_log_binary_id

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