Operability 是理解 受治理 runtime 現在運作狀況 的 Admin surface。Audit 著重 individual security/execution event;OpenTelemetry/Prometheus 則把 telemetry 輸出到外部系統。
Execution metrics
Metrics endpoint 可以回報:
- query / DML counts;
- success / failure counts 與 success rate;
- p50 / p95 latency;
- latency sample size 與是否 sampled;
- slow-query count;
- IP rate-limit count;
- MCP-key rate-limit count。
Filter 可依 time range、database、access key、tool name 縮小範圍。
Database health
Database health item 會暴露每個 managed connection 的 operational state:
| Field | 意義 |
|---|---|
Status | 目前 health state |
LastCheckedAt | 最近 probe time |
LastSuccessAt | 最近成功 probe |
LatencyMs | 有資料時的 probe latency |
ConsecutiveFailures | 目前 failure streak |
OutageStartedAt | 已知時的 current outage start |
LastError | 最近 provider/probe error |
Health probe 由 HEALTH_PROBE_* settings 控制。若 background probe 關閉,就不能把這頁當成持續更新的 external monitoring system。
MCP-key usage
Key usage 會回報 key identity/name、last use、request count、success/failure、rate-limit count 與 rejection rate。
它適合拿來找 stale credential、異常 noisy agent、或長期撞到 limit 的 key。要調整 scope/limit 前,先看 MCP Keys。
Outbound deliveries
Runtime 會保存 configured alert/SIEM webhook 等 outbound delivery attempts。Delivery item 包含:
- category / status;
- attempt count;
- created/delivered/last-attempt time;
- latest error。
List endpoint 的 limit 預設是 100。
Retry delivery
| Operation | Permission |
|---|---|
| metrics / DB health / key usage / delivery list | /runtime/operability → view |
| retry delivery | /runtime/operability → edit |
Retry 是明確的 operator mutation。修好 temporary network/destination problem 後可以使用,但 repeated retry 不能取代修正 invalid endpoint、secret 或 downstream service。
接下來去哪裡查
- Audit — actor/action/result 與 SQL execution context。
- Security Policies — 可能造成 rejection 的 runtime limits。
- Observability — Prometheus、OTLP、traces 與 external telemetry。
- Distributed Deployment — 多節點 shared coordination。