Key concepts

これらの用語を確認して、AIガバナンス監査ログビューアを理解および効果的に使用します。

エアマンMCP

Airman MCPは、AIエージェントのPostgresアクセスを仲介するモデルコンテキストプロトコルMCPサーバーです。エージェントが呼び出すことができるツールとしてPostgres操作を公開し、 airman:<purpose>/<session-short> フォームのPostgres application_name 変数を介して実行されるすべてのクエリーにタグ付けするため、後でアクティビティを再構成できます。ビューアはこれらのタグに完全に依存して、エージェントアクティビティをグループ化および属性付けます。

セッション

セッションは、単一のAirman MCPインタラクション内でAIエージェントによって実行されるSQLステートメントの論理グループです。各セッションは、ビューアでの監査の主な単位です。クラスターを開くとそのセッションが表示され、セッションを開くと、それに含まれるステートメントが表示されます。

Airman MCPは、セッションショートMCPセッショントークンの最初の8つの16進文字でセッションを識別します。セッションshortを共有するすべてのログエントリは、同じセッションに属します。

ステップ

ステップは、セッション内の単一のSQLステートメント、つまり1つの解析されたPostgresログレコードです。各ステップには、 SQLテキストとその実行メタデータターゲットデータベース、Postgresロール、バックエンドプロセスID、期間、エラーの重大度が含まれます。

目的

目的は、 AIRMAN_MCP_PURPOSE 環境変数たとえば billing 、support 、またはanalytics などを介してAirman MCPインスタンスごとに構成された宣言されたインテントラベルです。これは、Airmanが各クエリーに書き込むタグの最初のセグメントとして表示され、セッションリストとセッションの詳細の両方に表示されます。目的はビューアではなくエージェント側で設定されます。

インスタンス

インスタンスは、登録された上流データソース—ハイブリッドマネージャーHM展開またはスタンドアロンのLokiエンドポイントのいずれかです。ビューアは一度に複数のインスタンスに接続し、それらのすべてからクラスターとセッションを集約できます。 Connecting data sources を参照してください。

クラスター

クラスターは、HMによって管理されるか、Lokiによって監視されるPostgresクラスターです。ビューアは、監査のエントリポイントとしてクラスターをリストします。クラスターを選択し、それに対して検出されたAIエージェントセッションを確認します。

LokiとLogQL

Lokiは、ビューアが読み取ったPostgresクエリログを保存するログ集計システムです。クエリ言語LogQLで表現されるラベルベースのクエリ用に最適化されています。 HMにはLokiパイプラインが含まれています。 Postgresログを受信するスタンドアロンのLokiインスタンスにビューアをポイントすることもできます。ビューアのバックエンドはLogQLクエリーを構成して、クラスターのセッションタグ付けのログエントリを見つけます。

同期ウォーターマーク

同期ウォーターマークは、インスタンスごと、クラスターごとのレコードで、ビューアのバックエンドがLokiからセッションデータをキャッシュした範囲を追跡します。最も古い既知のエントリーと、キャッシュがどのくらいの距離まで書き込まれているかを記録します。これにより、訪問するたびに完全なログ履歴を再照会するのではなく、高速なインクリメンタル同期が可能になります。 Architecture and data flow を参照してください。