一、引言

在傳統(tǒng)的 HTTP 日志中，每個(gè)請(qǐng)求都會(huì)被單獨(dú)記錄，這對(duì)于短連接、異步加載等場(chǎng)景非常直觀；但在一些需要以“會(huì)話”為單位分析用戶行為的場(chǎng)景下，如視頻點(diǎn)播、多資源并行加載、長(zhǎng)輪詢等，單個(gè)請(qǐng)求日志難以準(zhǔn)確反映用戶整個(gè)會(huì)話的生命周期和流量消耗。

ngx_http_session_log_module 模塊（商業(yè)訂閱）針對(duì)這一需求推出：它可以將多個(gè)請(qǐng)求聚合為一個(gè)會(huì)話，待會(huì)話結(jié)束后一次寫(xiě)入日志，方便統(tǒng)計(jì)和分析。下面將以零基礎(chǔ)、逐步演示的方式，帶你掌握該模塊。

二、先決條件

• NGINX 商業(yè)版：確認(rèn)已包含 ngx_http_session_log_module。
• Linux 環(huán)境（Ubuntu/CentOS 等），擁有 sudo 權(quán)限。
• 配置與重載命令：會(huì)使用 nginx -t、systemctl reload nginx。

三、模塊驗(yàn)證

在終端執(zhí)行：

nginx -V 2>&1 | grep --color session_log

• 若輸出包含 --with-http_session_log_module 或 session_log，說(shuō)明模塊可用。
• 否則需聯(lián)系供應(yīng)商或重新編譯 NGINX（添加 --add-module=.../ngx_http_session_log_module）。

四、核心指令詳解

4.1 session_log_zone

session_log_zone /path/to/log
                 zone=name:size
                 [format=format_name]
                 [timeout=time]
                 [id=var]
                 [md5=expr];

• /path/to/log：會(huì)話日志文件路徑。
• zone=name:size：定義共享內(nèi)存區(qū) name 及大?。ㄈ?nbsp;1m）。
• format=format_name（可選）：引用由 session_log_format 定義的格式，默認(rèn)使用內(nèi)置的 combined。
• timeout=time（可選，默認(rèn) 30s）：自上一次請(qǐng)求起經(jīng)過(guò)該時(shí)間則認(rèn)為會(huì)話結(jié)束并寫(xiě)日志。
• id=var（可選）：如果來(lái)自客戶端的 var（例如 Cookie）是有效的 MD5，會(huì)直接作為會(huì)話 ID。
• md5=expr：當(dāng) id 不指定或無(wú)效時(shí)，基于 expr（可由多個(gè)變量拼接）計(jì)算 MD5 作為新會(huì)話 ID。

關(guān)鍵點(diǎn)：同一個(gè)會(huì)話下的所有請(qǐng)求，在 timeout 時(shí)間窗口內(nèi)都?xì)w為同一次日志；超時(shí)后才寫(xiě)入并重啟新會(huì)話。

4.2 session_log_format

session_log_format name string ...;

• name：格式名稱，用于 session_log_zone 的 format= 參數(shù)。
• string：日志模板，支持所有標(biāo)準(zhǔn) HTTP 變量，以及 $body_bytes_sent 會(huì)話內(nèi)累積值，其他變量取首個(gè)請(qǐng)求的值。

常見(jiàn)內(nèi)置變量：

4.3 session_log

session_log name | off;

• name：?jiǎn)⒂脤?duì)應(yīng) session_log_zone 中定義的會(huì)話日志。
• off：關(guān)閉當(dāng)前級(jí)別繼承的會(huì)話日志。

可在 http、server 或 location 級(jí)別使用。

五、一步步配置示例

下面我們以“客戶端 IP + User-Agent”作為會(huì)話標(biāo)識(shí)，統(tǒng)計(jì) /media/ 路徑下所有請(qǐng)求的會(huì)話日志。

5.1 創(chuàng)建持久化目錄

sudo mkdir -p /var/log/nginx/session
sudo chown nginx:nginx /var/log/nginx/session

5.2 在 http 塊中定義會(huì)話日志區(qū)

編輯 /etc/nginx/nginx.conf，在 http { ... } 內(nèi)添加：

# 定義會(huì)話日志區(qū)，1MB 大小，30s 超時(shí)，會(huì)話結(jié)束寫(xiě)入 /var/log/nginx/session/media.log
# 會(huì)話格式使用默認(rèn) combined，也可自定義
session_log_zone /var/log/nginx/session/media.log
                 zone=media_zone:1m
                 timeout=30s
                 md5=$binary_remote_addr$http_user_agent;

5.3 自定義日志格式（可選）

如需記錄更多字段，可在 http 塊繼續(xù)添加：

session_log_format media_fmt 
    '$session_log_id '
    '$remote_addr [$time_local] '
    '"$http_user_agent" '
    'bytes_sent=$body_bytes_sent '
    'session_time=$session_time';

然后在 session_log_zone 中加上 format=media_fmt。

5.4 在 server/location 啟用

server {
    listen 80;
    server_name example.com;

    location /media/ {
        # 開(kāi)啟會(huì)話級(jí)日志
        session_log media_zone;
    }

    # 其他路徑不記錄
}

5.5 檢查與重載

sudo nginx -t && sudo systemctl reload nginx

六、驗(yàn)證與測(cè)試

• 模擬會(huì)話在瀏覽器或命令行中多次請(qǐng)求同一資源，確保連續(xù)請(qǐng)求間隔小于 30s：

  curl http://example.com/media/video1.ts
  sleep 5
  curl http://example.com/media/video2.ts
  

• 查看日志

  tail -n20 /var/log/nginx/session/media.log
  

  你將看到類似：

  5f2d3a4b... 192.168.1.10 [12/May/2025:14:00:00 +0800] "Mozilla/5.0 ..." bytes_sent=1048576 session_time=5.123
  

  其中：

  • 第一列 為會(huì)話 ID；
  • bytes_sent 為兩次請(qǐng)求的累計(jì)發(fā)送字節(jié)；
  • session_time 為首次到最后一次請(qǐng)求的時(shí)長(zhǎng)。

七、典型應(yīng)用場(chǎng)景

• 流媒體點(diǎn)播統(tǒng)計(jì)聚合一次完整的視頻播放會(huì)話（多個(gè)分片請(qǐng)求），統(tǒng)計(jì)總流量與觀看時(shí)長(zhǎng)。
• 長(zhǎng)輪詢/Comet 會(huì)話將多次心跳/推送請(qǐng)求歸為一次會(huì)話，評(píng)估用戶在線時(shí)長(zhǎng)。
• API 批量操作若客戶端將多次批量操作拆分為多請(qǐng)求，可按會(huì)話統(tǒng)計(jì)請(qǐng)求總量與數(shù)據(jù)大小。

八、進(jìn)階配置與優(yōu)化

• 調(diào)整 timeout

  • 對(duì)于長(zhǎng)連接、心跳場(chǎng)景，可將 timeout 設(shè)置更高（如 5m）。

• 指定 id 參數(shù)

  • 若前端通過(guò) Cookie 提供穩(wěn)定會(huì)話 ID，可寫(xiě) id=$cookie_sessionid，避免重復(fù)新建。

• 日志輪轉(zhuǎn)

  • 配合 logrotate 工具定期切割 /var/log/nginx/session/*.log，防止磁盤(pán)占滿。

• 性能監(jiān)控

  • 監(jiān)控共享內(nèi)存使用情況，若活躍會(huì)話數(shù)極多，可增大 zone=size。

九、常見(jiàn)問(wèn)題與排查

十、總結(jié)

通過(guò) ngx_http_session_log_module，你可以：

• 以會(huì)話級(jí)別代替請(qǐng)求級(jí)日志，直觀統(tǒng)計(jì)用戶完整交互。
• 聚合流量與時(shí)長(zhǎng)，方便流媒體、長(zhǎng)輪詢、批量 API 等場(chǎng)景分析。
• 靈活配置超時(shí)、格式、ID 源，滿足各種業(yè)務(wù)需求。

掌握以上配置與調(diào)優(yōu)方法后，即可在 NGINX 層為復(fù)雜 HTTP 會(huì)話提供精準(zhǔn)、連貫的日志記錄，助力業(yè)務(wù)監(jiān)控與數(shù)據(jù)分析。祝你上手順利，靈活運(yùn)維！

到此這篇關(guān)于詳解ngx_http_session_log_module的使用的文章就介紹到這了,更多相關(guān)ngx_http_session_log_module使用內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！