Nginx 用 map 块对 $request_time 分级映射为日志等级变量，结合 if=变量名 控制 access_log 分流至 slow.log（buffer=64k/flush=1s）、sample.log（buffer=128k/flush=5s）或跳过；后端异步接入 Kafka/Filebeat，支持按 status、trace_id 等多维扩展。

用 Nginx 的 map 块实现请求耗时分级日志采样，核心是把 $request_time 映射成不同日志等级变量，再配合条件化 access_log 指令分流写入，从而在不改动业务、不引入额外组件的前提下完成异步化采样与存储优化。

构造耗时分级映射规则

利用正则匹配对请求耗时做区间划分，避免 Nginx 不支持数值比较的限制：

• 0.000–0.599 秒 → 抽样记录：~^[0-9]*\.[0-5][0-9]{2}$（开头匹配，防误判如 10.5 被当成 0.5）
• 0.600–0.999 秒 → 全量记录：~^[0-9]*\.[6-9][0-9]{2}$
• ≥1.000 秒 → 全量记录：~^[1-9][0-9]*\.[0-9]{3}$
• 默认值设为 skip，表示不记录该请求日志

绑定多路日志输出路径

Nginx 不允许在 if 块中使用 access_log，但支持通过 if=变量名 控制某条日志指令是否生效：

• 全量日志走 /var/log/nginx/slow.log，启用 buffer=64k flush=1s，兼顾实时性与 I/O 效率
• 抽样日志走 /var/log/nginx/sample.log，可设更大 buffer（如 buffer=128k）和更长 flush（如 flush=5s），降低磁盘刷写频次
• 跳过日志无需显式配置，或指向 /dev/null 占位，避免空行干扰

配合后端异步采集提升整体吞吐

前端 Nginx 分级采样只是第一步，后端日志消费也需异步化：

• 将 slow.log 接入高可靠通道（如 Kafka 或 Pulsar），供实时监控与告警系统消费
• 将 sample.log 交由轻量采集器（如 Filebeat + Logstash pipeline）做结构化清洗后入库
• 若使用 ELK 架构，建议对 slow 日志开启索引生命周期管理（ILM），按小时滚动+冷热分离

扩展建议：按场景叠加更多维度

单一耗时维度不够时，可组合其他变量增强策略灵活性：

• 结合 $status：对 5xx 响应强制全量，无论耗时多低
• 结合 $http_x_trace_id：对带链路 ID 的请求固定采样，保障追踪完整性
• 新增 debug 级别：对 >5s 请求单独映射为 debug，写入 /var/log/nginx/debug.log 并触发告警