Nginx 访问日志:如何记录请求到达服务器的时间戳

阿丽大大_1628

阿丽大大_1628

2026-06-05

474人浏览

原创

nginx中记录请求抵达时间最准确的变量是$time_iso8601或$time_local,二者均在请求头解析完成后赋值,标志请求已完整抵达;$msec提供毫秒级精度,可配合使用;而$request_time等为耗时变量,非时间点。

nginx 访问日志:如何记录请求到达服务器的时间戳

Nginx 默认访问日志中的 $time_local 记录的是日志写入时的时间,不是请求真正到达服务器的时刻。若需精确记录请求抵达时间(例如用于排查网络延迟、首字节耗时分析),应使用 $msec 或更准确的 $request_time 配合自定义日志格式,但要注意:真正反映“请求到达瞬间”的变量是 $time_iso8601 或 $time_local —— 它们在 Nginx 接收到完整请求头后即被赋值,实际已足够贴近抵达时刻;而更严格的“内核接收时间”无法直接获取,Nginx 层面能用的最准指标仍是请求开始处理时的时间。

使用 $time_iso8601 或 $time_local 记录请求起始时间

这两个变量在 Nginx 解析完请求行和请求头后立即生成,可视为请求已完整抵达并准备处理的标志,实践中广泛用于衡量服务端响应延迟起点。

  • $time_local:格式如 24/Jul/2024:10:32:15 +0800,适合人工阅读
  • $time_iso8601:格式如 2024-07-24T10:32:15+08:00,便于程序解析和时序对齐
  • 二者均在 accept() → read request header 完成后确定,不包含后续 upstream 耗时或响应发送时间

补充毫秒级精度:添加 $msec

$msec 是 Unix 时间戳带毫秒的小数形式(如 1721788335.123),精度更高,适合做性能统计或与后端日志对齐。

  • 它与 $time_local 同步生成,只是数值表达方式不同
  • 可在 log_format 中组合使用,例如:log_format main '$time_iso8601 [$msec] $remote_addr - $request';
  • 注意:该值不是请求处理耗时,而是请求开始处理时的绝对时间点

避免混淆:$request_time 和 $upstream_response_time 不是抵达时间

这两个变量反映的是耗时,不是时间点:

Nginx Config Linter
Nginx Config Linter

对 Nginx 配置文件进行语法检查、验证和安全、性能审计。

下载
  • $request_time:从接收到第一个字节到发送完最后一个响应字节的总耗时(单位:秒,精度毫秒)
  • $upstream_response_time:Nginx 等待后端返回响应的时间(可能多个值,用逗号分隔)
  • 它们必须配合起始时间(如 $time_iso8601)才能推算出请求完成时刻

配置示例:记录高精度抵达时间

在 http 块中定义日志格式:

log_format detailed '$time_iso8601|$msec|$request_time|$upstream_response_time|$status|$request';
access_log /var/log/nginx/access.log detailed;

重启 Nginx 后,日志类似:

2024-07-24T10:32:15+08:00|1721788335.123|0.042|0.041|200|GET /api/user HTTP/1.1

其中第一列即请求抵达并开始处理的时间点,第二列提供毫秒级对齐能力。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

nginx

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
服务器是什么
服务器是什么

服务器是一种计算机硬件设备或软件程序,它具有强大的计算和存储能力,用请求、存储数据和提供服务。它在互联网中着关重要的作用,为用户提供各种服务和资源。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.15

437

5

连接apple id服务器时出错
连接apple id服务器时出错

连接apple id服务器时出错的原因包括网络连接问题、服务器问题、Apple ID账户问题、设备问题、防火墙或安全软件问题、时间和日期设置问题、Apple服务器维护等。本专题为大家提供apple id相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.08

880

5

搭建互联网服务器
搭建互联网服务器

搭建互联网服务器需要:1、选择合适的硬件和操作系统,第一步是选择合适的硬件和操作系统;2、安装和配置操作系统,是搭建互联网服务器的关键步骤;3、安装和配置服务器软件,是搭建互联网服务器的下一步,常见的服务器软件包括Apache、Nginx、Tomcat等;4、配置防火墙和安全性,是搭建互联网服务器的重要步骤;5、域名解析和配置,是搭建互联网服务器的最后一步。

2023.09.19

2672

5

如何查看服务器状态
如何查看服务器状态

查看服务器状态的方法有使用命令行工具、图形界面工具、监控工具、日志文件和远程管理工具等。本专题为大家提供服务器状态相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.09

896

5

服务器域名转接慢怎么解决
服务器域名转接慢怎么解决

服务器域名转接慢的解决办法有DNS优化、服务器优化、CDN加速、前端优化和网络优化等。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.17

809

5

服务器评测软件
服务器评测软件

服务器评测软件有PassMark Software、CPU-Z、GPU-Z、CrystalDiskMark、IOmeter、JMeter、LoadRunner、Apache Bench等等。详细介绍:1、PassMark Software是一款综合性的服务器性能测试软件,可以评估服务器在各种负载条件下的性能;2、CPU-Z是一款可以提供服务器CPU详细信息的软件等等。

2023.10.17

414

3

如何开启TFTP服务器
如何开启TFTP服务器

开启TFTP服务器的步骤包括选择TFTP服务器软件、下载和安装软件、配置TFTP服务器以及启动和测试服务器等。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.18

2416

4

服务器负载不兼容怎么解决
服务器负载不兼容怎么解决

解决方法:1、增加服务器资源;2、负载均衡;3、优化应用程序;4、增加缓存机制;5、分布式架构;6、限流和熔断;7、自动化扩容。想知道更详细服务器负载不兼容的解决方法,可以访问本专题下面的文章。

2023.10.20

4472

4

宽带如何接入服务器
宽带如何接入服务器

宽带接入服务器的方法有ADSL宽带接入服务器、光纤接入服务器、无线接入服务器和以太网接入服务器等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.20

727

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

nginx手册
nginx手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习