OpenSearch で AI エージェントのログを検索・分析し、リクエストの監視、エラーの調査、問題のトラブルシューティング、および AI エージェントと MCP サーバー全体でのツールの実行状況の確認を行います。
始める前に
OpenSearch のダッシュボードにアクセスできることを確認してください。
このタスクについて
OpenSearch AIエージェントおよびモデルコンテキストプロトコル（MCP）サーバーからのAIエージェントログへの一元的なアクセスを提供します。 ログデータの検索、フィルタリング、エクスポートを行うことで、エージェントのアクティビティの監視、リクエスト処理の調査、問題のトラブルシューティング、およびツールの実行状況の分析を行うことができます。
AIエージェントのログは、以下の操作を行う際に役立ちます。
- AIエージェントおよびMCPサーバーからのアプリケーションログとアクセスログを表示します。
- エージェントのリクエストとレスポンスを監視します。
- エラーおよびツールの実行状況を調査する。
- トラブルシューティング、監査、およびオフライン分析のために、ログデータをエクスポートします。
手順
- OpenSearch のダッシュボードで、「 Discover」 を選択して検索画面に移動します。
- [フィルターを追加] をクリックします。
- 「 フィルターの編集 」モーダル画面の「 フィールド 」欄で、「 タイプ 」を選択します。
- [ オペレーター ] フィールドで、 いずれかを選択してください。
- [ 値] フィールドで、表 1 に示されているログタイプの中から 1 つを選択してください。
表 1. ログタイプのオプション
| ログ・タイプ |
説明 |
| ai-agent-message |
エージェントの実行中に生成されるアプリケーションメッセージ。これには、ルーティングの決定、ツールへの呼び出し、エラー、およびデバッグ出力などが含まれます。 AIエージェントサーバーから送信されました。 このログタイプには、ログを生成したエージェントを特定し、それがベースエージェントかカスタムエージェントかを判別するための「 ext_agentID 」および「 ext_agentSource 」フィールドが含まれています。 |
| ai-agent-access |
AIエージェントサーバーへの各 HTTP リクエストについて、 HTTP メソッド、リクエストの URL、およびレスポンスのステータスコードを含む1つのエントリが記録されます。 |
| ai-mcp-message |
MCPツールの実行中に生成されるアプリケーションメッセージ。これには、ツール呼び出し、エラー、およびデバッグ出力が含まれます。 MCPサーバーから送信されました。 このログタイプには、ログを生成したMCPサーバーインスタンスを特定するための「 server」 フィールドが含まれています。 |
| ai-mcp-access |
MCPサーバーへの各 HTTP リクエストについて、 HTTP メソッド、リクエストの URL、およびレスポンスのステータスコードを含む1つのエントリが記録されます。 |
- 分析したい日付の範囲を設定してください。
- オプション： 検索バーにキーワード、リクエストID、エラーメッセージ、またはその他の検索条件を入力して、検索結果を絞り込むことができます。
- オプション： フィールドセレクターで、表示したいデータフィールドを選択してください。
たとえば、次のようなフィールドが役立つかもしれません。
- タイムスタンプ
- メッセージ
- ext_requestId
- 表示された結果を確認してください。
- オプション： 検索結果をエクスポートするには、「 CSV としてダウンロード」 をクリックしてください。
次のタスク
ログを確認またはエクスポートした後、そのデータを使用して以下の操作を行うことができます。
- エージェントの実行に関する問題やリクエストの失敗について調査する。
- ツールの実行状況を分析し、エラーを特定する。
- リクエスト識別子を使用して、関連するログエントリを関連付けます。
- リクエストの件数と応答ステータスを監視します。
- エクスポートしたログデータを開発チームやサポートチームと共有し、トラブルシューティングや根本原因の分析に役立ててください。