Delen via

Tracering en waarneembaarheid

DevUI biedt ingebouwde ondersteuning voor het vastleggen en weergeven van OTelemetry-traceringen (OpenTelemetry) die worden verzonden door het Agent Framework. DevUI maakt geen eigen spans aan. Het verzamelt de spans die Agent Framework uitzendt tijdens de uitvoering van de agent en de workflow, en geeft deze vervolgens weer in het foutopsporingspaneel. Dit helpt u bij het opsporen van fouten in het gedrag van agents, het begrijpen van de uitvoeringsstroom en het identificeren van prestatieproblemen.

Binnenkort beschikbaar

De DevUI-documentatie voor C# is binnenkort beschikbaar. Kom later terug of raadpleeg de Python-documentatie voor conceptuele richtlijnen.

Tracering inschakelen

Tracering inschakelen bij het starten van DevUI met de --tracing vlag:

devui ./agents --tracing

Hierdoor kan OpenTelemetry-tracering worden uitgevoerd voor Agent Framework-bewerkingen.

Traceringen weergeven in DevUI

Wanneer tracering is ingeschakeld, geeft de DevUI-webinterface traceringsgegevens weer:

  1. Een agent of werkstroom uitvoeren via de gebruikersinterface
  2. Het foutopsporingsvenster openen (beschikbaar in de ontwikkelaarsmodus)
  3. Bekijk de traceringstijdlijn met:
    • Span-hiërarchie
    • Tijdsinformatie
    • Agent- en werkstroomgebeurtenissen
    • Aanroepen en resultaten van tools

Traceringsstructuur

Agent Framework verzendt traceringen volgens semantische OpenTelemetry-conventies voor GenAI. Een typische tracering omvat:

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

Voor werkstromen tonen traceringen het uitvoeringspad via uitvoerders:

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

Programmatische tracering

Wanneer u DevUI programmatisch gebruikt met serve(), kan tracering worden ingeschakeld:

from agent_framework.devui import serve

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

Integratie met externe hulpprogramma's

DevUI legt traceringen vast die door het Agent Framework worden uitgezonden en toont deze. Het maakt geen eigen spans aan. Dit zijn standaard OpenTelemetry-traceringen die ook kunnen worden geëxporteerd naar externe hulpprogramma's voor waarneembaarheid, zoals:

  • Jager
  • Zipkin
  • Azure Monitor
  • Datadog

Als u traceringen wilt exporteren naar een externe collector, stelt u de OTLP_ENDPOINT omgevingsvariabele in:

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

Zonder een OTLP-eindpunt worden traceringen lokaal vastgelegd en alleen weergegeven in het deelvenster Voor foutopsporing van DevUI.

Voor meer informatie over waarneembaarheid van Agent Framework:

Volgende stappen

  • Last updated on