hs-sql-agent
2.0.3
ドキュメント 2.0.3
ドキュメントバージョン
2.0.3 最新
2.0.2 サポート中 2.0.3 最新
ドキュメント 管理

監査

管理コントロールプレーンから hs-sql-agent 2.0.2 の監査レコードを検索、集計、エクスポートし、保持ポリシーを適用します。

検索 action、result、actor、時間範囲、データベース、MCP キー、ツール、キーワードでイベントを絞り込みます。
エクスポート 専用の export 権限を使い、絞り込んだ監査データを CSV または JSON で出力します。
保持 ポリシーを確認し、dry-run で対象期間を検証してから、Archive または Purge を明示的に実行します。

監査画面は、セキュリティ活動とランタイム活動を記録するコントロールプレーン上の履歴です。主用途は調査と運用レビューであり、アプリケーションログの主ストリームとして設計されたものではありません。

監査レコードの構造

2.0.2 の監査項目には、次のフィールドが含まれる場合があります。

領域フィールド
IDActorType, ActorId, IpAddress, UserAgent
イベントEventId, Action, Target, Detail, Result, CreatedAt
リクエスト／セッションRequestId, SessionId
SQL スコープAccessKeyId, DbManagementId, DatabaseName, ToolName, Operation
実行DurationMs, ReturnedRows, AffectedRows
DML／エラーApprovalStatus, ErrorCategory, Definition

すべてのイベントが全フィールドを持つわけではありません。管理アカウントの変更、MCP SQL 実行、DML 承認イベント、ランタイム配信では、それぞれ自然に記録されるコンテキストが異なります。

監査イベントを絞り込む

GET /api/runtime/audit はページングに対応し、次のフィルターを利用できます。

  • action
  • keyword
  • from / to
  • result
  • actor
  • dbManagementId
  • accessKeyId
  • toolName

既定ではページ 1、1 ページあたり 20 件です。

日次サマリー

GET /api/runtime/audit/daily-summary は日単位の活動集計を返します。既定の対象期間は 7 日間で、個別レコードを詳しく調べる前に大きな変化を把握する用途に適しています。

エクスポート

監査データのエクスポートは、独立した認可 capability です。

操作権限
検索／サマリー／保持状態の確認/runtime/audit → view
CSV または JSON のエクスポート/runtime/audit → export
保持の dry-run／実行/runtime/audit → edit

エクスポートエンドポイントは format=csv または format=json を受け付けます。2.0.2 では、100,000 行を超えるエクスポートを無制限にダウンロードしようとせず、要求を拒否します。

保持ワークフロー

ランタイムの保持ポリシーでは、保持機能の有効／無効、日数、モード、UTC での実行時刻を確認できます。

運用時は次の順序で進めてください。

  1. 現在の保持ポリシーを確認します。
  2. dry-run エンドポイントで cutoff と対象件数を確認します。
  3. 想定したモードと件数であることを確かめます。
  4. レビュー後にだけ保持処理を実行します。

2.0.2 のランタイムで有効なモードは次のとおりです。

  • Archive — 期限切れレコードを設定済み archive path へ書き出してから、Admin データベースから削除します。
  • Purge — archive を作成せず、期限切れレコードを削除します。

AUDIT_RETENTION_DAYS=0 の場合、自動保持は無効になり、明示的な保持処理の実行も拒否されます。

監査とテレメトリは補完関係です

監査レコードは、誰が、どの統制対象リソースに対して、何を行い、どの結果になったかを確認するためのものです。メトリクスとトレースは、ランタイムの健全性や性能を把握するためのものです。これらについては 運用状態 と オブザーバビリティ を参照してください。