次の方法で共有

トレースと可観測性

DevUI には、エージェント フレームワークによって出力される OpenTelemetry (OTel) トレースをキャプチャして表示するための組み込みのサポートが用意されています。 DevUI は独自のスパンを作成しません。エージェントとワークフローの実行中に Agent Framework が出力するスパンを収集し、デバッグ パネルに表示します。 これは、エージェントの動作をデバッグし、実行フローを理解し、パフォーマンスの問題を特定するのに役立ちます。

近日公開

C# の DevUI ドキュメントは近日公開予定です。 概念ガイダンスについては、後でもう一度確認するか、Python のドキュメントを参照してください。

トレースの有効化

--tracing フラグを使用して DevUI を開始するときにトレースを有効にします。

devui ./agents --tracing

これにより、エージェント フレームワーク操作の OpenTelemetry トレースが有効になります。

DevUI でのトレースの表示

トレースが有効になっている場合、DevUI Web インターフェイスにはトレース情報が表示されます。

  1. UI を使用してエージェントまたはワークフローを実行する
  2. デバッグ パネルを開きます (開発者モードで使用可能)
  3. 表示されているトレースタイムラインを確認します。
    • スパン階層
    • タイミング情報
    • エージェント/ワークフロー イベント
    • ツールの呼び出しと結果

トレース構造

エージェント フレームワークは、GenAI の OpenTelemetry セマンティック規則に従ってトレースを出力します。 一般的なトレースには、次のものが含まれます。

Agent Execution
    LLM Call
        Prompt
        Response
    Tool Call
        Tool Execution
        Tool Result
    LLM Call
        Prompt
        Response

ワークフローの場合、トレースには Executor を介した実行パスが表示されます。

Workflow Execution
    Executor A
        Agent Execution
            ...
    Executor B
        Agent Execution
            ...

プログラムによるトレース

serve()でプログラムで DevUI を使用する場合、トレースを有効にすることができます。

from agent_framework.devui import serve

serve(
    entities=[agent],
    tracing_enabled=True
)

外部ツールとの統合

DevUI は、エージェント フレームワークによって出力されたトレースをキャプチャして表示します。独自のスパンは作成されません。 これらは標準の OpenTelemetry トレースであり、次のような外部監視ツールにもエクスポートできます。

  • ジャガー
  • Zipkin
  • Azure Monitor
  • Datadog

トレースを外部コレクターにエクスポートするには、 OTLP_ENDPOINT 環境変数を設定します。

export OTLP_ENDPOINT="http://localhost:4317"
devui ./agents --tracing

OTLP エンドポイントがない場合、トレースはローカルにキャプチャされ、DevUI デバッグ パネルにのみ表示されます。

Agent Framework の可観測性の詳細については、以下を参照してください。

次のステップ

  • Last updated on