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 で現在のコネクタがそのタイプとオペレーティングシステムをサポートしていることを確認してください。
ステップ 1:Agent タイプを選択¶
接続設定ページで、接続する分類と Agent タイプを選択します。
ステップ 2:User アイデンティティの設定¶
接続設定では、現在のワークスペースメンバーの個人情報を関連付けるかどうかを選択できます。
- デフォルトでは「ワークスペースの個人情報を関連付け」がチェックされています。システムはメンバー名などの個人情報をアップロードし、メンバーの UUID を
user_idとして使用し、ユーザー名はuser_nameとして使用されます。 - チェックを外すと、システムがランダムな ID を
user_idとして自動生成します。user_nameは手動で入力する必要があります。 user_idは、User データの集計、フィルタリング、ドリルダウンに使用されます。user_nameは表示と検索にのみ使用され、User の一意の識別子としては使用されません。- 同じコネクタで接続された複数の Agent タイプは、同じ
user_idを共有します。
匿名の user_id は、コネクタの再起動、アップグレード、プラグインの更新後も維持されます。アイデンティティ設定を完全にクリアするか、明示的にアイデンティティをリセットした場合にのみ、システムは新しい匿名 ID を生成します。
ステップ 3:コネクタのインストール¶
Agent が実行されているホストのオペレーティングシステムに応じて、対応するコマンドを実行します。
インストール後、現在のターミナルで obs-agent-connector コマンドが認識されない場合は、ターミナルを開き直してから後続の操作を実行してください。
ステップ 4:プラグインのインストール¶
以下のコマンドを実行すると、現在の環境の Agent が自動的に検出され、接続が完了します:
プラグインの更新または削除¶
プラグインを更新する:
プラグインを削除する:
その他のコマンド
サポートされている 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 などのフィールドが表示されるかどうかは、実際に収集されたデータによって異なります。本文収集を無効にしている場合、入力・出力の本文が空であることをもってトレースの報告失敗と判断しないでください。