如何利用 Nginx 变量自定义业务监控点：统计特定 URL 的调用频次-Nginx-PHP中文网

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

如何利用 nginx 变量自定义业务监控点：统计特定 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;
</p>

这样只有匹配正则的目标 URL 请求才会写入 target_access.log，大幅降低日志体积和后续处理压力。

2. 使用 nginx-module-vts + exporter 暴露 Prometheus 指标

若已启用 nginx-module-vts，可直接按 location 统计请求数：

Nginx Config Linter

对 Nginx 配置文件进行语法检查、验证和安全、性能审计。

下载

在 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))
}
}
</p>

配合定时请求 /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 展示趋势图。