轻松监控 Nginx：观测云一体化观测方案
观测云提供开箱即用的 Nginx 监控方案：统一采集核心指标、内置可视化视图、灵活告警通知。本文介绍 Nginx 的关键监控指标、快速接入步骤与告警最佳实践。
Nginx 是承载互联网流量的主力 Web 服务器与反向代理，其连接、请求与上游状态是全站流量的第一道观测窗口。对 Nginx 进行持续监控，是保障业务稳定、快速定位故障的基础工作——观测云提供开箱即用的 Nginx 监控方案，从数据采集到可视化、告警一站式完成。
核心要点速览
- 观测云为 Nginx 提供开箱即用的采集与可视化方案，无需自建监控栈；
- 核心关注指标包括：活跃连接数与连接状态（reading/writing/waiting）、每秒请求数、握手与接受连接速率、上游响应时间与状态码（需日志/VTS） 等；
- 内置视图模板开箱即用，监控器支持阈值、突变、无数据等多种检测方式；
- 监控数据可与日志、链路、基础设施数据关联分析，加速故障定位。
为什么用观测云监控 Nginx？
Nginx 是业务稳定运行的重要一环，零散的工具难以形成有效观测。观测云的一体化平台让你用一套方案完成 Nginx 从数据采集、可视化到告警通知的完整闭环。
Nginx 核心监控指标
接入观测云后，建议重点关注以下指标：
| 指标 | 说明 |
|---|---|
| 活跃连接数与连接状态（reading/writing/waiting） | 反映并发访问压力，异常增长提示连接泄漏或攻击 |
| 每秒请求数 | 反映业务量规模，可用于审计与故障关联分析 |
| 握手与接受连接速率 | 反映业务负载与吞吐水平，可结合业务高峰评估容量 |
| 上游响应时间与状态码（需日志/VTS） | 反映响应速度，持续升高提示性能劣化或后端瓶颈 |
| worker 进程状态 | 直接反映组件健康状况，异常需立即处理 |
如何快速接入观测云？
- 安装 DataKit：在 Nginx 所在主机（或可访问它的机器）上安装 DataKit，支持 Linux/Windows/Kubernetes；
- 开启采集器：在
conf.d/目录下启用 nginx 采集器配置，填写连接地址、账号等必要参数； - 重启生效：执行
datakit service -R（或systemctl restart datakit）使配置生效； - 验证数据：登录观测云控制台，在「指标」或「基础设施」中查看 Nginx 数据是否上报；
- 启用内置视图：在「场景」中新建仪表板，直接选用 Nginx 的内置视图模板。
内置视图与告警建议
观测云为 Nginx 提供内置监控视图模板，在「场景 > 新建仪表板」中即可一键选用，无需从零搭建图表。同时建议至少配置以下告警：
- 连接数逼近 worker_connections：连接使用率超 80% 告警，防止连接被拒
- 5xx 错误率升高：结合日志统计 5xx 比例告警
常见问题（FAQ）
Q：观测云能同时采集 Nginx 访问日志吗？ 可以。开启指标采集的同时配置日志采集读取 access.log，配合 Pipeline 解析可实现状态码、URI 维度的分析与告警。
Q：开源版 Nginx 没有 stub_status 详细指标怎么办？ 开源版默认指标有限，可配合 VTS 模块暴露更细维度，或通过日志采集+Pipeline 统计补充。
Q：观测云监控 Nginx 需要安装什么？ 只需要在目标主机上安装观测云的统一采集器 DataKit，并开启对应采集器即可，无需部署多套 Agent。
Q：Nginx 的监控数据在观测云里能保留多久？ 指标与日志的保留时长取决于工作空间的数据存储策略，可按需选择不同时长的规格；如需长期留存，可通过数据转发将数据归档到对象存储。
