Partager via

Suivi et observabilité

DevUI fournit une prise en charge intégrée de la capture et de l’affichage des traces OpenTelemetry (OTel) émises par Agent Framework. DevUI ne crée pas ses propres étendues : elle collecte les étendues émises par Agent Framework pendant l’exécution de l’agent et du flux de travail, puis les affiche dans le panneau de débogage. Cela vous aide à déboguer le comportement de l’agent, à comprendre le flux d’exécution et à identifier les problèmes de performances.

Bientôt disponible

La documentation DevUI pour C# sera bientôt disponible. Consultez la documentation Python ultérieurement ou reportez-vous à la documentation Python pour obtenir des conseils conceptuels.

Activation du traçage

Activez le suivi lors du démarrage de DevUI avec l’indicateur --tracing :

devui ./agents --tracing

Cela active le suivi OpenTelemetry pour les opérations Agent Framework.

Affichage des traces dans DevUI

Lorsque le suivi est activé, l’interface web DevUI affiche les informations de trace :

  1. Exécuter un agent ou un flux de travail via l’interface utilisateur
  2. Ouvrez le panneau de débogage (disponible en mode développeur)
  3. Afficher la chronologie des traces montrant :
    • Hiérarchie des portées
    • Informations de synchronisation
    • Événements d’agent/flux de travail
    • Appels et résultats de l’outil

Structure de trace

Agent Framework émet des traces suivant les conventions sémantiques OpenTelemetry pour GenAI. Une trace classique inclut les éléments suivants :

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

Pour les flux de travail, les traces montrent le chemin d’exécution via les exécuteurs :

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

Traçage programmatique

Lorsque vous utilisez DevUI de manière programmatique avec serve(), le suivi peut être activé :

from agent_framework.devui import serve

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

Intégration à des outils externes

DevUI capture et affiche les traces émises par le Cadre d'agent - elle ne crée pas ses propres spans. Il s’agit de traces OpenTelemetry standard qui peuvent également être exportées vers des outils d’observabilité externes tels que :

  • Jaeger
  • Zipkin
  • Azure Monitor
  • Datadog

Pour exporter des traces vers un collecteur externe, définissez la variable d’environnement OTLP_ENDPOINT :

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

Sans point de terminaison OTLP, les traces sont capturées localement et affichées uniquement dans le panneau de débogage DevUI.

Pour plus d’informations sur l’observabilité d’Agent Framework :

Étapes suivantes

  • Last updated on