Prometheus Exporter 完全指南
Exporter 是 Prometheus 监控非原生系统的桥梁:把数据库、中间件、硬件的指标翻译成 Prometheus 格式。主流 Exporter 盘点、Nginx 实操、指标爆炸防护与 relabeling 技巧。
很多系统并不原生暴露 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/