OpenClaw Prometheus 监控接入

Thu, 02 Jul 2026 23:36:17 +0800

背景链接到标题

OpenClaw 是日常使用的 AI 网关，接入飞书通道提供 AI 助手服务。之前监控体系只有节点级的 CPU/内存/磁盘告警，缺少网关本身的可观测性——不知道模型调用失败率、token 消耗趋势、会话是否异常恢复、任务队列是否堆积。

已有的监控基础设施：Prometheus + Alertmanager 部署在内网服务器，alert-transformer 负责将告警格式化后通过 OpenClaw 推送到飞书。这次要做的是把 OpenClaw 自身的指标接入同一套体系。

安装插件链接到标题

OpenClaw 官方提供了 diagnostics-prometheus 插件，通过 ClawHub 安装：

openclaw plugins install clawhub:@openclaw/diagnostics-prometheus

不过有版本兼容性问题：最新版插件要求的 pluginApi >= 2026.6.11，而部署的 OpenClaw 运行时是 2026.6.6，直接装最新版会报安装失败。查看 npm 历史版本后，锁定 2026.6.6 版本安装：

openclaw plugins install @openclaw/diagnostics-prometheus@2026.6.6

配置链接到标题

openclaw.json 需要做三个改动：

diagnostics.enabled: true — 启用诊断事件流，插件依赖此开关
plugins.allow 加入 "diagnostics-prometheus" — 显式允许加载
plugins.entries 加入 "diagnostics-prometheus": { "enabled": true }

{
  "diagnostics": {
    "enabled": true
  },
  "plugins": {
    "allow": ["diagnostics-prometheus"],
    "entries": {
      "diagnostics-prometheus": { "enabled": true }
    }
  }
}

插件注册的指标端点位于：

Gitea 可观测性：Prometheus 指标 + Loki 日志

Thu, 02 Jul 2026 23:00:00 +0800

背景链接到标题

Gitea 部署完成后，需要监控保障服务稳定性。监控三要素——指标、日志、告警——缺一不可。

现有监控基础设施已部署在监控节点：

服务	端口	说明
Prometheus	9090	指标采集 + 告警规则
Loki	3100	日志存储
Alertmanager	9093	告警路由
Alloy	12345	Docker 日志采集

Gitea 部署在应用节点，Docker Compose 运行，端口 3000（Web）+ 2222（SSH）。

开启 Gitea Metrics 链接到标题

Gitea 原生支持 Prometheus，只需在配置文件 app.ini 中追加：

[metrics]
ENABLED = true

重启后验证：

curl http://git-server:3000/metrics | head

返回的指标分三类：

业务指标：

指标	说明
`gitea_users`	用户数
`gitea_repositories`	仓库数
`gitea_issues`	Issue 数
`gitea_pull_requests`	PR 数
`gitea_accesses`	HTTP 总访问次数
`gitea_mirrors`	镜像仓库数

运行时指标：

Monitoring on OHTLY Blog

OpenClaw Prometheus 监控接入

背景 链接到标题

安装插件 链接到标题

配置 链接到标题

Gitea 可观测性：Prometheus 指标 + Loki 日志

背景 链接到标题

开启 Gitea Metrics 链接到标题

背景链接到标题

安装插件链接到标题

配置链接到标题

背景链接到标题