nginx云原生可观测性的关键是打通其自身指标、容器运行时数据与云平台服务（如cloudwatch/stackdriver）的链路，分三步：暴露指标（启用stub_status或nginx-prometheus-exporter）、采集指标（通过适配agent或原生prometheus抓取）、可视化与告警（映射为云平台自定义指标并配置图表及告警）。
要让 Nginx 在云原生环境中真正“可观察”，关键不是单独部署一个监控工具，而是打通 Nginx 自身指标、容器/实例运行时数据、以及云平台可观测性服务（如 CloudWatch 或 Stackdriver）之间的链路。核心在于：暴露指标 → 采集指标 → 可视化与告警。
一、让 Nginx 主动输出可观测指标
Nginx 默认不暴露详细运行数据，需启用内置模块或引入导出器：
-
启用 stub_status 模块：在 nginx.conf 的 server 块中添加：
location /nginx_status { stub_status on; access_log off; }
它提供基本连接数、请求速率等，适合轻量监控。 -
使用 nginx-prometheus-exporter：这是更推荐的方式。它作为独立容器或 sidecar 运行，主动抓取 Nginx 的 stub_status 或通过 API（如 NGINX Plus）获取丰富指标（upstream 状态、缓存命中率、SSL 握手数等），并以 Prometheus 格式暴露在
/metrics路径。 -
NGINX Plus 用户：直接启用
api模块（v3+），无需额外 exporter。配置api write=off;即可安全开放指标端点。
二、对接 CloudWatch（AWS ECS/EC2 场景）
CloudWatch 本身不原生拉取 Prometheus 指标，需借助支持 Prometheus 的 CloudWatch Agent：
- 确保 CloudWatch Agent 版本 ≥ 1.247347.0，并启用
prometheus收集器。 - 在 agent 配置中设置
ecs_service_discovery：自动发现 ECS 任务中运行的 nginx-exporter 容器（按 task definition 标签或端口识别）。 - 若 exporter 运行在非标准端口（如 9113）或路径（如
/nginx/metrics），必须同步更新配置中的scrape_config对应字段。 - 指标采集后，会自动映射为 CloudWatch 自定义指标（命名空间如
ContainerInsights/Prometheus），可直接用于控制台图表或告警。
三、对接 Stackdriver（Google Cloud/GKE 场景）
Stackdriver（现为 Google Cloud Operations Suite）原生兼容 Prometheus，集成更直接：
- 在 GKE 集群中启用
cloud.google.com/stackdriver-prometheus监控功能（通过 Google Cloud Console 或 gcloud CLI）。 - 将 nginx-prometheus-exporter 部署为 Pod，并为其 Service 添加注解：
prometheus.io/scrape: "true"和prometheus.io/port: "9113"。 - Stackdriver 的 Prometheus 抓取器会自动发现带该注解的 Service，并开始拉取指标。
- 采集到的指标可在 Metrics Explorer 中按
nginx_*前缀筛选，也可创建基于这些指标的 Alerting Policies。
四、补充建议：不只是指标
完整可观测性还需结合日志与追踪：
-
访问日志直传：配置 Nginx 将
access_log输出到 stdout/stderr（容器场景）或指定文件（EC2），再由 CloudWatch Agent 或 Fluent Bit 采集并发送至 CloudWatch Logs / Cloud Logging。 -
结构化日志：用
log_format定义 JSON 格式日志，便于后续在日志服务中做字段级查询与分析。 -
错误日志级别：避免仅记录
error，适当开启warn或info级别，尤其对 upstream timeout、5xx 错误等关键路径。
