关键在于解耦采集、统一传输、分层存储、联动告警:nginx仅负责流量转发与结构化日志输出;filebeat采集推送至kafka;vts模块+exporter+prometheus实现指标监控;keepalived保障高可用;loki+alertmanager实现日志告警联动。

构建高可用架构下的企业级 Nginx 统一日志与监控平台,关键在于解耦采集、统一传输、分层存储、联动告警,而不是把所有功能堆在一台 Nginx 上。核心思路是:Nginx 本身只专注流量转发和轻量日志输出,日志与监控能力由外围专业组件承担。
一、统一流量日志采集:结构化 + 集中推送
Nginx 不直接做分析,但必须输出可解析的结构化日志:
- 在
http块中定义 JSON 格式日志,包含真实 IP、上游响应时间、状态码、URI、User-Agent 等关键字段,例如:log_format json_analytics escape=json '{ "time": "$time_iso8601", "remote_addr": "$remote_addr", "real_ip": "$http_x_real_ip", "upstream_time": "$upstream_response_time", "status": "$status", "uri": "$uri", "user_agent": "$http_user_agent" }'; - 将该格式应用到
access_log,并确保日志轮转(logrotate)配置合理,避免磁盘打满 - 用
Filebeat(非 rsyslog 或自写脚本)实时采集日志文件,启用multiline和json解析器,自动提取字段,直推 Kafka
二、高性能运行指标监控:VTS + Exporter + Prometheus
基础 stub_status 远远不够,需启用 nginx-module-vts 模块获取细粒度指标:
- 编译或安装带 VTS 模块的 Nginx(开源版需手动集成),开启
vhost_traffic_status_zone和vhost_traffic_status_display - 部署
nginx-vts-exporter(Go 编写),通过 HTTP 轮询/status/format/json接口,转换为 Prometheus 标准 metrics(如nginx_server_connections_accepted_total、nginx_upstream_requests_total) - Prometheus 定期抓取 exporter 的
/metrics端点;Grafana 中使用预置 Dashboard(如 ID 2949)可视化 QPS、P99 延迟、上游失败率、缓存命中率等
三、高可用保障:Nginx 自身不能单点
监控再强,Nginx 实例挂了就全失效。必须做双机或多节点热备:
- 部署至少两台 Nginx 服务器(主+备或双主),配置相同 upstream 和 proxy 规则
- 用
Keepalived管理虚拟 IP(VIP),通过 VRRP 心跳检测存活;同时用vrrp_script脚本检查 Nginx 进程和端口连通性(如 curl -f http://127.0.0.1/health),失败则降权触发 VIP 切换 - 注意:不要依赖 Nginx Plus 的商业 HA 包;开源方案中 Keepalived + 自检脚本已足够稳定,某金融客户实测故障切换平均
四、日志与监控联动:从“看到”到“知道为什么”
真正的企业级能力体现在关联分析:
- Kafka 中的日志流与 Prometheus 中的指标流,通过共同字段(如
request_id或时间窗口)在 Elasticsearch 或 Grafana Loki 中交叉查询 - 当 Prometheus 告警触发“上游 5xx 率突增 > 5%”,可立即在 Loki 中搜索同一时段的 error 日志,定位具体后端服务及错误堆栈
- Alertmanager 配置分级路由:Nginx 层面的严重告警(如 VIP 失效、连接数超限)走短信+电话;普通性能波动仅发企业微信











