Agent モニタリングアプリケーションの新規作成¶

Agent アプリケーションまたはフレームワークを接続すると、Agent モニタリングでトレース、モデル使用状況、関連するパフォーマンスデータを確認できます。接続方法はタイプによって異なります。

Agent モニタリング > サマリーを開きます。
Agent タブを選択します。
Agent を接続をクリックし、接続設定ページを開きます。

Agent タイプ¶

Agent モニタリングでは、以下のタイプをサポートしています。

カテゴリ	Agent タイプ	接続方法
Agent アプリ	Codex、Claude Code、OpenClaw、Hermes、Qoder、WorkBuddy、OpenCode、CodeBuddy、Cursor、DeepSeek Harness、Opm、mimo、pi	`obs-agent-connector` インストーラーで接続
Agent フレームワーク	AgentScope、Spring AI Alibaba、Deep Agents	OpenTelemetry で手動接続。Deep Agents の例は接続手順を参照

インストーラーで接続する¶

Codex、Claude Code、OpenClaw、Hermes、Qoder、WorkBuddy、OpenCode、CodeBuddy、Cursor、Opm、DeepSeek Harness、mimo、pi は obs-agent-connector インストーラーで接続します。コネクタは一度インストールするだけで済みます。接続する前に、モニタリング対象の Agent を先にインストールし、obs-agent-connector agents を実行して、現在のコネクタがそのタイプと OS をサポートしていることを確認してください。

手順 1: Agent タイプを選択¶

接続設定ページで、接続するカテゴリと Agent タイプを選択します。

手順 2: User 身元を設定¶

接続設定では、現在のワークスペースメンバーの個人情報を関連付けるかどうかを選択できます。

デフォルトで「ワークスペースの個人情報を関連付ける」がオンになっています。システムはメンバー名などの個人情報をアップロードし、メンバーの UUID を user_id として、ユーザー名を user_name として使用します。
オフにした場合、システムはランダムな ID を user_id として自動生成します。user_name は手動で入力する必要があります。
user_id は User データの集計、フィルタリング、ドリルダウンに使用されます。
user_name は表示と検索のみに使用され、User の一意の識別子としては扱われません。
同じ Connector で接続した複数の Agent タイプは、同じ user_id を共有します。

匿名の user_id は、Connector の再起動、アップグレード、プラグイン更新後も変わりません。身元設定を完全にクリアするか、明示的に身元をリセットした場合にのみ、システムは新しい匿名 ID を生成します。

手順 3: コネクタをインストール¶

Agent が稼働するホストの OS に応じて、対応するコマンドを実行します。

macOS/LinuxWindows

curl -fsSL -O https://static.guance.com/obs-agent-connector/install.sh && \
sh install.sh \
  --download-base-url=https://static.guance.com/obs-agent-connector-test \
  --endpoint=<Endpoint> \
  --x-token=<X-Token>

PowerShell で実行します：

$env:OBS_AGENT_CONNECTOR_OSS_ENDPOINT = "https://static.guance.com/obs-agent-connector"
Invoke-WebRequest -Uri "$env:OBS_AGENT_CONNECTOR_OSS_ENDPOINT/install.ps1" -OutFile "install.ps1"
powershell -ExecutionPolicy bypass -File .\install.ps1

インストールが完了したら、現在のターミナルで obs-agent-connector コマンドを認識できない場合は、ターミナルを開き直してから後続の操作を実行してください。

手順 4: プラグインをインストール¶

次のコマンドを実行すると、現在の環境の Agent が自動検出され、接続が完了します：

obs-agent-connector discover

プラグインの更新または削除¶

プラグインを更新する：

obs-agent-connector update <插件标识>

プラグインを削除する：

obs-agent-connector remove <插件标识>

その他のコマンド

サポートされている Agent、よく使用するコマンド、インストールパラメータ、使用例については、obs-agent-connector コマンドリファレンスを参照してください。

AgentScope の手動接続¶

AgentScope は obs-agent-connector を使用しません。OpenTelemetry による手動接続が必要です。言語によって接続方法は多少異なります。以下では Java を例に説明します。

手順 1: AgentScope を選択¶

接続設定ページで AgentScope を選択し、インスタンス名を入力します。インスタンス名には中国語、英語、数字、アンダースコア、ハイフンを使用でき、同じ Agent タイプ内で一意である必要があります。

手順 2: OpenTelemetry を有効にする¶

AgentScope 公式ドキュメントを参照し、AgentScope のコードで TelemetryTracer を登録します：

import io.agentscope.core.tracing.TraceRegistry;
import io.agentscope.core.tracing.telemetry.TelemetryTracer;

TraceRegistry.register(
    TelemetryTracer.builder()
        .build()
);

ReActAgent agent = ReActAgent.builder()
    .name("Assistant")
    .model(model)
    .build();

手順 3: 環境変数を設定する¶

接続設定ページでは、現在のインスタンスに基づいて Endpoint、X-Token、Agent ID、Agent Name が生成されます。ページで生成された実際の値をコピーし、以下の環境変数を設定します：

export OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
export OTEL_TRACES_EXPORTER=otlp
export OTEL_METRICS_EXPORTER=otlp
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="<Endpoint>/v1/write/otel-llm"
export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT="<Endpoint>/v1/write/otel-metrics"
export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT="<Endpoint>/v1/write/otel-logs"
export OTEL_RESOURCE_ATTRIBUTES="service.version=1.0.0,deployment.environment=production,agent_id=<Agent ID>,agent_name=<Agent Name>,agent_runtime=agentscope"
export OTEL_EXPORTER_OTLP_HEADERS="X-token=<X-Token>,to-headless=true"

手順 4: 接続を確認する¶

AgentScope アプリケーションを再起動してテストリクエストを 1 回送信し、Agent モニタリングで Trace と Metrics のデータが生成されていることを確認します。データがない場合は、Endpoint、X-Token、Agent ID、および OpenTelemetry の環境変数が正しく有効になっているかを重点的に確認してください。

Deep Agents の手動接続¶

Deep Agents は OpenTelemetry でトレースを送信し、ランタイム識別子は langchain です。以下の設定は、OpenTelemetry のトレース収集を有効にした Python アプリケーション向けで、Agent、モデル、ツール、サブエージェントの呼び出しプロセスを送信するために使用します。

手順 1: インスタンスを作成する¶

接続設定ページを開き、Agent フレームワークから Deep Agents を選択して、インスタンス名と User 身元情報を入力します。ページで生成された Endpoint、X-Token、Agent ID、Agent Name、User ID、User Name をコピーし、後続の設定で使用します。

手順 2: OpenTelemetry を設定する¶

アプリケーションを起動するターミナルで以下の設定を実行します（macOS/Linux 向け）。山括弧で囲まれたプレースホルダーを、手順 1 でページに表示された実際の値に置き換えてください。Endpoint にはページで提供されるベースアドレスを使用し、/v1/write/otel-llm を重複して追加しないでください。

export OTEL_SERVICE_NAME="langchain-deep-agent"
export OTEL_EXPORTER_OTLP_TRACES_PROTOCOL=http/protobuf
export OTEL_TRACES_EXPORTER=otlp
export OTEL_METRICS_EXPORTER=none
export OTEL_LOGS_EXPORTER=none
export TRACELOOP_TRACE_CONTENT=false
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="<Endpoint>/v1/write/otel-llm"
export OTEL_RESOURCE_ATTRIBUTES="agent_id=<Agent ID>,agent_name=<Agent Name>,user_id=<User ID>,user_name=<User Name>,agent_runtime=langchain"
export OTEL_EXPORTER_OTLP_HEADERS="X-token=<X-Token>,to-headless=true"

この例では Trace のみを送信し、Metrics と Logs のエクスポートを無効にしています。入力・出力の本文はデフォルトでは収集されません。本文を確認する必要がある場合は、データ収集範囲を確認してから TRACELOOP_TRACE_CONTENT を true に設定し、新しい呼び出しレコードを生成してください。設定を変更しても、既存の Trace に本文が遡って追加されることはありません。

手順 3: 起動して確認する¶

アプリケーション自身の起動コマンドで Deep Agents アプリケーションを起動または再起動し、プロセスが上記の環境変数を読み込むようにしてから、テスト呼び出しを 1 回実行してください。

1 回の呼び出しが完了したら、Agent モニタリングの Deep Agents タイプのページを開き、対応するインスタンスを選択して、新しく生成された Trace を確認します。agent_id またはサービス名で特定し、呼び出し階層やモデル・ツールの呼び出し情報を確認できます。

データがない場合は、まずモデルリクエストが成功しているかを確認し、その上で Endpoint、X-Token、プロトコル、ネットワーク接続を確認してください。Token などのフィールドが表示されるかどうかは、実際に収集されたデータによって異なります。本文の収集を無効にしている場合、入力・出力の本文が空であることをもってトレースの送信失敗と判断しないでください。