Nginx日志格式配置

于 2025-03-19 17:09:44 发布
阅读量1k 收藏 20
点赞数 32
文章标签： nginx 服务器 网络
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_45867513/article/details/146375473
版权

Nginx日志格式配置

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

对比总结

特性默认文本格式JSON 格式
性能高性能，占用资源低解析耗时，CPU 占用相对较高
磁盘占用日志简短，占用小每个字段都带有名称，占用较大
日志分析需要手动解析，较为复杂结构化数据，分析工具集成方便
可读性人眼查看方便不直观，主要靠日志系统查看
扩展性不方便添加新字段灵活添加新字段
集成性兼容传统日志工具适合与 ELK、EFK 进行日志对接

💡 最佳实践

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

🎯 总结

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

一、main 日志变量

1. 请求相关变量

变量名含义示例值
$remote_addr客户端的 IP 地址192.168.1.1
$remote_user客户端的认证用户名admin
$request请求的完整字符串（方法 + URI + 协议）GET /index.html HTTP/1.1
$request_method请求的方法GET, POST
$request_uri原始的请求 URI（包括参数）/index.html?user=123
$uri请求的 URI，不包括查询参数/index.html
$args请求的查询参数字符串user=123&name=abc
$query_string与 $args 等效，查询字符串user=123&name=abc
$status响应的 HTTP 状态码200, 404
$body_bytes_sent响应体大小（字节数）2048
$http_referer引荐页面 URLhttp://example.com/
$http_user_agent客户端的浏览器信息Mozilla/5.0 (Windows NT)

2. 时间相关变量

变量名含义示例值
$time_local本地时间戳19/Mar/2025:04:03:51 +0800
$time_iso8601ISO 8601 格式的时间戳2025-03-19T04:03:51+08:00
$msec精确到毫秒的 Unix 时间戳1614768000.123

3. 客户端相关变量

变量名含义示例值
$remote_addr客户端的 IP 地址192.168.1.1
$remote_port客户端的端口号52345
$http_x_forwarded_for客户端的原始 IP 地址，通常用于代理链路中192.168.1.1
$http_user_agent客户端的 User-Agent 信息Mozilla/5.0 (Windows NT)
$http_referer请求的来源 URL（如果有的话）http://example.com/

4. 上游服务器相关变量

变量名含义示例值
$upstream_addr上游服务器的地址（包括端口）127.0.0.1:8080
$upstream_status上游服务器响应的状态码200, 502
$upstream_response_time上游服务器的响应时间（秒）0.125
$upstream_connect_time与上游服务器建立连接的时间0.050

5. 请求处理相关变量

变量名含义示例值
$request_time处理请求所花费的总时间（秒）0.123
$response_time响应返回的总时间（秒）0.098
$upstream_response_time从上游服务器接收到响应的时间（秒）0.125
$pipe是否通过管道连接处理请求，p 表示是，. 表示不是p

6. Nginx 内部变量

变量名含义示例值
$hostnameNginx 主机名nginx-server
$server_name当前处理请求的服务器名称www.example.com
$server_addr当前处理请求的服务器 IP 地址192.168.1.1
$nginx_version当前 Nginx 的版本号1.21.3
示例配置：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" "-"
字段含义：
  1. time：
    • 日志时间戳，采用 ISO 8601 格式。
      • "2025-03-19T04:51:55-04:00"：表示 2025 年 3 月 19 日，04:51:55（-04:00 时区）。
  2. request_time：
    • 请求总耗时，单位是秒。
      • "0.000"：表示从接收到请求到返回响应的时间为 0 秒，响应极快。
  3. upstream_response_time：
    • 上游服务器（如 Tomcat）响应时间，单位是秒。
      • "-"：表示当前请求没有经过上游服务器（如静态资源请求）。
  4. remote_addr：
    • 客户端 IP 地址。
      • "192.168.200.1"：请求是从该 IP 地址发出的。
  5. remote_user：
    • 远程用户的身份认证信息。
      • "-"：表示未进行身份认证（或不涉及认证）。
  6. request：
    • 请求行，包含请求方法、资源路径和协议版本。
      • "GET /static/js/chunk-2d0bce05.7b94b559.js HTTP/1.1"：表示发起了 GET 请求，访问了指定的静态资源文件。
  7. status：
    • 响应状态码，表示请求处理结果。
      • "200"：请求成功。
  8. body_bytes_sent：
    • 发送给客户端的响应体字节数。
      • "10029"：表示响应体大小为 10029 字节。
  9. http_referer：
    • 请求来源的 URL，表示请求是从哪个页面发起的。
      • "http://192.168.200.14/monitor/druid"：表示从监控页面发起的请求。
  10. 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"
  11. http_x_forwarded_for：
    • 用于记录客户端真实 IP 地址，通常用于反向代理或负载均衡场景。
      • "-"：表示没有经过代理或没有携带该头信息。

二、Json常用变量

1.请求相关变量

变量名含义示例值
$request请求的完整字符串（方法+URI+协议）GET /index.html HTTP/1.1
$request_method请求方法GET, POST, PUT, DELETE
$request_uri原始请求的 URI（包含参数）/index.html?user=123
$uri请求的 URI（不含参数）/index.html
$args请求的参数字符串user=123&name=abc
$query_string与 $args 等效user=123&name=abc
$status响应状态码200, 404, 500
$protocol请求协议HTTP/1.1, HTTP/2.0
$host请求主机名www.example.com
$server_name服务器名称example.com
$server_port服务器端口80, 443

2.时间和日期相关变量

变量名含义示例值
$time_iso8601ISO 8601 格式的时间戳2025-03-19T04:03:51+08:00
$time_local本地时间戳19/Mar/2025:04:03:51 +0800
$msec精确到毫秒的时间戳（Unix 时间戳）1614768000.123

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

变量名含义示例值
$remote_addr客户端 IP 地址192.168.1.1
$remote_port客户端端口52345
$remote_user已经认证的用户名admin
$http_user_agent用户代理字符串Mozilla/5.0 (Windows NT 10.0...)
$http_referer引荐页面http://example.com/page.html
$http_x_forwarded_for代理服务器转发的原始客户端 IP 地址192.168.1.1, 172.16.0.1

4.上游和代理相关变量

变量名含义示例值
$upstream_addr上游服务器地址（IP:端口）127.0.0.1:8080
$upstream_status上游服务器返回的状态码200, 502
$upstream_response_time上游服务器响应时间（秒）0.125
$upstream_connect_time连接上游服务器所花费的时间（秒）0.050
$upstream_header_time上游服务器响应头时间（秒）0.075

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

变量名含义示例值
$request_time请求从接收到响应完成的总时间（秒）0.245
$body_bytes_sent发送给客户端的响应字节数（不含响应头）1024
$bytes_sent发送的总字节数（包含响应头）2048
$connection连接的序列号12345
$connection_requests当前连接上处理的请求数5

6.系统和环境变量

变量名含义示例值
$pid处理请求的工作进程 ID1234
$pipe表示请求是否通过管道传输p（管道），.（直接连接）
示例：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":"-"}
字段含义：

  1. time：

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

  2. request_time：

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

  3. upstream_response_time：

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

  4. remote_addr：

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

  5. remote_user：

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

  6. request：

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

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

  7. status：

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

  8. body_bytes_sent：

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

  9. http_referer：

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

  10. http_user_agent：

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

  11. http_x_forwarded_for：

    • 用于识别通过代理服务器访问的客户端的真实 IP。
    • "-"：表示没有经过代理，或没有传递该头信息。
Nginx日志配置
飞龙在天
07-17 2119
nginx日志主要有两类，分别是访问日志access_log和error_log。log_format是用来配置access_log输出日志格式的，但是error_log是不支持自定义日志格式，只支持配置日志级别。
Nginx日志格式化：自定义字段
java专栏
09-21 1044
📚 Nginx是一个高性能的HTTP服务器和反向代理服务器，它提供了强大的日志记录功能。默认情况下，Nginx会记录访问日志和错误日志，但是有时候这些默认的日志格式可能并不能完全满足我们的需求。更详细的信息：默认日志可能不包含某些我们关心的信息，比如请求的详细URL、用户代理等。分析和报告：自定义字段可以帮助我们更容易地进行日志分析和生成报告。安全性：某些自定义字段可以帮助我们检测和预防安全威胁。🛠️ 让我们一步步来，首先是如何在Nginx中自定义日志字段。在log_format。
nginx 日志，格式化，存储，按日切割
FREEDOM
03-28 3677
server {使用log_format指令定义了一个main的格式，并在access_log指令中引用了它。Win64;我们看到最终的日志记录中都对应了一个，这是因为这几个变量为空。Nginx中通过access_log和error_log指令配置访问日志和错误日志，通过log_format我们可以自定义日志格式。如果日志文件路径中使用了变量，我们可以通过指令来设置缓存，提升性能。其他的根据自己的使用场景定义。
Nginx 日志格式
最新发布
Flying_Fish_roe的博客
12-16 953
在Web服务器的管理中，日志是不可或缺的工具。Nginx作为一款高性能的Web服务器，凭借其高效的日志管理功能，能够帮助管理员实时监控服务器的健康状态、分析访问数据、排查问题等。Nginx的日志系统非常灵活，支持自定义日志格式，以满足不同业务需求。Nginx的日志系统是一个强大且灵活的工具，通过合理配置和分析日志，管理员可以深入了解服务器的运行状况、网站访问情况和潜在问题。Nginx的日志格式可以高度自定义，以满足不同的业务需求，而错误日志的及时分析则有助于及时发现并解决问题。
Nginx+Flume+Hive日志采集
@凭栏
12-29 1089
流程简介： 1.Nginx数据格式 Nginx定义日志格式: $remote_addr 客户端IP $time_local 通用日志格式下的本地时间 $status 状态码 $body_bytes_sent 发送给客户端的字节数，不包括响应头的大小 $http_user_agent 客户端浏览器信息 $http_referer 请求的referer地址。 $reques...
Nginx配置-日志格式配置
热门推荐
冰之杍的博客
05-03 1万+
Nginx配置-日志格式配置一、默认的日志格式二、我使用的日志格式三、参数说明四、测试效果 五一上线了一个小的预约程序，配置通过Nginx进行访问入口，默认的日志是没有请求时间的，因此需要配置一下，将每一次的请求的访问响应时间记录出来，备查与优化使用. 一、默认的日志格式 默认的日志格式如下(默认是注解掉的，系统也自动会使用)： #log_format main '$remote_addr - $remote_user [$time_local] "$request" ' #
Nginx的日志格式
weixin_53150440的博客
11-02 906
Nginx的日志格式：
nginx中的日志管理
u014265398的博客
01-12 378
我们观察nginx的server段,可以看到如下类似信息 #access_log logs/host.access.log main; 这说明 该server, 它的访问日志的文件是 logs/host.access.log , 使用的格式”main”格式. 除了main格式,你可以自定义其他格式. main格式是什么? #log_format main '$remote_addr -...
nginx中用JSON格式记录日志的配置示例
09-30
1. Nginx日志格式配置基础 首先，要了解Nginx的日志记录是通过其配置文件来定义的，通常位于nginx.conf中的http、server或location上下文中。Nginx使用log_format指令来定义日志格式，而access_log指令用来指定日志...
详解Nginx日志配置及日志切割
09-30
本文将对Nginx日志配置及日志切割进行详细介绍。 首先，Nginx提供了多种日志配置指令，这些指令可以定义日志记录的行为和格式。以下是两个核心的指令： 1. access_log：此指令用于开启或关闭访问日志，并设置日志...
Nginx日志管理介绍
01-10
Nginx日志描述 通过访问日志，你可以得到用户地域来源、跳转来源、使用终端、某个URL访问量等相关信息；通过错误日志，你可以得到系统某个服务或server的性能瓶颈等。因此，将日志好好利用，你可以得到很多有价值的...
【Nginx】Nginx 日志配置
Python、Golang、大数据
05-30 4465
Nginx 预定义了日志格式，如果没有明确指定日志格式将使用预定义的日志格式。如果需要修改，参考 log_format 的语法进行修改即可。name：格式名称，在 access_log 中显性引用，否则会使用默认的语法。escape：置变量中的字符编码方式是 json 还是 default ，默认是 default。stirng：要定义的日志格式内容，该参数可以有多个，参数中可以使用Nginx变量。变量含义发送给客户端的总字节数发送给客户端的字节数，不包括响应头的大小连接序列号。
nginx 日志配置
qfyangsheng的博客
09-17 1728
1、nginx 日志介绍 nginx有一个非常灵活的日志记录模式,每个级别的配置可以有各自独立的访问日志, 所需日志模块ngx_http_log_module的支持，日志格式通过log_format命令来定义，日志对于统计和排错是非常有利的，下面总结了nginx日志相关的配置 包括access_log、log_format、rewrite_log、error_log。 # 设置访问日志 access_log path [format [buffer=size] [gzip[=level...
nginx日志
05-22 128
http段中定义格式 log_format main '$remote_addr - $remote_user [$time_local] "$request" ' '$status $body_bytes_sent "$http_referer" ' '"$http_user_agent" "$http_x_f...
Nginx日志格式说明
heroicpoem的专栏
09-27 1917
默认位置在nginx安装目录下的：logs/access.log也可修改日志配置，在配置文件中：conf/nginx.conf日志格式参数：log_format日志位置参数：access_log。
nginx日志格式说明
weixin_34010566的博客
06-24 84
1、配置文件 #vim /usr/local/nginx/conf/nginx.conf log_format access '$remote_addr - $remote_user [$time_local] "$request" ' '$status $body_bytes_sent "$http_referer" ' ...
Nginx日志配置详解
"Nginx日志配置及其相关指令详解" Nginx是一个高性能的HTTP和反向代理服务器，它的日志功能对系统监控、故障排查和性能分析至关重要。本篇将详细阐述Nginx的日志配置，主要包括access_log指令、log_format指令以及...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值