feat(go): add capacity health check tool

2026-07-03 19:54:29 +08:00
parent 68b729fa7b
commit 3edd7462c7
6 changed files with 349 additions and 0 deletions
--- a/docs/ops/go-service-observability.md
+++ b/docs/ops/go-service-observability.md
@@ -29,6 +29,14 @@ curl -fsS http://127.0.0.1:20214/readyz
 curl -fsS http://127.0.0.1:20200/readyz
 ```

+本机容量健康摘要：
+
+```bash
+/opt/lingniu-go-native/current/capacity-check
+```
+
+它会抓取 Gateway、History writer、Stat writer、NATS bridge、Realtime API、NATS fast writer 的本地 `/metrics`，输出 JSON。退出码 `0` 表示当前关键 backlog 和拒绝计数正常，退出码 `2` 表示存在 pending、Kafka lag、连接拒绝或 metrics 抓取失败，适合接入 cron/告警。
+
 ## Core Counters

 | Metric | Meaning |