零、自定义格式

Nginx 默认日志格式（定义在 /etc/nginx/nginx.conf http 段配置中）：

log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                    '$status $body_bytes_sent "$http_referer" '
                    '"$http_user_agent" "$http_x_forwarded_for"';

输出结果如下：

/ # tail -f /var/log/nginx/markjour.com_access.log
172.18.0.1 - - [10/Mar/2024:09:59:24 +0000] "GET /webhook/api/events?endpoint_name=asc&limit=10&last_id=914&desc=False HTTP/1.1" 200 3 "-" "python-requests/2.33.1" "-"
172.18.0.1 - - [10/Mar/2024:09:59:29 +0000] "GET /webhook/api/events?endpoint_name=asc&limit=10&last_id=914&desc=False HTTP/1.1" 200 3 "-" "python-requests/2.33.1" "-"
172.18.0.1 - - [10/Mar/2024:09:59:34 +0000] "GET /webhook/api/events?endpoint_name=asc&limit=10&last_id=914&desc=False HTTP/1.1" 200 3 "-" "python-requests/2.33.1" "-"

我觉得这个数据量有点太少了，排查问题的时候不够，上游处理时间都没有，调试时改成这样：

log_format woodylog
    'time="$time_iso8601" '
    'remote_addr="$remote_addr" '
    'remote_user="$remote_user" '
    'xff="$http_x_forwarded_for" '
    'host="$host" '
    'method="$request_method" '
    'uri="$uri" '
    'args="$args" '
    'status=$status '
    'body_bytes=$body_bytes_sent '
    'request_length=$request_length '
    'request_time=$request_time '
    'upstream="$upstream_addr" '
    'upstream_status="$upstream_status" '
    'upstream_connect_time="$upstream_connect_time" '
    'upstream_header_time="$upstream_header_time" '
    'upstream_response_time="$upstream_response_time" '
    'referer="$http_referer" '
    'ua="$http_user_agent" '
    'request_id="$request_id"';

time="2024-03-10T10:00:29+00:00" remote_addr="117.152.221.178" remote_user="-" xff="-" host="markjour.com" method="GET" uri="/testcases/runs/1466daf3" args="result=failed" status=200 body_bytes=61411 request_length=3152 request_time=2.190 upstream="172.17.0.1:9999" upstream_status="200" upstream_connect_time="0.000" upstream_header_time="2.188" upstream_response_time="2.190" referer="-" ua="Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/150.0.0.0 Safari/537.36 Edg/150.0.0.0" request_id="f9319ae69738a1e1d33701a095b0c790"

Nginx 日志变量主要来自以下几个模块：

• Core（核心变量）
• HTTP（请求相关）
• Stream（TCP/UDP）
• SSL
• GeoIP
• Upstream
• HTTP Header
• 自定义变量（map、set、js、lua 等）

HTTP 场景（access_log）常用变量如下。

一、请求信息

二、客户端信息

三、Host

四、响应信息

凡是响应 Header，都可以：

$sent_http_x_request_id
$sent_http_etag
$sent_http_server

五、时间

六、连接信息

七、SSL

八、Upstream（反向代理最常用）

九、请求 Header

任何请求 Header 都可以写：

$http_user_agent
$http_referer
$http_cookie
$http_origin
$http_authorization
$http_accept
$http_accept_language
$http_x_forwarded_for
$http_x_real_ip

规则：

Header: X-Request-Id

↓

$http_x_request_id

即：

• 全部小写
• - 变 _
• 前缀 $http_

十、Cookie

Cookie 同样可以直接获取：

$cookie_sessionid
$cookie_token
$cookie_uid

例如

Cookie:
sessionid=abc
uid=100

对应

$cookie_sessionid
$cookie_uid

十一、变量组合

十二、自定义变量

可以通过 set、map 等创建变量：

map $http_user_agent $device {
    default desktop;
    "~Mobile" mobile;
}

log_format json escape=json
'{"device":"$device"}';

或者：

set $cluster "prod";

log_format main
'$cluster';

十三、查看所有可用变量

官方没有提供运行时命令列出所有变量，但可以参考官方文档：

• ngx_http_core_module 中的 Embedded Variables（核心嵌入变量）
• 各模块文档（如 ngx_http_ssl_module、ngx_http_upstream_module）中的变量说明

实际可用变量取决于你的 Nginx 编译模块（例如是否启用了 SSL、RealIP、GeoIP 等）。

如果你的目标是设计一套生产环境 JSON 日志，通常会记录以下字段：

time
request_id
remote_addr
xff
host
method
uri
args
status
request_length
body_bytes_sent
request_time
upstream_addr
upstream_status
upstream_connect_time
upstream_header_time
upstream_response_time
referer
user_agent

这套字段基本覆盖了访问分析、性能分析、故障排查和链路追踪等常见场景。