feat: expose health probes and metrics

2026-07-19 12:49:39 +08:00
parent 6a10ddb6e5
commit 428ee50cd6
6 changed files with 27 additions and 2 deletions
@@ -62,3 +62,7 @@ Hub 原生附件預設只接受圖片、PDF、純文字與 Markdown。若要串
 ## 外部告警

 設定 `ALERT_WEBHOOK_URL` 後，Worker 會在同步重試耗盡、或簽章 Webhook 超過 7 天未收到事件時發送告警。支援 Discord incoming webhook 或 ntfy topic URL；同一事件每小時最多通知一次。
+
+## 監控指標與健康檢查
+
+`GET /api/health?probe=live` 只確認程序存活；預設的 `GET /api/health` 是 readiness 檢查，會確認 SQLite 可讀取。Prometheus 格式的 `GET /api/metrics` 提供來源、公開貼文、同步佇列、Webhook 與附件快取的聚合指標。若設定 `METRICS_TOKEN`，請以 `Authorization: Bearer <token>` 抓取。