Prometheus 指标

iLink Hub 在 /metrics 端点暴露 Prometheus 格式的监控指标。

访问指标

curl http://localhost:8765/metrics

安全建议

生产环境建议通过反向代理限制 /metrics 端点只允许内网访问，防止指标数据泄露业务信息。

指标列表

以下为当前实现中实际输出的指标名（与 /metrics 文本一致）。

客户端与队列

指标名	类型	说明
ilink_hub_clients_online	Gauge	当前在线后端数量
ilink_hub_clients_total	Gauge	已注册后端总数
ilink_hub_queue_size	Gauge（带 client 标签）	每个后端当前待下发队列长度

消息与上游

指标名	类型	说明
ilink_hub_messages_dispatched_total	Counter	已尝试下发到后端队列的消息条数（含广播分支中每个目标一条）
ilink_hub_messages_dropped_total	Counter	因队列满或推送失败而丢弃的条数
ilink_hub_upstream_user_messages_total	Counter	从微信上游进入 Hub 并参与路由的消息条数（不含 message_type == 2 的 bot echo 副本）
ilink_hub_upstream_polls_ok_total	Counter	上游 getupdates 长轮询成功次数
ilink_hub_upstream_polls_err_total	Counter	上游轮询失败或错误响应次数

示例 Prometheus 配置

# prometheus.yml
scrape_configs:
  - job_name: 'ilink-hub'
    static_configs:
      - targets: ['localhost:8765']
    metrics_path: /metrics
    scrape_interval: 30s

示例 Grafana 面板查询

消息下发速率（每分钟）：

rate(ilink_hub_messages_dispatched_total[1m]) * 60

消息丢弃率（告警用）：

rate(ilink_hub_messages_dropped_total[5m]) > 0

在线客户端数量：

ilink_hub_clients_online