监控nginx静态文件响应时间应聚焦$request_time与$msec，通过静态路径专用日志、open_file_cache状态回传、prometheus/loki分位数分析及/probe-static接口验证，精准剥离后端影响，识别i/o与缓存真实性能。
监控 Nginx 处理静态文件的响应时间，重点不是看整体 $request_time，而是要剥离后端影响、聚焦 Nginx 本机 I/O 和缓存行为。因为静态资源不经过 upstream，$upstream_response_time 为空或为“-”，必须改用更贴合的变量和日志策略。
1. 使用 $request_time 与 $msec 精确记录请求生命周期
静态文件由 Nginx 直接读取磁盘或内存（如启用 open_file_cache），其耗时反映在 $request_time（单位：秒，含毫秒精度）。该变量从接收完整请求头开始计时，到发送完响应体结束，覆盖了文件打开、读取、发送全过程。
- 确保日志格式中显式包含该变量，例如：
log_format static_log '$remote_addr - [$time_local] "$request" $status $body_bytes_sent $request_time $msec'; -
$msec提供日志写入时刻的毫秒级时间戳，便于对齐系统指标或排查时序问题 - 避免使用
$time_local做耗时计算——它只精确到秒，无法支撑毫秒级分析
2. 区分静态路径并单独打标日志
不能把所有请求混在一条日志流里。需通过 location 匹配静态资源路径（如 /static/、.js$、.css$），并启用专用日志格式：
- 在 server 或 location 块中配置：
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff2?)$ {<br> access_log /var/log/nginx/static_access.log static_log;<br> expires 1h;<br> add_header X-Static-Hit $sent_http_content_length;<br>} - 配合
add_header回传实际返回字节数，辅助判断是否命中缓存（零字节可能表示 304） - 若启用了
open_file_cache，可添加add_header X-File-Cache $upstream_cache_status;（注意：该值对纯静态请求仍有效，显示HIT/MISS/BYPASS）
3. 接入可观测工具做分位数与趋势分析
原始日志需交由支持分位数聚合的系统处理，才能看出真实性能分布：
-
Prometheus + nginx-prometheus-exporter：启用
--enable-static-stats后，会暴露nginx_static_request_seconds直方图指标；Grafana 中用histogram_quantile(0.95, sum(rate(nginx_static_request_seconds_bucket[5m])) by (le))查看 P95 响应时间 -
Loki + Grafana：用 LogQL 提取
$request_time字段，再用quantile_over_time(0.90, {job="nginx"} |~ `GET.*\.(js|css)` | regexp `"(\d+\.\d+)"` | unwrap __error__ [5m])计算 5 分钟内 JS/CSS 请求的 P90 耗时 - 注意过滤干扰项：排除 304、499（客户端断连）、500（Nginx 内部错误）等非典型响应，聚焦 200/206
4. 主动验证缓存效果与磁盘 I/O 影响
仅靠平均值易掩盖长尾。建议结合简单接口快速验证关键路径：
- 新增测试 location：
location = /probe-static {<br> alias /usr/share/nginx/html/test.js;<br> add_header X-Req-Time $request_time;<br> add_header X-File-Cache $upstream_cache_status;<br> add_header X-Sendfile $sent_http_x_accel_redirect;<br>} - 用 curl 多次请求并观察：
curl -I http://localhost/probe-static 2>/dev/null | grep -E "(X-Req-Time|X-File-Cache)"
连续调用中若X-Req-Time从 8ms 降至 0.3ms 且X-File-Cache变为HIT，说明 open_file_cache 生效 - 对比不同文件大小（1KB vs 1MB）的
$request_time差异，可初步定位是 CPU 解析开销、磁盘读取瓶颈还是网络发送延迟
