百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术文章 > 正文

nginx 常用日志参数(nginx日志详解)

ahcoder 2025-07-03 11:50 4 浏览

Nginx 提供了多种日志参数(变量),可以用来记录请求的不同方面。

常用日志参数

  • $remote_addr: 客户端的IP地址。
  • $remote_user: 客户端用户名。
  • $time_local: 局部时间,格式为 HH:MM:SS。
  • $request: 完整的请求行,包括请求方法、URI 和 HTTP 版本。
  • $status: HTTP状态码。
  • $body_bytes_sent: 发送给客户端的响应体的字节数。
  • $request_time: 请求处理时间,单位为秒。
  • $upstream_response_time: 后端服务器响应时间,单位为秒。
  • $upstream_addr: 后端服务器的地址和端口。
  • $sent_http_x_accel_redirect: 发送给客户端的 X-Accel-Redirect 响应头的值。
  • $http_referer: 包含一个 URL,客户端从该 URL 链接到当前请求的页面。
  • $http_user_agent: 客户端浏览器的 User-Agent 字符串。
  • $http_cookie: 客户端的 Cookie 信息。
  • $host: 请求中的 Host 头部。
  • $request_uri: 不包含查询字符串的请求 URI。
  • $request_filename: 请求的文件路径。
  • $request_method: 请求方法(如 GET、POST)。
  • $scheme: HTTP 方法(如 http、https)。
  • $request_length: 请求的长度(包括请求行、请求头和请求体)。
  • $content_length: 请求体的长度。
  • $args: 与 $uri 相同,包含查询字符串。
  • $document_uri: 与 $request_uri 相同。
  • $document_root: 根目录路径。
  • $server_addr: 服务器地址。
  • $server_name: 服务器名称。
  • $server_port: 服务器端口号。
  • $server_protocol: 请求使用的协议和版本。
  • $https: 如果使用了 SSL/TLS,则为 "on"。
  • $connection: 连接序列号。
  • $connection_requests: 同一连接中的请求数。

自定义日志格式

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

access_log "access.log";

我们这里设置为json日志格式,示例代码如下:

http {
    # 定义JSON格式的日志
    log_format json '{"remote_addr": "$remote_addr", '
                     '"remote_user": "$remote_user", '
                     '"time_local": "$time_local", '
                     '"request": "$request", '
                     '"status": $status, '
                     '"body_bytes_sent": $body_bytes_sent, '
                     '"bytes_sent": $bytes_sent, '
                     '"http_referer": "$http_referer", '
                     '"http_user_agent": "$http_user_agent"}';

    # 应用日志格式到某个server块
    server {
        listen 80;
        server_name example.com;

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

        location / {
            root /usr/share/nginx/html;
            index index.html;
        }
    }
}

log_format json :定义了一个名为 json 的日志格式,其中每个字段都用JSON格式表示。

access_log :将定义的 json 格式应用到指定的访问日志文件。



body_bytes_sent 和 bytes_sent的区别

body_bytes_sent 和 bytes_sent ,它们记录了响应给客户端数据的不同部分的大小。

bytes_sent

记录的是发送给客户端的总字节数,包括HTTP头部(headers)和响应体(body)。它表示整个HTTP响应的大小,即从Nginx服务器发送到客户端的所有数据的总和。

body_bytes_sent

只记录了HTTP响应体的大小,不包括HTTP头部。它仅指实际的数据内容大小,比如网页的内容、图片、文件等。

当你需要知道实际传输的数据量时,例如为了统计下载文件的大小或计算实际传递内容的流量,通常会使用body_bytes_sent。如果你需要了解包括HTTP头部在内的全部传输数据量,例如用于网络带宽分析或评估HTTP头信息对总传输量的影响,那么应该使用bytes_sent。

假设一个HTTP响应包含100字节的头部和500字节的响应体

bytes_sent 将会是600字节(100字节的头部 + 500字节的响应体)。

body_bytes_sent 则是500字节,仅计算响应体部分。

request_time 和 upstream_time 区别

request_time:

记录的是从Nginx接收到客户端请求开始到Nginx向客户端发送完响应结束的总时间。这个参数包含了客户端请求的接收时间,Nginx处理请求的时间,包括解析请求、查找配置、生成响应等。如果请求被代理到上游服务器(如后端应用服务器),还包括等待上游服务器响应的时间。将响应数据发送回客户端的时间。这个时间可以用来评估整个请求处理周期的性能。

upstream_response_time:

记录的是从Nginx将请求转发给上游服务器开始到Nginx接收到上游服务器的完整响应为止的时间。包含Nginx将请求转发给上游服务器的时间,上游服务器处理请求并生成响应的时间。响应从上游服务器传输回Nginx的时间。这个时间可以用来评估上游服务器的响应性能,不包括Nginx自身的处理时间和客户端的网络延迟。

相关推荐

ClickHouse日志平台这样建,分分钟秒掉ELK

目前业界的日志生态,最常用的是ELK,其次就是ClickHouse,本文会演示如何使用Vector+ClickHouse来采集Nginx日志并做清洗,最终写入ClickHouse。至...

nginx打印请求头日志方法-openresty

一、前言之前想用nginx打印收到的请求的请求头,但是只找到打印请求体的,没有打印请求头的,感觉原版nginx不支持。建议如果想打印请求头,先换成openresty(本人安装的是openresty-1...

文心快码帮你解大厂面试题:如何使用shell找到access log?

【大厂面试真题】系列,带你攻克大厂面试真题,秒变offer收割机!今日问题:在8g内存的机器,能否启动一个7G堆大小的java进程?一起看看文心快码BaiduComate给出的答案吧!如果这个问题你...

Nginx奇技淫巧之:按日期自动生成日志文件

时光闹钟app开发者,请关注我,后续分享更精彩!坚持原创,共同进步!前言之前文章:Nginx奇技淫巧之:用户行为埋点数据采集实现,介绍了Nginx获取post请求body参数生成日志文件的方法。当业务...

Nginx 日志文件详解:监控与诊断利器

随着互联网技术的快速发展,Nginx已成为最受欢迎的Web服务器之一,其稳定性、高性能和灵活性备受推崇。Nginx日志文件是Nginx服务器中非常重要的组成部分,对于监控和诊断Web应...

Nginx从入门到放弃05-访问日志与日志切割

设置访问日志当我们访问nginx服务时,nginx会记录日志,nginx日志分两种,一种是访问日志,一种是错误日志,访问日志记录在”access.log”文件中,错误日志记录在”error.log”文...

nginx系列:常用利用shell统计日志

0x01:根据访问IP统计UVUV(UniqueVisitor)独立访客,统计访问某站点的用户数;IP(InternetProtocol)独立IP数,是指独立的浏览了页面的不同IP,即统计不同的I...

Linux 必须重点监控的 17 个日志文件:运维与安全必备指南

在Linux系统的日常运维与安全管理中,日志文件的重要性不言而喻。日志不仅记录着系统运行的点点滴滴,更是排查故障、发现异常、提前预警的第一手证据。作为一名系统管理员、安全工程师,甚至普通开发者,了...

nginx 常用日志参数(nginx日志详解)

Nginx提供了多种日志参数(变量),可以用来记录请求的不同方面。常用日志参数$remote_addr:客户端的IP地址。$remote_user:客户端用户名。$time_local:局部时...

GoAccess轻量nginx日志分析工具(nginx日志收集方案)

什么是GoAccessGoAccess是一款开源、实时,运行在命令行终端下的Web日志分析工具。该工具提供快速、多样的HTTP状态统计。分析结果,可以通过XShell等客户端工具查看,并...

后端实践:Nginx日志配置(超详细)(nginx日志配置文件)

作者:antwang来源:https://juejin.im/post/5aa09bb3f265da238f121b6c前言Nginx日志对于统计、系统服务排错很有用。Nginx日志主要分为两种:...

Nginx access_log 运行日志查询和配置

1.介绍当我们学会Nginx的基本配置之后,可以通过Nginx配置Service代理。管理服务器所有的http和https请求。那么接下来就需要了解Nginx的日志控制,以及相关的文档查看了。你通过...

Nginx记录用户请求Header到access log

为了统计和其它用途,经常有人需要自定义Nginx日志,把http请求中的某个字段记录到日志中,刚好在看lua+nginx的文章,第一想到的是用lua赋值来做,但是想想有点小恶心,于是Google了一番...

介绍五款Web服务器日志分析软件(web服务器日志是什么)

  每个站长必须要看的数据统计表,都是由日志分析软件统计和分析网站情况所得出的。日志分析软件是一种解析Nginx/Apache/IIS/Lighttpd和任何其他Web服务器日志文件的软件...

Nginx系列:Nginx自带后端健康检查

严格说Nginx并没有自带针对负载均衡后端节点的健康检查功能,但是可以通过默认自带的ngx_http_proxy_module模块和ngx_http_upstream_module模块中的相关指令...