Nginx 接口调用监控方案

Nginx 本身提供了多种方式来监控接口调用情况，以下是几种常用的监控方法：

1. 使用 Nginx 日志监控

配置访问日志

在 nginx.conf 或站点配置文件中配置详细的访问日志：

http {
    log_format main '$remote_addr - $remote_user [$time_local] "$request" '
                   '$status $body_bytes_sent "$http_referer" '
                   '"$http_user_agent" "$http_x_forwarded_for" '
                   'rt=$request_time uct="$upstream_connect_time" uht="$upstream_header_time" urt="$upstream_response_time"';

    access_log /var/log/nginx/access.log main;
}

分析日志工具

• GoAccess: 实时日志分析工具
• AWK: 自定义脚本分析
• ELK Stack: Elasticsearch + Logstash + Kibana

2. 使用 Nginx Status 模块

启用 stub_status 模块

server {
    listen 80;
    server_name localhost;

    location /nginx_status {
        stub_status on;
        access_log off;
        allow 127.0.0.1;
        deny all;
    }
}

访问 http://your-server/nginx_status 将返回类似：

Active connections: 291 
server accepts handled requests
 16630948 16630948 31070465 
Reading: 6 Writing: 179 Waiting: 106 

3. 使用 Prometheus + Grafana 监控

安装 Nginx Prometheus Exporter

# 下载并运行 exporter
wget https://github.com/nginxinc/nginx-prometheus-exporter/releases/download/v0.10.0/nginx-prometheus-exporter_0.10.0_linux_amd64.tar.gz
tar -xzf nginx-prometheus-exporter_*.tar.gz
./nginx-prometheus-exporter -nginx.scrape-uri=http://localhost/nginx_status

Prometheus 配置

scrape_configs:
  - job_name: 'nginx'
    static_configs:
      - targets: ['localhost:9113']

Grafana 仪表板

导入 Nginx 监控仪表板（如 ID 12708）

4. 使用商业监控工具

• Datadog: 提供 Nginx 集成
• New Relic: 全面的应用性能监控
• Dynatrace: AI 驱动的监控

5. 自定义监控脚本示例

#!/bin/bash

# 监控特定接口的调用情况
INTERFACE="/api/v1/user"

tail -f /var/log/nginx/access.log | grep --line-buffered "$INTERFACE" | while read line
do
    # 提取响应时间
    rt=$(echo $line | awk -F 'rt=' '{print $2}' | awk '{print $1}')

    # 记录到监控系统
    echo "$(date) - Interface: $INTERFACE, Response Time: $rt" >> /var/log/nginx/api_monitor.log

    # 如果响应时间超过阈值报警
    if (( $(echo "$rt > 1.0" | bc -l) )); then
        echo "High response time alert: $rt seconds" | mail -s "API Performance Alert" admin@example.com
    fi
done

6. 使用 OpenTelemetry 监控

配置 Nginx 与 OpenTelemetry Collector 集成，将监控数据发送到可观测性平台。

最佳实践建议

1. 对关键接口设置单独的 location 块，便于单独监控
2. 设置合理的日志轮转策略
3. 监控关键指标：请求量、响应时间、错误率、上游响应时间
4. 设置适当的告警阈值
5. 区分不同 HTTP 方法的监控（GET/POST/PUT/DELETE）

以上方案可以根据实际需求组合使用，从简单日志分析到全面的可观测性平台都可以实现 Nginx 接口调用的监控。