Connecting data sources

Connecting data sources#

1つ以上の上流データソースを登録して、監査ログビューアでAIエージェントセッションを利用できるようにします。インスタンスは、登録されたアップストリームデータソースです。EDB Hybrid ManagerHM展開またはスタンドアロンのGrafana Lokiエンドポイントのいずれかです。ビューアは同時にマルチプルのインスタンスに接続し、それらすべてのクラスターとセッションを集約できます。アクセスキーを含むインスタンス構成はサーバーサイドに保存され、ブラウザーに送信されることはありません。

Configure ページでインスタンスを管理し、ホームページの Configure Instances ボタンまたはヘッダーの Settings → Configure Instances からアクセスします。

インスタンスタイプ#

Type

Description

Authentication

Discovery

HM

EDB Hybrid Managerデータプレーン

Machine user API key, sent in the x-access-key header

Auto-discovers projects and clusters

Loki

ダイレクトLokiログストア

Optional Authorization header

Creates a single stub project and cluster automatically

HMインスタンスの追加#

  1. Configure Instances ページを開きます。

  2. Add New を選択します。

  3. フォームに入力します。

  • Type — HM.

  • Name — 説明的なラベル、例、Production EU .

  • Base URL — HM APIエンドポイント、例、https://hm.example.com:8443 .

  • Access Key — マシンユーザーAPIキー。これらのキーは通常、hmak_ またはbaak_ で始まります。

  1. Add Instance を選択します。

成功すると、ビューアのバックエンドはHMインスタンスからプロジェクトとクラスターを検出し、これらのクラスターは数秒以内にホームページに表示されます。

HMインスタンスがセッションデータを表示するための要件#

HMインスタンスがAIエージェントセッションを表面化する場合、以下が満たされる必要があります。

  • Postgresステートメントロギングは、ターゲットクラスターlog_statement = 'all' またはlog_min_duration_statement = 0 で有効になっています。

  • クラスターは、ビューアのバックエンドからネットワークを介して到達可能です。

  • AIエージェントワークロードは、トレースを有効にしてAirman MCPを介して実行されるため、アクティビティがタグ付けされて検出可能になります。

HM管理ポータルでマシンユーザーAPIキーを作成します。ビューアはそれをサーバーサイドに保存し、ブラウザーに返すことはありません。資格情報の処理の詳細については、 Securing access and handling credentials を参照してください。

Lokiインスタンスの追加#

  1. Configure Instances ページを開きます。

  2. Add New を選択します。

  • Type — Loki.

  • Name — 説明的なラベル、例、Dev Loki .

  • Base URL — Loki HTTPエンドポイント、例、http://loki.internal:3100 .

  • Authorization — オプショナル。ベアラートークンまたはその他の承認ヘッダー値Lokiエンドポイントが必要とする場合。

  1. Add Instance を選択します。

Lokiインスタンスの場合、ビューアは単一のスタブプロジェクトとクラスターを作成し、すべてのLokiセッションがその下に表示されます。

インスタンスの削除#

Configure ページの各インスタンス行には、 Delete ボタンがあります。それを選択すると、確認のポップオーバーが表示されます。確認時に、ビューアはインスタンスレコード、そのキャッシュされたセッションデータ、および同期ウォーターマークを削除します。

削除は元に戻せません。インスタンスを再追加するには、上流からの履歴を再同期する必要があります。

インスタンスの再同期#

バックエンドは、高速な取得のためにセッション概要をキャッシュします。上流データが修正またはバックフィルされたとき、キャッシュが一貫していないように見えるとき、またはキャッシュデータベースが失われたときに、完全な再同期を強制します。

  1. Configure ページで、インスタンス行を見つけます。

  2. Resync ボタン 同期アイコンを選択します。

  3. バックエンドはインスタンスのキャッシュデータをクリアし、完全なバックグラウンド同期を開始します。

インスタンスは、その同期ステータスを Syncing スピナー付き、 Done セッションカウント付き、または Error メッセージ付きとして示します。再同期はバックグラウンドで実行されるため、完了している間ビューアの使用を継続できます。同期の仕組みの詳細については、 Architecture and data flow を参照してください。

注釈

**Resync**ボタンは、開発者ツールが有効になっている場合にのみ表示されます。それ以外の場合、バックエンドは、クラスターへの最初のアクセスに自動的に同期します。

目次