すべてのプロダクト
Search
ドキュメントセンター

Simple Log Service:AI エージェントの可観測性ログの収集 (AgentSight)

最終更新日:Sep 23, 2026

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 ベースのカスタムエージェント

操作手順

  1. Simple Log Service コンソールにログインします。

  2. [Data Import] セクションで、LoongCollector の収集設定エントリを選択し、対象の [Project] と [Logstore] を選択します。

  3. [Machine Group Configuration] ページで、対象のマシングループを設定して適用します。

    重要

    マシングループを作成した直後に適用すると、接続がまだ有効になっていないため、ハートビートステータスが FAIL と表示される場合があります。[Automatic Retry] をクリックして、この問題を解決してください。

  4. [データソース設定] タブで、[設定名] を指定し、プラグイン設定を入力します。 プラグインタイプは 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 以降でのみサポートされます。

  5. インデックスを作成してデータをプレビューします。収集したフィールドに基づいてフィールドインデックスを手動で作成するか、[Auto Generate Index] をクリックします。

  6. 設定が完了したら、インデックスが有効になるまで約 1 分待ちます。その後、Logstore のクエリと分析ページで収集したログを確認できます。

    gen_ai.agent.type、gen_ai.model.request、gen_ai.model.response などのフィールドを含むログエントリが表示されます。これらのフィールドが存在することで、収集が正常に動作していることが確認されます。

設定パラメータ

パラメータ

タイプ

必須

デフォルト

説明

Type

string

はい

N/A

プラグインタイプは input_agentsight に固定されています。

ProbeConfig

object

いいえ

N/A

AgentSight のプローブ設定です。設定しない場合、すべてのサブパラメータにデフォルト値が使用されます。

ProbeConfig.Verbose

uint

いいえ

0

詳細な eBPF ログを出力するかどうかを指定します。1: 有効。0: 無効。

ProbeConfig.LogPath

string

いいえ

""

eBPF ログの出力パスです。

ProbeConfig.CmdlineWhitelist

array

いいえ

組み込みの 9 ルール

プロセスエージェントフィルターのホワイトリスト。各エントリは、AgentType (gen_ai.agent.type ログフィールドに書き込まれる) と Args (プロセスのコマンドラインの各セグメントに対して位置ごとに glob マッチングを実行する文字列配列) を持つオブジェクトです。このパラメーターも CmdlineBlacklist も設定されていない場合、組み込みのデフォルトのホワイトリストが挿入されます。設定すると、ユーザー定義のルールのみが使用され、組み込みのデフォルトは追加されません。空の配列 [] は無効な設定として扱われます。

ProbeConfig.CmdlineBlacklist

array

いいえ

N/A

プロセスエージェントのフィルターブラックリスト。各エントリは glob 文字列の配列 (AgentType なし) です。一致するプロセスは収集から除外されます。ホワイトリストよりも優先されます。

ProbeConfig.Https

array

いいえ

組み込みの 7 ルール

HTTPS 暗号化トラフィックドメインホワイトリスト (文字列配列、glob ワイルドカード *、大文字と小文字を区別しない)。このリスト内のドメインにアクセスするプロセスは、収集対象として識別されます。設定されていない場合は、組み込みのデフォルトリストが注入されます。

ProbeConfig.Http

array

いいえ

[] (無効)

HTTP プレーンテキストトラフィックのターゲットリストです。各エントリには :port、IP、IP:port、またはドメインを指定できます。このリストが空の場合、HTTP プレーンテキストトラフィックは収集されません。

ProbeConfig.RawHttpsFallback

bool

いいえ

false

true に設定すると、LLM セマンティクス (不明な API パスや非標準のボディ) として解析できないトラフィックは破棄されなくなります。代わりに、イベント名が event.name=http.request および event.name=http.response の raw HTTP トラフィックとして報告されます。このような raw HTTP ログは、AgentSight がトラフィックを GenAI セマンティクスとして解釈できない場合にのみ生成され、gen_ai.* ログとは相互に排他的です。1 つのリクエストで生成されるのは、この 2 種類のログのうちいずれか一方のみです。LoongCollector v3.3.9 以降でのみサポートされています。

ProbeConfig.EventStreamFormat

bool

いいえ

真

true の場合、各 LLM 呼び出しで、それぞれに event.id を持つ 2 つのログ (gen_ai.model.request (リクエスト) と gen_ai.model.response (レスポンス)) が同じロググループに出力されます。false の場合、event.name または event.id を含まない単一のマージされたログが出力されます。

ProbeConfig.MessageDeltaOnly

bool

いいえ

true

true の場合、gen_ai.input.messages 全体は出力されません。増分の gen_ai.input.messages_delta のみが出力され、ハッシュが変更された場合はシステム/ツールテキスト全体も出力されます。false の場合、空でない gen_ai.input.messages 全体が毎回出力されます。gen_ai.output.messages には影響しません。

収集範囲の判定ロジック

HTTPS 暗号化トラフィック (プロセスレベル) は、次の固定順序で判定されます:

  1. CmdlineBlacklist に一致 → 収集されません (ブラックリストが優先されます)。

  2. ブラックリストに一致せず、CmdlineWhitelist に一致 → 収集されます。

  3. まだ含まれておらず、かつプロセスが Https に一致するドメインにアクセス → 収集済み。

  4. 上記のいずれにも一致しない → 収集しません。

デフォルトのインジェクションルール: CmdlineWhitelist も CmdlineBlacklist も設定されていない場合、以下の 9 つの組み込みのデフォルトのコマンドラインホワイトリストルールがインジェクトされます。Https が空の場合、以下の 7 つの組み込みのデフォルトのドメインエントリがインジェクトされます。

組み込みのデフォルトコマンドラインホワイトリストルール

AgentType

Args (各コマンドラインセグメントのグロブパターン)

hermes

hermes*

hermes

*python*, *hermes*

hermes

python、-m、hermes

cosh

node*、*/usr/bin/co*

cosh

node*、*/usr/bin/cosh*

cosh

node*、*/usr/bin/copliot*

cosh

node*、*copilot-shell*

openclaw

*openclaw-gatewa*

openclaw

node*, openclaw

組み込みのデフォルトドメインホワイトリストエントリ

ドメイン

説明

api.openai.com

OpenAI

api.anthropic.com

Anthropic

dashscope.aliyuncs.com

DashScope 従量課金、中国 (北京)

dashscope-intl.aliyuncs.com

DashScope 従量課金、シンガポール

dashscope-us.aliyuncs.com

DashScope 従量課金、米国 (バージニア)

coding.dashscope.aliyuncs.com

DashScope Coding Plan

*.maas.aliyuncs.com

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 SSL_read and SSL_write through symbols. Examples: OpenClaw, Hermes, Cosh, and Claude Code.

シンボルテーブルなし (strip 済み) だが、一般的な C の SSL ライブラリ (OpenSSL) に静的リンクされている

一部

バイトコードのパターンマッチング

シンボルテーブルがない場合、シンボルベースの特定はできません。ただし、基盤ライブラリが OpenSSL などの一般的な C ライブラリである場合、eBPF はバイトコードのパターンマッチングにより送受信関数を特定できます。例:uv でパッケージ化され、OpenSSL に静的リンクされ、strip された Python ツール。

シンボルテーブルなし (strip 済み)、エクスポートされたシンボルなしで静的リンクされており、かつバイトコードパターンも一致しない

いいえ

特定不可

シンボルテーブルでもバイトコードパターンでも送受信関数を特定できないため、フックポイントを確立できません。例:公式の Codex CLI リリース (strip 済み、静的リンク、エクスポートされたシンボルなし) はこのカテゴリに該当し、このプラグインでは収集できません。