apache的%d记录接收请求到发送响应头的微秒级耗时,不包含java应用内部处理时间;如需java真实耗时,须由应用通过x-process-time响应头传递,并用%{x-process-time}o捕获。

Apache HTTP Server 本身不直接测量 Java 应用的处理耗时,mod_log_config 记录的是 Apache 接收到请求到发送完响应头(或整个响应)所经过的时间,即 Apache 层面的请求生命周期耗时,不包含后端 Java 应用(如 Tomcat)内部处理逻辑的时间 —— 除非 Java 应用通过响应头主动传递耗时信息。
使用 %D 记录 Apache 接收请求到发送响应头的微秒级耗时
%D 是 mod_log_config 提供的内置格式符,表示从 Apache 接收到请求第一个字节开始,到发送完响应头(即 headers sent)为止所经过的微秒数(microseconds)。这是最常用、最轻量的服务器端耗时记录方式。
- 在 httpd.conf 或虚拟主机配置中添加或修改 LogFormat:
LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %D" combined_with_time
- 启用该格式记录访问日志(例如):
CustomLog logs/access_log combined_with_time
- 日志示例(末尾数字为微秒):
192.168.1.100 - - [10/Jan/2024:14:22:33 +0800] "GET /api/user?id=123 HTTP/1.1" 200 248 "-" "curl/7.68.0" 156284 → 表示约 156 ms
使用 %T 记录秒级耗时(精度较低,仅作参考)
%T 返回整秒数(向下取整),例如耗时 1.999 秒也记为 1。它适合快速粗略统计,但无法反映真实性能波动,一般不推荐用于性能分析。
- 用法类似:%T 替换 %D,日志中显示为整数秒
- 注意:%T 不是四舍五入,而是截断小数部分
若需记录 Java 应用真实处理耗时,需应用层配合
Apache 无法感知 Tomcat 或 Spring Boot 内部执行时间。要获得“Java 处理耗时”,必须由 Java 应用自身计算,并写入响应头(如 X-Process-Time: 128),再由 Apache 日志捕获该头:
- Java 端(以 Spring Boot Filter 为例)添加响应头:
response.setHeader("X-Process-Time", String.valueOf(System.currentTimeMillis() - startTime));
- Apache 配置中使用 %{X-Process-Time}o 捕获响应头值:
LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %D %{X-Process-Time}o" java_timing_log
- 注意:%{xxx}o 表示输出(output)头,对应响应头;%{xxx}i 表示输入(input)头,对应请求头
- 确保 Java 应用确实设置了该响应头,否则日志中对应位置为空或破折号(-)
注意事项与常见问题
- %D 包含网络延迟影响:如果客户端网络慢(如上传大文件),%D 会偏高,不代表服务处理慢
- 反向代理场景下需谨慎:若 Apache 前还有 Nginx 或 CDN,%D 只反映 Apache 到后端(如 Tomcat)的链路耗时,不含前置节点时间
-
启用 mod_log_config 无需额外安装,但需确认其已加载(检查 httpd.conf 中是否有
LoadModule log_config_module modules/mod_log_config.so) - 日志时间单位统一为微秒(%D)或秒(%T),分析时注意单位转换(1000000 微秒 = 1 秒)
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










