Nginx 缓存命中率监控:从 X-Cache-Status 到实时统计

背景

上一篇配好了 Nginx 缓存,响应头里加了 X-Cache-Status,浏览器 F12 里能看到 HIT 和 MISS。

但问题来了:每次都要手动 F12,看不到整体情况。

想知道:

今天的缓存命中率是多少?

哪些请求总是 MISS?

缓存到底省了多少后端压力?

需要把 X-Cache-Status 从"单个请求可见"变成"可统计"。

原因

默认情况下,Nginx 的 $upstream_cache_status 只是一个响应头------它跟着响应发给浏览器,但不进日志。

要统计,得做两件事:

把这个变量写进 Nginx 的 access log

用脚本统计日志里的 HIT/MISS 数量

解决

第一步:定义带缓存状态的日志格式

编辑 Nginx 主配置:

bash 复制代码
sudo nano /etc/nginx/nginx.conf

在 http 块里找到 log_format 那一行,新增一个格式:

复制代码
log_format cache_log '$remote_addr - [$time_local] '
                     '"$request" $status '
                     'Cache: $upstream_cache_status '
                     'Time: $request_time';

含义:

$upstream_cache_status → 就是 HIT / MISS / BYPASS

$request_time → 请求耗时,看缓存有没有真的加速

第二步:在 dashboard 配置里启用新日志

css 复制代码
server {
    listen 8081;

    access_log /var/log/nginx/cache.log cache_log;   # 启用新日志格式

    location / {
        proxy_cache my_cache;
        add_header X-Cache-Status $upstream_cache_status;
        proxy_pass http://dashboard_cluster;
    }
}

检查 + 重启:

bash 复制代码
sudo nginx -t
sudo systemctl reload nginx

第三步:验证日志有内容

bash 复制代码
# 访问几次网站
curl -sI http://127.0.0.1:8081 > /dev/null
curl -sI http://127.0.0.1:8081 > /dev/null

# 看日志
sudo tail -5 /var/log/nginx/cache.log

预期输出:

复制代码
192.168.1.1 - [06/Oct/2026:15:30:12 +0800] "GET / HTTP/1.1" 200 Cache: MISS Time: 0.025
192.168.1.1 - [06/Oct/2026:15:30:13 +0800] "GET / HTTP/1.1" 200 Cache: HIT Time: 0.001

Time 那一列:HIT 的耗时是 MISS 的 1/20 ------ 缓存的加速效果一目了然。

第四步:写统计脚本

bash 复制代码
#!/bin/bash
# cache-stats.sh

LOG="/var/log/nginx/cache.log"

TOTAL=$(sudo grep -c "Cache:" "$LOG")
HIT=$(sudo grep -c "Cache: HIT" "$LOG")
MISS=$(sudo grep -c "Cache: MISS" "$LOG")
BYPASS=$(sudo grep -c "Cache: BYPASS" "$LOG")

if [ "$TOTAL" -eq 0 ]; then
    echo "日志为空"
    exit 0
fi

RATE=$(awk "BEGIN {printf \"%.1f\", $HIT / $TOTAL * 100}")

echo "================================"
echo "  缓存命中率统计"
echo "================================"
echo "总请求:  $TOTAL"
echo "HIT:     $HIT"
echo "MISS:    $MISS"
echo "BYPASS:  $BYPASS"
echo "命中率:  $RATE%"
echo "================================"

运行:

bash 复制代码
chmod +x cache-stats.sh
./cache-stats.sh

预期输出:

复制代码
================================
  缓存命中率统计
================================
总请求:  1250
HIT:     1032
MISS:    218
BYPASS:  0
命中率:  82.6%
================================

第五步:加到定时任务

复制代码
crontab -e

每天 8 点输出一次统计,追加到日志:

复制代码
0 8 * * * /home/YOUR_USER/cache-stats.sh >> /home/YOUR_USER/cache-stats.log 2>&1

三个坑

坑 1:忘了在 server 块里启用新日志格式

只在 http 里定义了 log_format 不够,每个 server 块要显式指定 access_log ... cache_log。不写,默认还是走 combined 格式,里面没有缓存状态。

坑 2:日志无限增长

加了新日志后,/var/log/nginx/cache.log 会一直涨。要配 logrotate:

bash 复制代码
sudo nano /etc/logrotate.d/nginx-cache

写入:

复制代码
/var/log/nginx/cache.log {
    daily
    rotate 7
    compress
    missingok
    notifempty
}

不配的话,跑几个月日志能到几十 GB。

坑 3:只看命中率不看时间

命中率 80% 听起来不错,但如果 MISS 的都是慢请求,用户体验还是很差。

要看两个维度:

命中率(HIT / TOTAL)

HIT 和 MISS 的平均耗时对比

bash 复制代码
# MISS 的平均耗时
sudo grep "Cache: MISS" /var/log/nginx/cache.log | \
  awk '{print $NF}' | awk -F: '{sum+=$2; n++} END {print sum/n}'
相关推荐
谙弆悕博士2 小时前
多智能体架构详解:层级树状架构(分级主从型)
运维·架构·大模型·agent·多智能体·langgraph·层级树状
HMS工业网络4 小时前
工业远程访问的五项安全部署原则
运维·服务器·安全
吴建旭 智宅焕5 小时前
智能家居全国交付中执行端能力评估与分级调度架构设计:从注册数量到交付确定性的系统实现
运维·智能家居·devops
IT大白鼠7 小时前
eBPF 观测入门:用 bpftrace 给服务器装上“内核摄像头“
运维·服务器·ebpf
橘色的喵7 小时前
不接 SRS,只用 Nginx 做 WebRTC 播放:架构与踩坑
nginx·webrtc·srs·rtmp
分布式存储与RustFS7 小时前
Zeppelin 笔记本重启就丢:三个环境变量把 .zpln 存进 RustFS 桶
运维·云原生·开源·对象存储·分布式存储·s3·性能基准
好用斋8 小时前
内网测速 LibreSpeed:网页版 Docker 测速服务
运维·docker·容器
江华森9 小时前
从零开始:智能运维概念与Linux环境准备完全指南
linux·运维
橙橙子23010 小时前
Linux----libevent
linux·运维·服务器
Csvn11 小时前
Nginx rewrite 与 server_name:last/break 语义、多域名匹配与伪静态
后端·nginx