Nginx日志格式定制（手把手教你打造专属日志记录）

默认日志长什么样？

如果你没改过配置，Nginx 的默认访问日志通常看起来像这样：

192.168.1.100 - - [10/Apr/2024:14:23:01 +0800] "GET /index.html HTTP/1.1" 200 1234 "-" "Mozilla/5.0 ..."  

这个格式虽然有用，但不够直观，也无法满足特定业务需求（比如记录响应时间、上游服务器等）。这时候就需要自定义Nginx日志了。

如何自定义日志格式？

Nginx 使用 log_format 指令来定义日志格式。你可以在主配置文件（通常是 /etc/nginx/nginx.conf）的 http 块中添加自己的格式。

步骤 1：编辑 Nginx 配置文件

打开配置文件：

sudo nano /etc/nginx/nginx.conf  

步骤 2：定义新的日志格式

在 http { } 块内添加如下内容（例如命名为 custom_log）：

log_format custom_log '$remote_addr - $remote_user [$time_local] '                      '"$request" $status $body_bytes_sent '                      '"$http_referer" "$http_user_agent" '                      'rt=$request_time uct="$upstream_connect_time" uht="$upstream_header_time" urt="$upstream_response_time"';  

上面的格式包含了一些高级字段，比如：

• $request_time：整个请求处理耗时（秒）
• $upstream_response_time：后端应用（如 PHP、Node.js）响应时间
• $http_referer：来源页面
• $http_user_agent：浏览器标识

步骤 3：在 server 或 location 中使用新格式

找到你的站点配置（通常在 /etc/nginx/sites-available/ 下），在 server 块中指定使用新格式：

server {    listen 80;    server_name example.com;    access_log /var/log/nginx/example.access.log custom_log;    location / {        root /var/www/html;        index index.html;    }}  

步骤 4：测试并重载 Nginx

保存配置后，先测试语法是否正确：

sudo nginx -t  

如果显示 success，就重载 Nginx：

sudo systemctl reload nginx  

常用变量参考

以下是几个常用的 Nginx 日志变量，方便你构建适合自己的Web服务器日志：

为什么要做 Nginx 日志分析？

通过合理的日志格式，你可以：

• 快速定位慢请求（结合 $request_time）
• 分析用户行为（来源、设备、访问路径）
• 配合 ELK（Elasticsearch + Logstash + Kibana）或 Grafana 进行可视化
• 满足安全审计或合规要求

掌握Nginx日志分析技能，是每个 Web 开发者和运维工程师的必备能力。

小结

本文从基础概念出发，一步步教你如何自定义 Nginx 日志格式。只需修改配置文件中的 log_format 和 access_log 指令，就能生成符合你业务需求的日志。记得每次修改后测试并重载 Nginx，避免服务中断。

现在，快去试试吧！打造属于你自己的智能日志系统。