核心业务接口每日独立调用量即接口维度uv,需按天聚合、按接口路径去重、限定请求方法(如post)、过滤无效请求;依赖nginx日志中$remote_addr、$time_local、$request_uri字段,通过awk或python实现精准统计。

核心业务接口的每日独立调用量,本质是“按天聚合 + 按接口路径去重 + 限定请求方法(如仅 POST)+ 过滤无效请求”的组合统计。不能只数总行数,也不能只按 IP 去重——因为同一用户可能多次调用同一接口,而我们要的是“每天每个接口被多少个不同客户端调用过”,即接口维度的 UV。
确认日志中包含必要字段
先确保 access.log 能稳定提取出三个关键信息:日期($time_local)、客户端 IP($remote_addr)、请求路径($request_uri 或从 $request 中安全切分)。推荐在 nginx.conf 的 http 块中定义明确格式:
log_format core_api '$remote_addr [$time_local] $request_method $request_uri $status';
然后在对应 server 或 location 中启用:
access_log /var/log/nginx/core_api.log core_api;
验证是否有效:运行 head -2 /var/log/nginx/core_api.log,应看到类似:
192.168.1.100 [05/Sep/2026:06:22:14 +0000] POST /api/v2/order/create 200
用 awk + sort + uniq 快速统计每日每接口独立 IP 数
假设你要统计 /api/v2/order/create 和 /api/v2/user/profile 这两个接口,且只计 POST 请求:
- 提取目标接口的 POST 请求,生成「日期 + IP + 接口」三元组:
awk '$3 == "POST" && ($4 ~ /^\/api\/v2\/order\/create$/ || $4 ~ /^\/api\/v2\/user\/profile$/) {gsub(/\[/, "", $2); d = substr($2, 1, 11); print d, $1, $4}' /var/log/nginx/core_api.log
- 对三元组去重(同一 IP 同一天调同一接口只算 1 次),再按日期和接口分组计数:
awk ' == "POST" && ( ~ /^\/api\/v2\/order\/create$/ || ~ /^\/api\/v2\/user\/profile$/) {gsub(/\[/, "", ); d = substr(, 1, 11); print d, , }' /var/log/nginx/core_api.log | sort -u | awk '{key = " " ; count[key]++} END {for (k in count) print k, count[k]}' | sort
输出示例:
05/Sep/2026 /api/v2/order/create 42
05/Sep/2026 /api/v2/user/profile 18
用 Python 做更健壮的每日接口独立调用分析
适合日志量大、需过滤异常 IP 或兼容压缩日志(.gz)的场景。核心逻辑:
- 用正则精准提取 IP(
^(\S+))和 日期(\[(\d{2}/\w{3}/\d{4})) - 用
datetime.strptime(date_str, "%d/%b/%Y")解析日期,避免月份缩写识别错误 - 用
collections.defaultdict(lambda: defaultdict(set)):外层键为 date,内层键为 uri,值为该日该接口的所有 IP 集合 - 跳过 IP 为 "-"、空或私有地址(如 127.0.0.1、10.0.0.0/8)的记录
脚本片段示意:
import re, gzip, sys
from collections import defaultdict
from datetime import datetime
ip_by_date_uri = defaultdict(lambda: defaultdict(set))
pattern = r'^(\S+) \S+ \S+ \[(\d{2}/\w{3}/\d{4}):.*?\] "(\w+) ([^"]+)" (\d+)'
for line in sys.stdin:
if line.strip():
m = re.match(pattern, line)
if m:
ip, date_str, method, uri = m.groups()[0], m.groups()[1], m.groups()[2], m.groups()[3]
if ip not in ["-", "127.0.0.1"] and method == "POST" and uri in ["/api/v2/order/create", "/api/v2/user/profile"]:
date = datetime.strptime(date_str, "%d/%b/%Y").date()
ip_by_date_uri[date][uri].add(ip)
for date in sorted(ip_by_date_uri):
for uri in ip_by_date_uri[date]:
print(f"{date}\t{uri}\t{len(ip_by_date_uri[date][uri])}")
生产环境建议:提前过滤 + 定期归档
高频核心接口若占全站流量比例小,可在 Nginx 层直接隔离日志,减少磁盘和分析开销:
- 用 map 指令标记目标 URI:
map $request_uri $is_core_api {
~^/api/v2/order/create 1;
~^/api/v2/user/profile 1;
default 0;
}
- 启用条件日志:
access_log /var/log/nginx/core_api_daily.log core_api if=$is_core_api;
再配合 logrotate 按天切割,并用定时任务(如 crontab)每天凌晨运行统计脚本,结果写入 CSV 或推送到监控系统。











