nginx静态资源流量监控需结合stub_status(连接级)、自定义日志(请求级)、prometheus exporter(指标级)及map指令(分类限流)。先启用stub_status暴露连接状态,再通过location匹配后缀+专用log_format记录静态资源详情,配合nginx-prometheus-exporter按标签聚合qps与带宽,并用map预标记$ is_static实现日志筛选与限流联动。

在 Nginx 中实现静态资源服务的访问流量监控,核心是利用其内置模块(如 ngx_http_stub_status_module、ngx_http_log_module)配合日志分析或实时指标采集工具,而非依赖外部代理或重写逻辑。重点在于区分“连接级”和“请求级”监控,并针对静态资源(如 JS、CSS、图片)做精准统计。
启用并配置 stub_status 实现基础连接状态监控
该模块提供实时的 Nginx 工作进程连接概览(活跃连接数、已接受/处理/请求总数),适合快速查看整体负载。需确保编译时包含该模块(默认通常开启),并在 server 或 location 块中暴露状态接口:
- 在配置中添加:location /nginx-status { stub_status; access_log off; allow 127.0.0.1; deny all; }
- 访问
http://your-domain/nginx-status可看到类似Active connections: 3<br>server accepts handled requests<br>123456 123456 234567
的输出 - 注意:它不区分静态/动态资源,仅反映全局连接与请求计数,适合作为健康检查入口或简单看板数据源
通过自定义日志格式精准统计静态资源流量
对静态资源(如 .js、.css、.png 等)单独打标并记录带宽消耗,是更实用的监控方式:
- 定义专用日志格式,包含请求大小(
$bytes_sent)、响应状态($status)、URI 后缀($request_uri):log_format static_log '$remote_addr - $remote_user [$time_local] "$request" $status $bytes_sent "$http_referer" "$http_user_agent" "$request_uri";' - 在匹配静态资源的 location 块中启用该日志:location ~* \.(js|css|png|jpg|gif|ico|woff2?|ttf|svg)$ { access_log /var/log/nginx/static-access.log static_log; }
- 配合
logrotate定期切分日志,避免单文件过大;后续可用awk、goaccess或 ELK 栈按后缀、IP、时间段聚合流量与请求数
使用第三方模块或 Prometheus exporter 做细粒度指标暴露
若需对接监控系统(如 Prometheus),推荐使用轻量级 exporter,避免侵入主配置:
- 部署
nginx-vts-exporter(配合nginx-module-vts)或更现代的nginx-prometheus-exporter(无需修改 Nginx 编译选项) - 后者通过解析 Nginx access log 或监听 stub_status 输出,暴露如
nginx_http_requests_total{code="200",method="GET",host="static.example.com"}等指标 - 关键配置:在 Nginx 日志中为静态资源添加唯一标识(例如在 log_format 中加入
static字段),exporter 即可按标签过滤,实现每类静态资源的 QPS、延迟、带宽 TopN 统计
结合 map 指令实现静态资源请求分类与限流联动
监控不止于观测,还可触发防护动作。用 map 提前标记静态资源请求,便于后续统一策略:
- 在 http 块中定义映射:map $request_uri $is_static {~*\.(js|css|png|jpg|gif|ico|woff2?|ttf|svg)$ "1"; default "0";}
- 在 location 或 server 块中引用:if ($is_static) { set $limit_key "$binary_remote_addr"; },再配合
limit_req控制单 IP 静态资源请求速率 - 同时可在日志中记录
$is_static,方便后续用日志分析工具快速筛选出静态资源相关异常(如 499 超时突增、高频 404 请求等)











