Nginx日志格式配置的实现

Nginx日志格式配置 

Nginx日志一般有main格式（默认）和json格式两种

对比总结

💡 最佳实践

• 性能优先： 如果服务器性能不足，优先使用文本格式。
• 日志分析优先： 如果要进行集中化日志分析（如 ELK），优先使用JSON 格式。
• 日志分级： 错误日志使用文本格式，访问日志使用 JSON 格式，这样既能高效记录错误，又能对业务数据进行分析。
• 日志切割与归档： 及时进行日志切割和清理，避免磁盘爆满。

🎯 总结

• 默认文本格式： 高性能，低资源消耗，适合轻量级或性能要求高的生产环境。
• JSON 格式： 结构化日志，便于分析和监控，适合现代化运维和日志管理需求。

一、main 日志变量

1. 请求相关变量

2. 时间相关变量

3. 客户端相关变量

4. 上游服务器相关变量

5. 请求处理相关变量

6. Nginx 内部变量

示例配置：Nginx 日志格式

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

access_log /var/log/nginx/access.log main

#输出结果

192.168.200.1 - - [19/Mar/2025:03:26:35 -0400] "GET /prod-api/captchaImage HTTP/1.1" 200 4137 "http://192.168.200.14/login?redirect=%2Findex" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36 Edg/134.0.0.0" "-"
192.168.200.1 - - [19/Mar/2025:03:26:40 -0400] "POST /prod-api/login HTTP/1.1" 200 239 "http://192.168.200.14/login?redirect=%2Findex" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36 Edg/134.0.0.0" "-"

字段含义：

• time：
  • 日志时间戳，采用 ISO 8601 格式。
    • "2025-03-19T04:51:55-04:00"：表示 2025 年 3 月 19 日，04:51:55（-04:00 时区）。
• request_time：
  • 请求总耗时，单位是秒。
    • "0.000"：表示从接收到请求到返回响应的时间为 0 秒，响应极快。
• upstream_response_time：
  • 上游服务器（如 Tomcat）响应时间，单位是秒。
    • "-"：表示当前请求没有经过上游服务器（如静态资源请求）。
• remote_addr：
  • 客户端 IP 地址。
    • "192.168.200.1"：请求是从该 IP 地址发出的。
• remote_user：
  • 远程用户的身份认证信息。
    • "-"：表示未进行身份认证（或不涉及认证）。
• request：
  • 请求行，包含请求方法、资源路径和协议版本。
    • "GET /static/js/chunk-2d0bce05.7b94b559.js HTTP/1.1"：表示发起了 GET 请求，访问了指定的静态资源文件。
• status：
  • 响应状态码，表示请求处理结果。
    • "200"：请求成功。
• body_bytes_sent：
  • 发送给客户端的响应体字节数。
    • "10029"：表示响应体大小为 10029 字节。
• http_referer：
  • 请求来源的 URL，表示请求是从哪个页面发起的。
    • "http://192.168.200.14/monitor/druid"：表示从监控页面发起的请求。
• http_user_agent：
  • 客户端的用户代理信息，通常包含浏览器和操作系统信息。
    • "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36 Edg/134.0.0.0"
• http_x_forwarded_for：
  • 用于记录客户端真实 IP 地址，通常用于反向代理或负载均衡场景。
    • "-"：表示没有经过代理或没有携带该头信息。

二、Json常用变量

1.请求相关变量

2.时间和日期相关变量

3.客户端和用户相关变量

4.上游和代理相关变量

5.请求处理和性能相关变量

6.系统和环境变量

示例：JSON 日志格式配置

log_format json '{"time":"$time_iso8601",'
                '"request_time":$request_time,'
                '"upstream_response_time":"$upstream_response_time",'
                '"remote_addr":"$remote_addr",'
                '"remote_user":"$remote_user",'
                '"request":"$request",'
                '"status":$status,'
                '"body_bytes_sent":$body_bytes_sent,'
                '"http_referer":"$http_referer",'
                '"http_user_agent":"$http_user_agent",'
                '"http_x_forwarded_for":"$http_x_forwarded_for"}';

access_log /var/log/nginx/access.log json;

#输出结果

{"time":"2025-03-19T04:51:55-04:00","request_time":0.000,"upstream_response_time":"-","remote_addr":"192.168.200.1","remote_user":"-","request":"GET /static/js/chunk-2d0bce05.7b94b559.js HTTP/1.1","status":200,"body_bytes_sent":10029,"http_referer":"http://192.168.200.14/monitor/druid","http_user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36 Edg/134.0.0.0","http_x_forwarded_for":"-"}
{"time":"2025-03-19T04:51:56-04:00","request_time":0.010,"upstream_response_time":"0.009","remote_addr":"192.168.200.1","remote_user":"-","request":"GET /prod-api/monitor/server HTTP/1.1","status":200,"body_bytes_sent":93,"http_referer":"http://192.168.200.14/monitor/server","http_user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36 Edg/134.0.0.0","http_x_forwarded_for":"-"}

字段含义：

• time：

  • 日志时间戳，采用 ISO 8601 格式。
  • "2025-03-19T04:51:55-04:00"：表示 2025 年 3 月 19 日，04:51:55（-04:00 时区）。

• request_time：

  • 请求总耗时，单位是秒。
  • "0.000"：表示从接收到请求到返回响应的时间为 0 秒，响应极快。

• upstream_response_time：

  • 上游服务器（如 Tomcat）响应时间，单位是秒。
  • "-"：表示当前请求没有经过上游服务器（如静态资源请求）。

• remote_addr：

  • 客户端 IP 地址。
  • "192.168.200.1"：请求是从该 IP 地址发出的。

• remote_user：

  • 远程用户的身份认证信息。
  • "-"：表示未进行身份认证（或不涉及认证）。

• request：

  • 请求行，包含请求方法、资源路径和协议版本。

  • "GET /static/js/chunk-2d0bce05.7b94b559.js HTTP/1.1"
    

    • GET：HTTP 请求方法。
    • /static/js/chunk-2d0bce05.7b94b559.js：请求的资源路径。
    • HTTP/1.1：协议版本。

• status：

  • HTTP 响应状态码。
  • 200：表示请求成功。

• body_bytes_sent：

  • 响应体的字节数。
  • 10029：表示响应大小为 10029 字节（约 9.8 KB）。

• http_referer：

  • 引荐页面，即从哪个页面发起的请求。
  • "http://192.168.200.14/monitor/druid"：用户是从这个页面发起的请求。

• http_user_agent：

  • 客户端的浏览器和操作系统信息。
  • 浏览器：Chrome 134.0.0.0
  • 操作系统：Windows 10 x64

• http_x_forwarded_for：

  • 用于识别通过代理服务器访问的客户端的真实 IP。
  • "-"：表示没有经过代理，或没有传递该头信息。

到此这篇关于Nginx日志格式配置的实现的文章就介绍到这了,更多相关Nginx日志配置内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！