LoongCollector の input_agentsight プラグインは、AI エージェントと大規模言語モデル (LLM) 間のやり取りに関する可観測性ログを収集します。このプラグインは eBPF を使用して、コードを変更せずにシステムレベルでエージェントプロセスを観測し、エージェントと LLM 間でやり取りされるリクエスト、レスポンス、トークン使用量、ツール定義などのデータをキャプチャします。サポートしている LLM プロバイダーには OpenAI、Anthropic、DashScope が含まれます。このトピックでは、Simple Log Service コンソールで LoongCollector の収集設定を作成し、AgentSight ログを収集する方法について説明します。
前提条件
サーバー OS のカーネルバージョンが Linux 5.10 以降であること。
このプラグインはシステムレベルの観測に eBPF を使用します。5.10 より前のカーネルは必要な eBPF 機能をサポートしていないため、収集を実行できません。
動作確認済みの環境は次のとおりです:
Alibaba Cloud Linux 3
Ubuntu 22.04
Ubuntu 24.04
次のコマンドを実行して、現在のカーネルバージョンを確認します:
uname -rサーバーに LoongCollector v3.3.9 以降がインストールされていること。
AgentSight の収集機能には、LoongCollector の新しいバージョンが必要です。このプラグインを設定する前に、最新バージョンにアップグレードしてください。
対象の AI エージェント (OpenClaw や Hermes など) がサーバーにデプロイされ、実行中であること。
ACK コンテナ環境:Container Service for Kubernetes (ACK) クラスター内のエージェント Pod から LLM ログを収集するには、次の要件を満たしていることを確認してください:
LoongCollector を v3.3.10 以降にアップグレードしていること。
ACK コンソールの[コンポーネント管理]ページで、
enableEBPFスイッチが有効になっています。
これらの要件を満たした後、Simple Log Service で AgentSight の Logtail 収集設定を作成して、エージェントの LLM ログを収集できます。この設定は、ほかの LoongCollector 設定と同じマシングループに適用されます。
仕組み
従来のアプリケーションインストルメンテーションでは、AI エージェントの迅速なイテレーションと高度にカスタマイズされた性質に対応できず、ツール呼び出しチェーンをトレースして実際のエージェントの動作を特定することもできません。input_agentsight プラグインは、eBPF を通じてカーネルレベルで SSL/TLS プローブとプロセスオブザーバーをアタッチし、エージェントプロセスと LLM サービス間の TLS で暗号化されたリクエストとレスポンスを取得します。これにより、エージェントのコードを変更することなく、エンドツーエンドの可観測性を実現します。
機能
AI エージェントと LLM 間の完全なインタラクションデータを収集します:リクエストメッセージ、レスポンスメッセージ、モデル名、トークン使用量、レイテンシー、ステータスコードなど。
一般的な LLM API ドメインが組み込まれたドメインホワイトリストに基づき、LLM API にアクセスするプロセスを特定します。
サポートする LLM プロバイダー
プロバイダー / プロトコル | サポート |
OpenAI | はい |
Anthropic | はい |
DashScope | はい |
サポートされているペイロードプロトコルについては、プラグインは標準の OTel GenAI フィールド (gen_ai.* など) を出力します。未対応のプロトコルについては、プラグインはサーバーサイドでの適応のために、非機密化された生のペイロードを報告します。
サポートする AI エージェントの例
カテゴリ | 例 |
一般的なエージェント | Claude Code、OpenClaw、QwenPaw、Hermes |
一般的な LLM フレームワーク | LangChain、LangGraph、Dify、AgentScope |
カスタムエージェント | Python ベースのカスタムエージェント、Node.js ベースのカスタムエージェント |
操作手順
Simple Log Service コンソールにログインします。
[Data Import] セクションで、LoongCollector の収集設定エントリを選択し、対象の [Project] と [Logstore] を選択します。
[Machine Group Configuration] ページで、対象のマシングループを設定して適用します。
重要マシングループを作成した直後に適用すると、接続がまだ有効になっていないため、ハートビートステータスが FAIL と表示される場合があります。[Automatic Retry] をクリックして、この問題を解決してください。
[データソース設定] タブで、[設定名] を指定し、プラグイン設定を入力します。 プラグインタイプは
input_agentsightに固定されています。シナリオに応じて設定パターンを選択します:
エージェントと LLM プロバイダーが組み込みのデフォルトで対応している場合は、最小構成を使用します。
エージェントがデフォルト以外の LLM エンドポイントに接続する場合は、カスタムドメインホワイトリストを使用します。
エージェントプロセスが組み込みルールに一致しない場合は、カスタムコマンドラインホワイトリストを使用します。
AgentSight が GenAI セマンティクスに解析できないトラフィックを確認する必要がある場合は、RAW HTTP トラフィックのレポートを使用します。
最小構成
最小構成:プラグインタイプのみを指定します。すべての設定にデフォルト値が使用されます (組み込みのデフォルトのコマンドラインホワイトリストとドメインリストが適用されます)。
{ "inputs": [ { "type": "input_agentsight" } ] }カスタムドメインホワイトリスト:監視するカスタム HTTPS ドメインを指定します。
{ "inputs": [ { "detail": { "ProbeConfig": { "Https": [ "api.openai.com", "api.anthropic.com", "dashscope-intl.aliyuncs.com", "dashscope.aliyuncs.com" ] } }, "type": "input_agentsight" } ] }カスタムコマンドラインホワイトリスト:プロセスのコマンドラインで対象のエージェントをフィルタリングし、そのタイプをタグ付けします。
{ "inputs": [ { "detail": { "ProbeConfig": { "CmdlineWhitelist": [ { "AgentType": "openclaw", "Args": ["node*", "*openclaw*"] }, { "AgentType": "claude-code", "Args": ["node*", "*claude*"] } ] } }, "type": "input_agentsight" } ] }未知のプロトコルを raw HTTP トラフィックとして報告する:
ProbeConfig.RawHttpsFallbackを有効にすると、AgentSight が GenAI セマンティクス (未知の API パスや非標準のボディ) に解析できないトラフィックは破棄されずに、raw HTTP トラフィックとして報告されるようになります。raw HTTP イベントのフィールドインデックスを作成し、LogStore のクエリおよび分析機能を使用してそれらを調査してください。{ "inputs": [ { "detail": { "ProbeConfig": { "RawHttpsFallback": true } }, "type": "input_agentsight" } ] }説明次の動作に注意してください:
RawHttpsFallback: trueによって生成される Raw HTTP ログは、AgentSight がトラフィックを GenAI セマンティクスに解釈できない場合にのみ生成されます。これらはgen_ai.*ログとは相互に排他的です。つまり、1 つのリクエストで生成されるのは、2 種類のうち最大で 1 つです。Raw HTTP トラフィックは、
event.name=http.requestおよびevent.name=http.responseというイベント名で報告されます。この機能は LoongCollector v3.3.10 以降でのみサポートされます。
インデックスを作成してデータをプレビューします。収集したフィールドに基づいてフィールドインデックスを手動で作成するか、[Auto Generate Index] をクリックします。
設定が完了したら、インデックスが有効になるまで約 1 分待ちます。その後、Logstore のクエリと分析ページで収集したログを確認できます。
gen_ai.agent.type、gen_ai.model.request、gen_ai.model.responseなどのフィールドを含むログエントリが表示されます。これらのフィールドが存在することで、収集が正常に動作していることが確認されます。
設定パラメータ
パラメータ | タイプ | 必須 | デフォルト | 説明 |
Type | string | はい | N/A | プラグインタイプは |
ProbeConfig | object | いいえ | N/A | AgentSight のプローブ設定です。設定しない場合、すべてのサブパラメータにデフォルト値が使用されます。 |
ProbeConfig.Verbose | uint | いいえ |
| 詳細な eBPF ログを出力するかどうかを指定します。 |
ProbeConfig.LogPath | string | いいえ |
| eBPF ログの出力パスです。 |
ProbeConfig.CmdlineWhitelist | array | いいえ | 組み込みの 9 ルール | プロセスエージェントフィルターのホワイトリスト。各エントリは、 |
ProbeConfig.CmdlineBlacklist | array | いいえ | N/A | プロセスエージェントのフィルターブラックリスト。各エントリは glob 文字列の配列 ( |
ProbeConfig.Https | array | いいえ | 組み込みの 7 ルール | HTTPS 暗号化トラフィックドメインホワイトリスト (文字列配列、glob ワイルドカード |
ProbeConfig.Http | array | いいえ |
| HTTP プレーンテキストトラフィックのターゲットリストです。各エントリには |
ProbeConfig.RawHttpsFallback | bool | いいえ |
|
|
ProbeConfig.EventStreamFormat | bool | いいえ |
|
|
ProbeConfig.MessageDeltaOnly | bool | いいえ |
|
|
収集範囲の判定ロジック
HTTPS 暗号化トラフィック (プロセスレベル) は、次の固定順序で判定されます:
CmdlineBlacklistに一致 → 収集されません (ブラックリストが優先されます)。ブラックリストに一致せず、
CmdlineWhitelistに一致 → 収集されます。まだ含まれておらず、かつプロセスが
Httpsに一致するドメインにアクセス → 収集済み。上記のいずれにも一致しない → 収集しません。
デフォルトのインジェクションルール: CmdlineWhitelist も CmdlineBlacklist も設定されていない場合、以下の 9 つの組み込みのデフォルトのコマンドラインホワイトリストルールがインジェクトされます。Https が空の場合、以下の 7 つの組み込みのデフォルトのドメインエントリがインジェクトされます。
組み込みのデフォルトコマンドラインホワイトリストルール
AgentType | Args (各コマンドラインセグメントのグロブパターン) |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
組み込みのデフォルトドメインホワイトリストエントリ
ドメイン | 説明 |
| OpenAI |
| Anthropic |
| DashScope 従量課金、中国 (北京) |
| DashScope 従量課金、シンガポール |
| DashScope 従量課金、米国 (バージニア) |
| DashScope Coding Plan |
| DashScope 専用ワークスペース / トライアル / Token Plan のドメイン |
追加ではなく上書き: ユーザー定義の設定は、組み込みのデフォルトに追加されるのではなく、完全に上書きします。いずれかのルールを指定すると、組み込みのデフォルトリスト全体が無効になります。組み込みのデフォルトエントリを保持するには、設定に明示的に含める (手動で追加する) 必要があります。そうしないと、設定にリストされていないデフォルトの Agent タイプまたはドメインは収集されなくなります。製品横断的な集計と分析を容易にするために、AgentType の値 ( openclaw や claude-code など) には、小文字、数字、ハイフン (-) のみを使用してください。
制限事項とトラブルシューティング
プレビューページまたはクエリページにデータがない: サーバーのカーネルバージョンが 5.10 以降 (
uname -r) であり、LoongCollector が v3.3.9 以降にアップグレードされていることを確認します。 次に、ターゲットプロセスのコマンドラインがCmdlineWhitelistルールに一致するか、アクセスするドメインがHttpsリストに含まれていることを確認します。 glob ルールを作成する前に、サーバーで次のコマンドを実行して、プロセスの実際のコマンドラインを表示します。tr '\0' ' ' < /proc/<PID>/cmdline; echo特定のエージェントバイナリで収集できない場合がある eBPF フック互換性の制限については、「技術付録」をご参照ください。
追加のトラブルシューティングガイダンスについては、「Troubleshoot Logtail log collection failures」をご参照ください。
この機能は現在カナリアリリース中で、US (Virginia)、US (Silicon Valley)、Malaysia (Kuala Lumpur)、Indonesia (Jakarta)、South Korea (Seoul) などのリージョンで利用できます。
技術付録
input_agentsight プラグインは、収集に eBPF を使用します。特定の Agent から HTTPS 暗号化トラフィックをキャプチャできるかどうかは、eBPF が Agent の実行可能ファイル内の SSL 送受信関数を特定できるかどうかによって決まります。サポート状況については、次の表を参照してください。
シナリオ | サポート | 特定方法 | 説明 |
Node.js または Python 経由で実行されるエージェント、または シンボルテーブルを保持しているエージェント | はい | シンボルベース | These programs send and receive data through common SSL libraries (primarily OpenSSL) with exported symbols. eBPF locates functions such as |
シンボルテーブルなし (strip 済み) だが、一般的な C の SSL ライブラリ (OpenSSL) に静的リンクされている | 一部 | バイトコードのパターンマッチング | シンボルテーブルがない場合、シンボルベースの特定はできません。ただし、基盤ライブラリが OpenSSL などの一般的な C ライブラリである場合、eBPF はバイトコードのパターンマッチングにより送受信関数を特定できます。例:uv でパッケージ化され、OpenSSL に静的リンクされ、strip された Python ツール。 |
シンボルテーブルなし (strip 済み)、エクスポートされたシンボルなしで静的リンクされており、かつバイトコードパターンも一致しない | いいえ | 特定不可 | シンボルテーブルでもバイトコードパターンでも送受信関数を特定できないため、フックポイントを確立できません。例:公式の Codex CLI リリース (strip 済み、静的リンク、エクスポートされたシンボルなし) はこのカテゴリに該当し、このプラグインでは収集できません。 |