Prometheus Exporter 完全指南

Exporter 是 Prometheus 监控非原生系统的桥梁:把数据库、中间件、硬件的指标翻译成 Prometheus 格式。主流 Exporter 盘点、Nginx 实操、指标爆炸防护与 relabeling 技巧。

最佳实践
Prometheus Exporter 完全指南技术指南封面

很多系统并不原生暴露 Prometheus 格式的指标——MySQL、Nginx、Redis、交换机、UPS……Exporter 就是填平这个鸿沟的翻译官:它从目标系统采集数据,转成 Prometheus 标准格式,通过 HTTP 端点暴露给 Prometheus 抓取。

Exporter 的工作模型

目标系统(MySQL) → Exporter 采集并转换 → /metrics 端点 → Prometheus 定期抓取

Exporter 可作为 sidecar 或独立进程部署,位置取决于是否能访问被监控系统。Prometheus 抓取的是 exporter 的端点。应用若已通过客户端库原生暴露同类指标,可直接抓取该端点。

主流 Exporter 盘点

Exporter 监控对象
Node Exporter Linux/Unix 主机:CPU、内存、磁盘、网络
Blackbox Exporter 主动探测:HTTP/TCP/ICMP/DNS("外部视角"监控)
MySQLd Exporter MySQL:连接、查询、复制、慢查询
PostgreSQL Exporter PostgreSQL:连接、锁、复制等,具体指标取决于采集器与权限
Redis Exporter Redis:内存、命中与未命中计数、慢日志统计
NGINX Prometheus Exporter 开源 NGINX 的连接与请求数来自 stub_status,NGINX Plus 使用其 API
Kube-state-metrics K8s 对象状态:Deployment、Pod、Node
SNMP Exporter 网络设备:交换机、路由器

选型时先核对被监控软件的版本、Exporter 的维护方、权限和指标文档。官方项目也可能由软件供应商维护,例如 NGINX 的官方 Exporter。

实操:用 Exporter 监控 Nginx

这里用开源 NGINX 的 stub_status 暴露基础连接与请求计数,再由 NGINX Prometheus Exporter 1.5.1(英文) 转成指标。官方 Exporter 的开源模式读取 stub_status,NGINX Plus 模式读取 Plus API。VTS 属于第三方采集路径。

以下示例用 NGINX 1.30.6(已启用 http_stub_status_module)和同机的 Exporter 1.5.1。本地实验把两个监听地址都绑定在回环网卡。在第一个终端启动 NGINX:

LAB_DIR=$(mktemp -d)
mkdir -p "$LAB_DIR/logs"
cat > "$LAB_DIR/nginx.conf" <<'NGINX'
pid logs/nginx.pid;
events { worker_connections 128; }
http {
  access_log off;
  server {
    listen 127.0.0.1:18080;
    location = /stub_status { stub_status; }
  }
}
NGINX
nginx -p "$LAB_DIR/" -e "$LAB_DIR/logs/error.log" -c nginx.conf
curl -fsS http://127.0.0.1:18080/stub_status

在第二个终端启动 Exporter。它在前台运行:

nginx-prometheus-exporter \
  --nginx.scrape-uri=http://127.0.0.1:18080/stub_status \
  --web.listen-address=127.0.0.1:19113

Prometheus 同机运行时,可将下面的 job 合并进配置的 scrape_configs。如果 Prometheus 在容器中,需填写从该容器可达的 Exporter 地址。

scrape_configs:
  - job_name: nginx
    static_configs:
      - targets: ['127.0.0.1:19113']

执行 curl -fsS http://127.0.0.1:19113/metrics,可以看到类似这些样本:

nginx_up 1
nginx_connections_active 1
nginx_connections_handled 4
nginx_http_requests_total 4

up{job="nginx"} 是 Prometheus 生成的抓取结果,nginx_up 是 Exporter 读取 NGINX 状态的结果。前者为 1、后者为 0 时,先检查 Exporter 到 stub_status 的网络与权限。实验结束后在第二个终端按 Ctrl+C,再在第一个终端执行 nginx -p "$LAB_DIR/" -e "$LAB_DIR/logs/error.log" -c nginx.conf -s quit。部署时仅向获准的采集端开放状态与指标接口。

防指标爆炸:Exporter 的卫生管理

Exporter 默认可能暴露几百上千个指标,很多你根本用不上。基数失控会拖垮存储与查询。两种治理手段:

1. 在 Exporter 侧裁剪

多数 exporter 支持参数关闭不需要的采集模块,如 Node Exporter:

node_exporter --collector.disable-defaults \
  --collector.cpu --collector.meminfo --collector.filesystem

2. 在 Prometheus 侧用 relabeling 丢弃

scrape_configs:
  - job_name: node
    static_configs:
      - targets: ['localhost:9100']
    metric_relabel_configs:
      - source_labels: [__name__]
        regex: 'go_.*|promhttp_.*'
        action: drop

metric_relabel_configs 在抓取之后、样本入库之前执行,节省的是被丢弃样本的入库开销。Exporter 采集与网络抓取已经发生。示例只匹配 go_* 和 promhttp_*,也会影响相应的 Exporter 自监控。自动生成的 up 不走此规则。直接移除标签还可能让不同序列重名,Prometheus 不会替你聚合。 Prometheus 配置(英文)

已有 Exporter 也可以继续使用。若数据要送入观测云,在 DataKit 的 prom 采集器里配置其 /metrics 地址,先核对一个 Counter 和一个 Gauge 的值、标签及采集间隔;再检查过滤规则是否误删目标指标。这样可保留原来的 Exporter 部署,只调整后端接入。

常见问题(FAQ)

Q:Exporter 本身需要监控吗?
A:需要。用 Prometheus 的 up 检查 Exporter 端点抓取结果。再用 nginx_up、Blackbox Exporter 的 probe_success 等对应指标确认后续采集或探测是否成功。

Q:现有系统没有对应 exporter 怎么办?
A:先看系统是否能用客户端库原生埋点,或是否有兼容的社区 Exporter。Blackbox 适合外部可用性,Node Exporter 的 textfile collector 适合与机器相关的脚本输出。短生命周期的服务级批处理才适合考虑 Pushgateway(英文),并需要管理推送序列的清理。

Q:Exporter 的抓取间隔怎么定?
A:按告警要发现的变化速度、数据更新频率和抓取开销设置。可以从 30 秒开始,结合 scrape_duration_seconds 与超时检查是否合适。不同 job 可以使用不同间隔,查询窗口要覆盖足够的样本。

[1]: 观测云文档《集成》https://docs.guance.com/integrations/integration-index/
[2]: 观测云文档《DataKit Prometheus 集成》https://docs.guance.com/integrations/prom/

获取专属方案

联系我们

加入社区

微信扫码
加入官方交流群

立即体验

在线开通,按量计费,真正的云服务!

立即开始

选择观测云版本

代码托管平台