消息队列 / 系统课时

Prometheus 指标采集

Prometheus 指标采集

本课完成从 RabbitMQ 节点到 Prometheus 的最小采集链路:启用内置插件、验证 /metrics、配置定时抓取,并用 /metrics/detailed 获取队列级指标,在可观测性和采集开销之间取得平衡。

学习目标

  • 启用 rabbitmq_prometheus 并验证默认指标端点可访问。
  • 区分聚合指标与队列级详细指标,选择合适的抓取路径。
  • 配置 Prometheus 同时采集节点与队列指标,并完成基础验收。

启用内置 Prometheus 端点

RabbitMQ 自带 rabbitmq_prometheus 插件,不需要额外部署第三方 exporter。插件应在集群的每个节点启用,默认通过 TCP 15692 提供 Prometheus 文本格式指标;这个端口与管理界面的 15672 是两条不同的监听链路。

下面在单个节点启用插件,并确认端点能返回非空指标。生产环境应让 15692 只对监控网络开放,不要直接暴露到公网。

bash
rabbitmq-plugins enable rabbitmq_prometheus >/dev/null
curl -fsS http://127.0.0.1:15692/metrics > /tmp/rabbitmq-metrics.txt
test -s /tmp/rabbitmq-metrics.txt
echo "rabbitmq prometheus endpoint: ok"

预期输出

text
rabbitmq prometheus endpoint: ok

如果 curl 连接失败,先检查插件是否在当前节点启用,再检查 15692 的监听地址、防火墙或容器端口映射;不要先去排查 Prometheus,因为此时 RabbitMQ 自身的指标端点还没有打通。

选择节点与队列采集粒度

默认 /metrics 返回聚合指标,响应规模更稳定,适合作为节点和集群健康监控的基础入口。需要按具体队列观察 Ready、Unacked 或消费者数量时,应使用 /metrics/detailed 并明确请求所需 family;全量 /metrics/per-object 会随队列、连接和信道数量增长,在大规模环境中更容易产生序列化和网络开销。

RabbitMQ Prometheus 节点与队列指标采集链路

对队列监控,queue_coarse_metrics 已覆盖队列消息总量、Ready 和 Unacked 等粗粒度状态,queue_consumer_count 用于观察消费者数量。只请求告警真正需要的 family,通常比把所有对象指标全部抓回来更可控。

配置 Prometheus 抓取

下面用两个 scrape job 分开控制粒度和频率。节点级任务抓默认 /metrics;队列级任务抓 /metrics/detailed,只请求两个队列相关 family。示例中的主机名应解析到各 RabbitMQ 节点。

yaml
scrape_configs:
  - job_name: rabbitmq-node
    scrape_interval: 15s
    metrics_path: /metrics
    static_configs:
      - targets:
          - rabbit1:15692
          - rabbit2:15692
          - rabbit3:15692

  - job_name: rabbitmq-queue
    scrape_interval: 30s
    metrics_path: /metrics/detailed
    params:
      family:
        - queue_coarse_metrics
        - queue_consumer_count
    static_configs:
      - targets:
          - rabbit1:15692
          - rabbit2:15692
          - rabbit3:15692

这份配置生效后,Prometheus 会分别保存低成本的聚合指标和带队列标签的详细指标。队列很多时可以进一步增加 vhost 过滤,或降低详细任务抓取频率,而不是简单缩短所有采集周期。

保存为 <PATH>/prometheus.yml 后,可先做语法检查;实际路径按部署方式替换。

bash
promtool check config <PATH>/prometheus.yml

预期输出

text
Checking <PATH>/prometheus.yml
 SUCCESS: <PATH>/prometheus.yml is valid prometheus config file syntax

验证队列指标真正可用

只看到 Prometheus target 为 UP 还不够,它只能证明抓取请求成功。节点上存在业务队列时,再直接检查详细端点是否返回队列指标;其中队列名、vhost 和数值会随实际环境变化。

bash
curl -fsS 'http://127.0.0.1:15692/metrics/detailed?family=queue_coarse_metrics&family=queue_consumer_count' | grep -E '^rabbitmq_detailed_queue_(messages_ready|messages_unacked|consumers)' | head

预期输出

text
rabbitmq_detailed_queue_messages_ready{<LABELS>} <VALUE>
rabbitmq_detailed_queue_messages_unacked{<LABELS>} <VALUE>
rabbitmq_detailed_queue_consumers{<LABELS>} <VALUE>

如果这里有队列指标而 Prometheus 中没有对应时间序列,问题通常已经缩小到 Prometheus 的 target、metrics_path、params 或网络配置。反过来,如果详细端点本身没有目标队列数据,应先确认队列位于当前节点可观测范围内,并检查请求的 family 与 vhost 过滤条件。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Prometheus 指标采集

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通