可通过Nginx内置变量与log_format定义条件日志、nginx-vts模块暴露Prometheus指标、Lua共享字典实时计数、或shell脚本解析日志四种方式实现URL调用频次统计。

可以通过 Nginx 内置变量和 log_format 配合自定义日志,再结合外部工具(如 Prometheus + nginx-vts-exporter 或简单脚本)实现对特定 URL 调用频次的实时统计。
1. 定义带条件的日志格式,只记录目标 URL
在 http 块中定义一个专用日志格式,并用 map 指令标记是否命中目标路径:
map $request_uri $is_target_url {
~^/api/v2/order/create 1;
~^/api/v2/user/profile 1;
default 0;
}
<p>log_format target_log '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent" '
'$request_time $upstream_response_time';</p><p>access_log /var/log/nginx/target_access.log target_log if=$is_target_url;
这样只有匹配正则的目标 URL 请求才会写入 target_access.log,大幅降低日志体积和后续处理压力。
2. 使用 nginx-module-vts + exporter 暴露 Prometheus 指标
若已启用 nginx-module-vts,可直接按 location 统计请求数:
- 在 server 或 location 块中为关键路径显式命名(便于聚合):
location ~ ^/api/v2/order/(create|cancel)$ {
vhost_traffic_status off; # 关闭默认统计
vhost_traffic_status_zone group=order_api;
proxy_pass https://www.php.cn/link/65b5b8d1f89bf53a5713bc3afdd83e9e;
}
- 配合 nginx-vts-exporter,Prometheus 即可采集类似
nginx_vts_http_request_total{group="order_api"}的指标,支持按秒/分/小时 rate 计算调用量。
3. 用 Nginx 变量 + stub_status 做轻量级实时计数(仅限单机)
若无需持久化、只要当前连接窗口内的粗略频次,可借助 $request_uri 和共享内存计数器(需第三方模块如 set-misc + lua-nginx-module):
lua_shared_dict url_counter 10m;
<p>location /api/v2/order/create {
access_by_lua_block {
local dict = ngx.shared.url_counter
local key = "order_create:" .. os.date("%Y%m%d%H") -- 按小时聚合
local ok, err = dict:incr(key, 1)
if not ok then
dict:set(key, 1) -- 初始化
end
}
proxy_pass <a href="https://www.php.cn/link/65b5b8d1f89bf53a5713bc3afdd83e9e">https://www.php.cn/link/65b5b8d1f89bf53a5713bc3afdd83e9e</a>;
}</p><h1>提供一个内部接口查看当前计数</h1><p>location /internal/url-stats {
internal;
content_by_lua_block {
local dict = ngx.shared.url_counter
local keys = dict:get<em>keys(0)
local res = {}
for </em>, k in ipairs(keys) do
res[k] = dict:get(k)
end
ngx.say(cjson.encode(res))
}
}
配合定时请求 /internal/url-stats,即可拿到内存级实时频次,适合调试或告警初筛。
4. 日志轮转 + 简单脚本聚合(零依赖方案)
对小流量或临时监控,可直接用 shell + awk 实时解析 access log:
- 每分钟执行一次:
#!/bin/bash
LOG="/var/log/nginx/access.log"
TARGET="/api/v2/user/profile"
MINUTE_AGO=$(date -d '1 minute ago' '+%d/%b/%Y:%H:%M')
# 统计过去一分钟该 URL 的出现次数
COUNT=$(awk -v t="$MINUTE_AGO" '$4 ~ t && $7 ~ /'"$TARGET"'/ {c++} END {print c+0}' "$LOG")
echo "$(date +%s),${COUNT}" >> /var/log/nginx/url_stats.csv
- 配合 cron 每分钟运行,生成时间序列 CSV,再用 Grafana 展示趋势图。


















