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

Operability

檢視 hs-sql-agent 2.0.1 runtime execution metrics、database health、MCP-key usage 與 outbound deliveries。

Execution metrics Query/DML counts、success rate、sampled latency、slow-query 與 rate-limit rejections。
Database health 最近 probe 狀態、latency、failure streak、outage start 與 provider error。
MCP-key usage Requests、success/failure、last use 與 per-key rate-limit rejection rate。
Outbound delivery 檢視 webhook/SIEM delivery state,並在有權限時 retry failed/pending records。

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

OperationPermission
metrics / DB health / key usage / delivery list/runtime/operabilityview
retry delivery/runtime/operabilityedit

Retry 是明確的 operator mutation。修好 temporary network/destination problem 後可以使用,但 repeated retry 不能取代修正 invalid endpoint、secret 或 downstream service。

接下來去哪裡查