Dela via

Spårning och observerbarhet

DevUI ger inbyggt stöd för att samla in och visa OpenTelemetry-spårningar (OTel) som genereras av Agent Framework. DevUI skapar inte sina egna intervall – det samlar in de intervall som Agent Framework genererar under agent- och arbetsflödeskörningen och visar dem sedan i felsökningspanelen. Detta hjälper dig att felsöka agentbeteende, förstå körningsflödet och identifiera prestandaproblem.

Kommer snart

DevUI-dokumentationen för C# kommer snart. Kom tillbaka senare eller se Python-dokumentationen för konceptuell vägledning.

Aktivera spårning

Aktivera spårning när du startar DevUI med --tracing flaggan:

devui ./agents --tracing

Detta möjliggör OpenTelemetry-spårning för Agent Framework-åtgärder.

Visa spårningar i DevUI

När spårning är aktiverat visar DevUI-webbgränssnittet spårningsinformation:

  1. Köra en agent eller ett arbetsflöde via användargränssnittet
  2. Öppna felsökningspanelen (tillgänglig i utvecklarläge)
  3. Visa spårningstidslinjen som visar:
    • Span-hierarki
    • Tidsinformation
    • Agent-/arbetsflödeshändelser
    • Verktygsanrop och resultat

Spårstruktur

Agent Framework genererar spår enligt OpenTelemetry-semantiska konventioner för GenAI. En typisk spårning omfattar:

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

För arbetsflöden visar spår körvägen genom exekutorerna:

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

Programmatisk spårning

När du använder DevUI programmatiskt med serve()kan spårning aktiveras:

from agent_framework.devui import serve

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

Integrering med externa verktyg

DevUI samlar in och visar spårningar som genereras av Agent Framework – det skapar inte sina egna intervall. Det här är vanliga OpenTelemetry-spårningar som också kan exporteras till externa observerbarhetsverktyg som:

  • Jaeger
  • Zipkin
  • Azure Monitor
  • Datadog (Datahund)

Om du vill exportera spårningar till en extern insamlare anger du OTLP_ENDPOINT miljövariabeln:

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

Utan en OTLP-slutpunkt registreras spårningar lokalt och visas endast i DevUI-felsökningspanelen.

Mer information om observerbarhet för Agent Framework:

Nästa steg

  • Last updated on