跳至主要內容
hs-sql-agent
2.0.4
文件 2.0.4
文件 管理

運作狀態

檢視 hs-sql-agent 的執行指標、資料庫健康狀態、MCP 金鑰使用情形與外送結果。

執行指標 查看 Query/DML 數量、成功率、取樣延遲、慢查詢與速率限制拒絕次數。
資料庫健康狀態 查看最近探測結果、延遲、連續失敗次數、故障開始時間與資料庫錯誤。
MCP 金鑰使用情形 查看請求數、成功與失敗、最後使用時間,以及每把金鑰的速率限制拒絕率。
外送狀態 檢視 webhook / SIEM 外送結果,並在具備權限時重試失敗或待處理紀錄。

運作狀態頁用來了解受治理的執行階段目前是否正常運作。稽核著重單一安全或執行事件;OpenTelemetry 與 Prometheus 則把遙測資料送到外部監控系統。

執行指標

指標端點可以回報:

  • Query / DML 執行次數;
  • 成功 / 失敗次數與成功率;
  • p50 / p95 延遲;
  • 延遲樣本數,以及是否採用取樣;
  • 慢查詢次數;
  • IP 速率限制次數;
  • MCP 金鑰速率限制次數。

可依時間範圍、資料庫、access key、工具名稱縮小查詢範圍。

資料庫健康狀態

每筆資料庫健康紀錄會顯示受管理連線目前的運作狀態:

欄位意義
Status目前健康狀態
LastCheckedAt最近一次探測時間
LastSuccessAt最近一次成功探測時間
LatencyMs有資料時的探測延遲
ConsecutiveFailures目前連續失敗次數
OutageStartedAt已知時的目前故障開始時間
LastError最近一次資料庫或探測錯誤

健康探測由 HEALTH_PROBE_* 設定控制。如果背景探測關閉,就不能把這個頁面當成持續更新的外部監控系統。

MCP 金鑰使用情形

金鑰使用資料會回報金鑰識別資訊與名稱、最後使用時間、請求數、成功 / 失敗次數、速率限制次數與拒絕率。

這些資訊適合用來找出長期未使用的憑證、異常高流量的 Agent,或持續撞到限制的金鑰。要調整權限範圍或限制前,請先閱讀 MCP 金鑰

外送紀錄

執行階段會保存已設定的告警、SIEM webhook 等外送嘗試。每筆紀錄包含:

  • 類別與狀態;
  • 嘗試次數;
  • 建立、送達與最後嘗試時間;
  • 最新錯誤。

清單端點的 limit 預設為 100

重試外送

操作權限
指標 / 資料庫健康 / 金鑰使用 / 外送清單/runtime/operabilityview
重試外送/runtime/operabilityedit

重試屬於明確的管理操作。修正暫時性的網路或目的端問題後可以使用,但反覆重試不能取代修正錯誤的 endpoint、secret 或下游服務。

接下來可從哪裡繼續查

  • 稽核 — 查看 actor、action、result 與 SQL 執行上下文。
  • 安全政策 — 檢查可能造成拒絕的執行階段限制。
  • 可觀測性 — Prometheus、OTLP、traces 與外部遙測。
  • 分散式部署 — 多節點共用協調機制。