在 nginx 中,可以通过配置 `log_format` 并引用内置变量 `$upstream_cache_status` 来区分缓存命中与未命中的状态。该变量会输出 hit、miss、expired 或 bypass 等具体状态码,将其加入日志格式后,nginx 就会在访问日志中记录每次请求的缓存处理结果。

如何定义包含缓存状态的日志格式
要输出缓存状态,必须在 `http` 块中使用 `log_format` 指令定义一个新的日志格式,并在其中添加 `$upstream_cache_status` 变量。这个变量是 Nginx 缓存模块(proxy_cache 或 fastcgi_cache)特有的,它反映了当前请求在缓存层的状态。定义完成后,需要在 `server` 或 `location` 块中将 `access_log` 指向这个新定义的格式,这样日志文件中才会出现对应的字段。

log_format cache_log '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent" '
'cache_status=$upstream_cache_status';
server {
listen 80;
server_name example.com;
location / {
proxy_pass http://backend;
proxy_cache my_cache;
# 使用自定义的日志格式
access_log /var/log/nginx/cache_access.log cache_log;
}
}
上述配置定义了名为 cache_log 的格式,其中包含了标准的 HTTP 请求信息以及 cache_status 字段。当 Nginx 处理请求时,如果缓存中存在有效数据且未过期,该字段将显示为 HIT;如果缓存中没有数据或数据已失效需要回源,则显示为 MISS 或 EXPIRED。通过这种方式,运维人员可以清晰地看到哪些请求直接由缓存响应,哪些请求触发了后端服务调用。
不同缓存状态对性能监控的影响
在实际运行中,缓存状态不仅用于记录,还直接影响服务器的负载和响应时间。HIT 状态的请求通常响应极快且不消耗后端资源,而 MISS 状态的请求则需要经过完整的网络往返和后端处理。通过分析日志中这两种状态的比例,可以评估缓存策略的有效性。例如,如果 MISS 比例过高,可能意味着缓存过期时间设置过短,或者缓存键设计不合理导致命中率低。

# 假设日志文件内容如下:
# 192.168.1.1 - - [01/Jan/2023:00:00:01 +0000] "GET /index.html HTTP/1.1" 200 1024 "-" "Mozilla/5.0" cache_status=HIT
# 192.168.1.2 - - [01/Jan/2023:00:00:02 +0000] "GET /api/data HTTP/1.1" 200 512 "-" "curl/7.68" cache_status=MISS
# 使用 awk 统计命中率
awk '{if ($NF == "HIT") hit++; else miss++} END {print "Hits:", hit, "Misses:", miss}' /var/log/nginx/cache_access.log
通过简单的脚本分析日志,可以量化缓存的效果。在上述代码示例中,我们展示了如何从日志中提取最后一列(即 cache_status 的值)并进行统计。这种监控方式有助于及时发现缓存失效问题,比如当大量请求突然变为 MISS 时,可能是由于缓存预热不足或后端更新了缓存键导致的。此外,BYPASS 状态表示请求绕过了缓存,这通常发生在用户登录或特定查询参数下,了解这些情况有助于优化动态内容的缓存策略。
缓存未命中时的调试与优化建议
当发现日志中 MISS 或 EXPIRED 状态频繁出现时,需要检查缓存的配置参数。常见的优化手段包括调整 proxy_cache_valid 指令来延长缓存时间,或者使用 proxy_cache_key 确保缓存键的准确性。此外,对于动态内容,可以考虑使用 proxy_no_cache 和 proxy_cache_bypass 指令来控制特定条件下的缓存行为,避免不必要的回源请求。











