3313 字
17 分钟
监控与可观测性:Exporter 生态选型——给老软件配上 Prometheus 的翻译插头

先打个比方:Exporter 是万能翻译插头#

出国旅行时,插头制式不对,电器再好也用不了——你需要的不是换电器,而是一个转换插头。Prometheus 面对存量软件时是同样的处境:它只认一种「插头」,即 HTTP 拉取 /metrics 返回的文本 exposition format;而 MySQL 说的是 SHOW GLOBAL STATUS,Redis 说的是 INFO,交换机说的是 SNMP,物理机硬件说的是 IPMI——全是互不相通的方言。

Exporter 就是夹在中间的翻译插头:它自己连上目标软件已有的状态接口,把读到的状态翻译成 Prometheus 能懂的 /metrics 文本,挂在一个 HTTP 端口上等 Prometheus 来抓。目标软件一行代码不用改,监控就接上了。本篇把主流 Exporter 的选型讲透:每个盯什么指标、镜像从哪来、部署时有哪些坑,最后再讲清两个常被用错的东西——Pushgateway 的边界,以及「要不要自己写一个 Exporter」。

参考文档:https://prometheus.io/docs/instrumenting/exporters/

先对齐概念:什么算 Exporter,什么不算#

Prometheus 官方把接入方式分成两类。一类是应用自己埋点(instrumentation):代码里引入 client library,直接暴露 /metrics,指标语义由开发者定义,这是最理想的形态。另一类就是 Exporter:面向那些改不了代码、或者本身不是你开发的软件(数据库、中间件、硬件、操作系统),由一个独立进程做协议翻译。本系列前面写的 node_exporter 就是最典型的 Exporter——把 /proc、/sys 里的内核状态翻译成指标。

判断一个组件是不是 Exporter,看两点就够了:第一,它对上游说上游的协议(SQL、INFO 命令、SNMP、IPMI),对下游只暴露 /metrics;第二,它是无状态的翻译层,自己不存数据,抓取时才实时去问上游。所以 Exporter 挂了不会丢历史数据,只会在那段时间留下一个抓取失败的空洞,这也是排障时要先分清「Exporter 进程问题」还是「上游问题」的原因。

选型全景:逐个过一遍#

Exporter来源 / 镜像主要盯什么部署注意
mysqld_exporter官方 prom/mysqld-exporter连接数、QPS、慢查询、InnoDB 缓冲池、主从延迟必须建只读监控账号;多实例用 multi-target 模式一个进程管多台
postgres_exporter官方 prometheus-community/postgres-exporter连接与会话、事务提交/回滚、缓存命中率、复制延迟、锁等待监控账号需要 pg_monitor 角色;自定义查询用 queries.yaml 扩展
redis_exporter社区主流 oliver006/redis_exporter内存使用与碎片率、命中率、连接数、键空间、主从复制偏移支持单机/集群/哨兵;密码走环境变量注入,别写进抓取参数
mongodb_exporterPercona 版 percona/mongodb_exporter操作计数、连接、复制集状态、WiredTiger 缓存官方旧版早已停更,别用错仓库;账号需 clusterMonitor 等只读角色
snmp_exporter官方 prom/snmp-exporter交换机/路由器端口流量、错误包、光模块、UPS 与打印机状态先用 generator 把厂商 MIB 生成 snmp.yml;按 module + auth 分组抓取
ipmi_exporter社区 prometheus-community/ipmi-exporter物理机温度、风扇转速、电源状态、电压需要带外管理口(BMC)可达;本机模式也可走本地 IPMI 设备
consul_exporter官方 prom/consul-exporterConsul 集群健康、服务与检查状态场景单一,服务发现本身由 Prometheus 原生支持,多数人用不上,一句带过

几个共性的点先说在前面。第一,数据库类 Exporter 都遵循同一套路:一个专用低权限账号连上去,周期性执行状态查询。账号怎么建、给什么权,是部署里最不能省的一步,下面单独讲。第二,多数 Exporter 支持两种跑法:一个进程盯一个目标(简单,适合容器编排里做 sidecar),或者用 multi-target 模式由 Prometheus 传 target 参数,一个进程代理很多目标(省资源,但配置和排障更绕)。小规模环境优先前者,别一上来就给自己加难度。第三,Exporter 暴露的指标名和标签以它自己的版本为准,升级 Exporter 前先看 release notes——指标改名、删标签这类破坏性变更并不罕见,仪表盘和告警规则要跟着回归一遍,这一点和 Prometheus 本体的版本管理 是同一条纪律。

数据库账号:最小权限不是口号#

以 mysqld_exporter 为例,官方推荐的监控账号建法是:

CREATE USER 'exporter'@'localhost' IDENTIFIED BY '<强密码>' WITH MAX_USER_CONNECTIONS 3;
GRANT PROCESS, REPLICATION CLIENT, SELECT ON *.* TO 'exporter'@'localhost';

PROCESS 用来看连接与线程状态,REPLICATION CLIENT 用来看主从状态,SELECT 是为了能读 performance_schema 与 information_schema 里的统计表。注意它没有写权限、没有 SUPER、没有授权他人权限的能力,再加上连接数上限——这个账号就算泄露,影响面也被框住了。PostgreSQL 对应的是把监控账号加入内置的 pg_monitor 角色,MongoDB 对应 clusterMonitor 这类只读角色,思路完全一致:监控账号也是生产账号,绝不要图省事直接拿 root 或超级管理员顶上。Exporter 是常驻进程、配置里存着明文或半明文的凭据,又往往跑在相对边缘的位置,它恰恰是最容易被顺手摸到的那一环。

WARNING

给 Exporter 的账号只授「读状态」所需的最小权限:MySQL 用 PROCESS + REPLICATION CLIENT + SELECT 并限制连接数,PostgreSQL 用 pg_monitor 角色,MongoDB 用 clusterMonitor 类只读角色。用 root / 超级管理员跑 Exporter,等于把最高权限凭据散布到每台被监控机器上。

网络与硬件:snmp_exporter 和 ipmi_exporter#

这两类和数据库 Exporter 的气质不同:它们翻译的不是软件状态,而是设备协议。snmp_exporter 的关键不在部署,而在配置生成——不同厂商、不同型号的交换机 MIB 定义不同,要先用官方的 generator 工具把厂商 MIB 编译成 snmp.yml,运行时按 module 选择对应的指标集。直接拿示例配置去抓生产交换机,大概率只能拿到接口流量这种通用指标,拿不到光功率、温度这些真正值钱的厂商私有指标。

ipmi_exporter 走的是服务器的带外管理口(BMC/iDRAC/iLO),哪怕操作系统已经死透,只要 BMC 还通电联网,就能读到温度、风扇、电源的硬件状态——这是它在 整机队监控 里不可替代的位置:软件层探针全灭时,它是最后一个还能说话的。

Pushgateway:只给短命任务用#

Pushgateway 经常被误解成「另一个 Exporter」,其实它解决的是完全不同的问题:有些任务活得太短——比如一个跑三分钟的备份脚本、一个批处理作业——Prometheus 还没来得及抓,它就已经退出了,pull 模式天然抓不到。Pushgateway 允许这类短命任务在退出前把指标 push 到一个中转点,Prometheus 再从中转点拉。

边界必须划清:Pushgateway 只适合短命的批处理任务,常驻服务禁用。原因在于它推上去的指标不会随着进程死亡而消失——一个服务进程崩了,它最后 push 的「健康值 = 1」会永远躺在 Pushgateway 里,Prometheus 抓到的始终是这份僵尸数据,告警被彻底骗过去。常驻服务的存活判断必须靠 pull 模式下抓取成功与否(也就是 up 指标)来做,这是 Prometheus 模型的地基,不能用 push 去绕。另外 Pushgateway 是单点且数据只在内存里,它挂了就丢光那批指标,这也决定了它只配待在监控体系的边缘,别把关键链路压在它身上。

正确用法长这样:批处理脚本结尾把本次运行的结果推过去,并带上 grouping key 区分任务实例;推的时候用 PUT 覆盖同名分组,别用 POST 不断堆新分组把内存撑爆。任务失败时也要保证那行 push 能执行到(写在脚本的收尾逻辑里),否则你监控到的永远是「上次成功」。

顺带一提:textfile collector 不是 Exporter#

有些状态既不在数据库里、也没有现成 Exporter——比如「昨晚备份脚本到底成功没有」「证书还有几天过期」这种本机脚本才知道的事情。这类场景不用写 Exporter,node_exporter 自带的 textfile collector 就够了:脚本把结果按 exposition format 写成 .prom 文件丢进约定目录,node_exporter 抓取时顺带捎上。用法细节在 node_exporter 那一篇 里已经讲过,这里只强调定位:它是 node_exporter 的一个扩展口,不是独立组件,跨机器的、成体系的数据源还是应该走正经 Exporter。

要不要自己写一个 Exporter#

当现成 Exporter 确实不存在(自研中间件、小众设备),自己写并不难,因为 exposition format 本质上就是带约定的纯文本。门槛主要在规矩,不在代码量:

  • 优先用官方 client library:Go 的 client_golang、Python 的 prometheus_client 是最成熟的两个,其他语言也有官方或社区库,别自己手拼字符串。
  • 每组指标前要有 # HELP(说明这指标是什么)和 # TYPE(声明类型)两行,Prometheus 靠它们理解语义。
  • Counter(只增不减的计数)指标名以 _total 结尾,比如 http_requests_total;单位写进名字而不是值里,如 process_cpu_seconds_total。
  • 标签只放低基数维度(实例、接口、状态码段),把用户 ID、订单号这类高基数值塞进标签,是把 Prometheus 内存打爆的最快方式。

写之前先翻一遍官方 Exporter 列表和社区仓库,确认真的没人写过——Exporter 生态的覆盖面比大多数人以为的广,重复造轮子不如给现有项目提一个 PR。

选型四原则#

把上面所有细节收拢成四条决策规则,遇到新组件时按顺序过一遍:

  1. 先问有没有原生 /metrics:新版应用和中间件越来越多地自带 Prometheus 端点,有就直接抓,别多套一层 Exporter——少一层翻译,少一处版本耦合。
  2. 官方优先:先查 prometheus-community 与官方组织仓库;官方没有再看社区主流(star 数、更新频率、是否跟得上主程序版本);Percona 之于 MongoDB 这种「厂商维护版」也算一线选择。
  3. 版本跟主程序:Exporter 与目标软件的大版本要对得上,升级数据库时把对应 Exporter 一起排进变更单;版本错位最常见的症状不是报错,而是某些指标悄悄消失。
  4. 账号最小权限:每个 Exporter 一个专用账号,只给读状态的权,限制连接数,凭据用环境变量或文件注入而不写死在抓取配置里。

这四条里,第一条最容易被跳过。很多人装完 redis_exporter 用了半年,才发现新版 Redis 旁边早就有人用原生模块或者更轻的方案——Exporter 是给「改不了的软件」准备的退路,不是所有组件的默认入口。

排障:抓不到、缺指标、名字对不上#

Exporter 起来了,但 Prometheus 抓不到数据。 先跳过 Prometheus,直接 curl http://<exporter地址>:<端口>/metrics:能返回指标文本,问题在 Prometheus 侧的抓取配置(job 写错、网络不通、标签重写把 target 改丢了);连不上或返回错误,再去看 Exporter 自己的日志。数据库类 Exporter 还有一个 /probe 或 multi-target 端点形态,别把两种端点搞混。

Exporter 不报错,但某些指标就是没有。 十有八九是账号权限不足。很多状态查询在权限不够时不是报错,而是返回空集或直接跳过——Exporter 把「查不到」翻译成了「没有这条指标」。拿监控账号手动执行一遍它要跑的状态查询(MySQL 的 SHOW GLOBAL STATUS、PostgreSQL 的 pg_stat_* 视图),缺哪块补哪块权限,别一股脑改成全权。

升级之后仪表盘大片无数据。 基本是版本不匹配或新版改了指标名。用 curl 把新版的 /metrics 输出和旧版存档 diff 一遍,改名、删标签一眼可见;改完查询语句记得同步改告警规则。数据库侧的指标语义问题,也可以对照 数据库监控与排障 那篇一起看。

snmp_exporter 只抓到通用接口指标。 不是故障,是 snmp.yml 里缺你这台设备的厂商 module——回去用 generator 针对具体型号重新生成配置。

小结#

Exporter 的本质是一层无状态翻译:对上游说方言,对 Prometheus 只说 /metrics。选型时先确认软件有没有原生端点,再按官方优先、版本跟随、账号最小权限的顺序落地;数据库类盯紧账号授权,网络硬件类盯紧配置生成。Pushgateway 只留给短命批处理任务,常驻服务一律走 pull;本机脚本类状态交给 textfile collector。把这层翻译层选对、配稳,后面无论接多少种新组件进监控体系,Prometheus 侧的模型都不用变——这正是 Exporter 生态最大的价值。

监控与可观测性:Exporter 生态选型——给老软件配上 Prometheus 的翻译插头
https://www.anexns.cloudns.org/posts/monitoring-exporters/
作者
Anexns
发布于
2026-11-16
许可协议
CC BY-NC-SA 4.0