在 nginx 中配置日志格式,需要在 http 块内使用 log_format 指令定义名称和变量组合,并在 server 或 location 块中通过 access_log 指令引用该名称。这样做可以将默认的简单日志替换为包含请求时间、响应状态、上游地址等详细信息的结构化数据,便于后续分析。

如何定义包含特定变量的自定义日志格式
要定义一个包含特定变量的自定义日志格式,必须在 http 上下文中使用 log_format 指令。例如,定义名为 main_custom 的格式,可以指定 $remote_addr(客户端 IP)、$time_local(本地时间)和 $status(状态码)。Nginx 会按照定义的顺序将这些变量的值拼接成一行文本输出到日志文件中。

http {
log_format main_custom '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent"';
server {
listen 80;
server_name example.com;
access_log /var/log/nginx/access.log main_custom;
}
}
上述配置定义了 main_custom 格式,并在 server 块中将其应用于 /var/log/nginx/access.log。当请求到达时,Nginx 会解析 log_format 中的字符串,替换其中的变量,并写入日志。预期结果是日志文件中每一行都包含客户端 IP、用户标识、请求时间、请求方法、URL、状态码、响应大小、Referer 和 User-Agent。
如何配置日志以记录上游服务器响应时间
若要记录上游服务器(如后端应用服务器)的响应时间,需要在 log_format 中引入 $upstream_response_time 变量。这通常用于反向代理场景,帮助排查后端性能问题。同时,可以结合 $upstream_addr 记录实际处理请求的后端地址。

http {
log_format upstream_log '$remote_addr - $remote_user [$time_local] '
'"$request" $status '
'$upstream_addr $upstream_response_time';
server {
listen 80;
server_name example.com;
location /api/ {
proxy_pass http://backend_servers;
access_log /var/log/nginx/upstream.log upstream_log;
}
}
}
此配置在 location /api/ 中使用了专门的日志格式 upstream_log,重点记录了 $upstream_addr 和 $upstream_response_time。当请求被代理到后端时,Nginx 会捕获后端的响应时间和地址,并将其追加到日志中。如果后端无响应,$upstream_response_time 可能为空或显示为 -,具体取决于 Nginx 版本和配置。
当 upstream_response_time 为空时说明什么
当 $upstream_response_time 在日志中显示为空或 - 时,通常表示请求未成功转发到任何上游服务器,或者上游服务器未返回有效响应。这可能发生在连接失败、超时或被拒绝的情况下。此时,应检查 $status 字段,若状态码为 502、504 或 503,则进一步确认是网络问题还是后端服务不可用。


















