核心是通过$upstream_cache_status和$upstream_response_time组合，在单条日志中明确区分缓存层耗时与回源耗时，利用map条件赋值生成语义清晰、可过滤统计的cache_time和upstream_time字段。
要将缓存命中耗时与常规请求处理耗时分流记录，核心不是“分开两个日志文件”，而是**在一条日志里明确区分两类耗时来源，并确保字段语义清晰、可过滤、可统计**。Nginx 本身不提供“缓存路径耗时”和“回源路径耗时”的原生变量，但可通过组合现有变量 + 配置逻辑实现精准分流记录。
用 $upstream_response_time 区分是否回源
这是最关键的判断依据：只有发生回源（miss/expired/bypass）时，$upstream_response_time 才有实际值（即后端真实响应耗时）；而纯缓存命中（hit）时，该变量为空或为“0.000”。
- 命中缓存时：响应由 Nginx 本地磁盘/内存直接返回，不经过 upstream，所以 $upstream_response_time 通常为空字符串或 0.000（取决于版本和配置）
- 未命中需回源时：Nginx 向后端发起请求，$upstream_response_time 记录的是这次转发+接收的完整耗时
- 注意：$request_time 始终包含整个请求生命周期（含网络延迟、Nginx 处理、可能的 upstream 耗时），不能单独代表“缓存层耗时”
定义双维度耗时字段的日志格式
在 log_format 中同时保留原始耗时，并派生出“缓存层耗时”和“回源耗时”两个逻辑字段：
log_format cache_split '$remote_addr [$time_local] "$request" ' '$status $body_bytes_sent "$upstream_cache_status" ' 'req=$request_time ' 'cache=$request_time ' 'upstream=$upstream_response_time ' 'cache_hit_time=$request_time ' 'upstream_time=$upstream_response_time';
更实用的做法是用 条件赋值（需配合 map 模块）生成语义明确的字段：
- 先定义 map 判断状态：
map $upstream_cache_status $cache_layer_time { "HIT" $request_time; default "-"; } - 再定义 map 提取回源耗时：
map $upstream_cache_status $upstream_actual_time { ~^(MISS|EXPIRED|BYPASS)$ $upstream_response_time; default "-"; } - 最后在 log_format 中引用：
'cache_time=$cache_layer_time upstream_time=$upstream_actual_time'
按状态分流写入不同日志文件（可选但推荐）
如果需要物理隔离（例如归档、权限控制或对接不同监控系统），可用 if + access_log 实现条件日志：
- 在 server 或 location 块中添加：
access_log /var/log/nginx/hit.log cache_split if=$is_hit;access_log /var/log/nginx/miss.log cache_split if=$is_miss;- 配合 map 设置：
map $upstream_cache_status $is_hit { "HIT" 1; default 0; }和map $upstream_cache_status $is_miss { ~^(MISS|EXPIRED|BYPASS)$ 1; default 0; } - 注意：Nginx 的 if + access_log 是安全的（仅用于日志路由，非重写逻辑），但需确认使用的是 1.7.0+ 版本
验证与日常分析建议
记录后，用简单命令即可快速验证分流效果：
- 查命中请求耗时分布：
awk '$8 == "HIT" {print $12}' /var/log/nginx/access.log | sort -n | uniq -c（假设 cache_layer_time 是第12列） - 对比 miss 请求的 upstream_time 是否显著高于 hit 的 request_time
- 警惕 $upstream_response_time 为“-”或“0.000”的情况——这往往意味着配置未生效或请求被本地拦截（如 static location 直接 serve，未走 proxy）
- 避免把 $request_time 当作“缓存效率指标”：它受客户端网络影响大；真正反映缓存性能的是 cache_layer_time 稳定性 + upstream_time 降低幅度
