本文へ移動
hs-sql-agent
2.0.3
ドキュメント 2.0.3
ドキュメント 管理

運用状態

hs-sql-agent 2.0.2 のランタイム実行メトリクス、データベースヘルス、MCP キー利用状況、外向き配信を確認します。

実行メトリクス Query/DML 件数、成功率、サンプリングされたレイテンシ、スロークエリ数、レート制限による拒否を確認します。
データベースヘルス 直近プローブの状態、レイテンシ、連続失敗回数、障害開始時刻、最新のプロバイダーエラーを確認します。
MCP キー利用状況 リクエスト数、成功/失敗、最終利用時刻、キー単位のレート制限拒否率を確認します。
外向き配信 Webhook/SIEM 配信状態を確認し、権限があれば失敗中・保留中のレコードを再試行します。

運用状態は、統制されたランタイムが今どのように動いているかを把握するための管理画面です。個々のセキュリティ/実行イベントを追う Audit や、外部システムへテレメトリを送る OpenTelemetry/Prometheus を補完します。

実行メトリクス

メトリクスエンドポイントでは次の情報を取得できます。

  • Query / DML 件数
  • 成功/失敗件数と成功率
  • p50 / p95 レイテンシ
  • レイテンシのサンプル数とサンプリング有無
  • スロークエリ件数
  • IP レート制限件数
  • MCP キーのレート制限件数

時間範囲、データベース、アクセスキー、ツール名で絞り込みできます。

データベースヘルス

各管理対象接続のヘルス項目には、次の運用状態が含まれます。

フィールド意味
Status現在のヘルス状態
LastCheckedAt最新のプローブ時刻
LastSuccessAt最新の成功プローブ
LatencyMs取得できた場合のプローブレイテンシ
ConsecutiveFailures現在の連続失敗回数
OutageStartedAt判明している場合の現在の障害開始時刻
LastError最新のプロバイダー/プローブエラー

ヘルスプローブは HEALTH_PROBE_* 設定で制御されます。バックグラウンドプローブを無効にしている場合、この画面を継続更新される外部監視システムと同じものとして扱わないでください。

MCP キー利用状況

キー利用状況には、キーの ID/名前、最終利用時刻、リクエスト数、成功/失敗、レート制限件数、レート制限拒否率が含まれます。

古くなった認証情報、想定以上に大量リクエストを出すエージェント、設定した上限へ頻繁に到達するキーの特定に利用できます。スコープや上限を変更する前に MCP キー を確認してください。

外向き配信

ランタイムは、設定済みのアラート/SIEM Webhook などの外向き配信試行を記録します。配信項目には次が含まれます。

  • カテゴリと状態
  • 試行回数
  • 作成/配信/最終試行時刻
  • 最新エラー

一覧エンドポイントの limit の既定値は 100 です。

配信を再試行する

操作権限
メトリクス/DB ヘルス/キー利用状況/配信一覧/runtime/operabilityview
配信の再試行/runtime/operabilityedit

再試行は明示的な運用操作です。一時的な宛先/ネットワーク障害を修正した後には有効ですが、無効なエンドポイント、シークレット、下流サービスを直さずに繰り返し再試行する代替手段ではありません。

次に確認する場所