View a markdown version of this page

Afficher les données d'observabilité pour vos agents Amazon Bedrock AgentCore - Base rocheuse de l'Amazonie AgentCore
Afficher les données à l'aide de l'observabilité générative de l'IA dans Amazon CloudWatchAfficher d'autres données dans CloudWatch

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Afficher les données d'observabilité pour vos agents Amazon Bedrock AgentCore

Après avoir implémenté l'observabilité dans votre agent, vous pouvez consulter les métriques et les traces collectées à la fois sur la page d'observabilité de l'IA générative de la CloudWatch console et dans CloudWatch les journaux. Consultez les sections suivantes pour savoir comment consulter les statistiques de vos agents.

Afficher les données à l'aide de l'observabilité générative de l'IA dans Amazon CloudWatch

La page d'observabilité CloudWatch générative de l'IA affiche toutes les mesures fournies par le service et produites par l'exécution de l' AgentCore agent, ainsi que les données dérivées de l'intervalle et du traçage si vous avez activé l'instrumentation dans le code de votre agent. Pour afficher le tableau de bord d'observabilité dans CloudWatch, ouvrez la page Amazon CloudWatch GenAi Observability.

Grâce à l'observabilité générative de l'IA CloudWatch, vous pouvez consulter des tableaux de bord personnalisés contenant des graphiques et d'autres visualisations de vos données, ainsi que des ventilations des erreurs, des visualisations de traces, etc. Pour en savoir plus sur l'utilisation de l'observabilité générative de l'IA CloudWatch, notamment sur la façon d'examiner les données de session et de suivi individuelles de vos agents, consultez la section sur les AgentCore agents Amazon Bedrock dans le guide de l'utilisateur d'Amazon CloudWatch .

Afficher d'autres données dans CloudWatch

Toutes les métriques et les étendues fournies par le service peuvent également être consultées CloudWatch, de même que toutes les mesures produites par le code de votre agent instrumenté.

Pour consulter ces données, reportez-vous aux sections suivantes.

Journaux

  1. Ouvrez la console CloudWatch.

  2. Dans le volet de navigation de gauche, développez Journaux et sélectionnez Groupes de journaux

  3. Utilisez le champ de recherche pour trouver le groupe de journaux correspondant à votre agent, à votre mémoire ou à votre ressource de passerelle.

    AgentCore les groupes de journaux des agents ont le format suivant :

    • Journaux standard - stdout/stderr sortie

      • Emplacement  :/aws/bedrock-agentcore/runtimes/-/[journaux d'exécution]

      • Contient  : erreurs d'exécution, journaux d'applications, instructions de débogage

      • Exemple d'utilisation  :

        • print (« Demande de traitement... ») # Apparaît dans les journaux standard

        • logging.info (« Demande traitée avec succès ») # Apparaît dans les journaux standard

    • Journaux structurés OTEL - Informations détaillées sur les opérations

      • Lieu  :/aws/bedrock-agentcore/runtimes/- /otel-rt-logs

      • Contient  : détails d'exécution, suivi des erreurs, données de performance

      • Collecte automatique  : aucun code supplémentaire n'est requis, généré par l'instrumentation ADOT

      • Avantages  : peut inclure des identifiants de corrélation reliant les journaux aux traces pertinentes

Traces et étendues

Les traces fournissent une visibilité sur les chemins d'exécution des requêtes via votre agent :

  • Emplacement : le flux de spans journaux dans le groupe de journaux de l'agent (/aws/bedrock-agentcore/runtimes/-), ou le flux de default journaux dans le groupe de aws/spans journaux pour les agents qui utilisent la destination de span partagée. Pour plus d'informations, consultez Span destination pour les agents hébergés dans l' AgentCore environnement d'exécution Amazon Bedrock.

  • Accès via : console CloudWatch de recherche de transactions

  • Exigences : CloudWatch la recherche de transactions doit être activée

Les traces capturent automatiquement :

  • Séquences d'invocation d'agents

  • Intégration avec les composants du framework (LangChain, etc.)

  • Appels et réponses LLM

  • Invocations et résultats des outils

  • Chemins d'erreur et exceptions

Pour le suivi distribué entre les services, vous pouvez utiliser des en-têtes HTTP standard :

  • AWS X-Ray format : X-Amzn-Trace-Id: Root=1-5759e988-bd862e3fe1be46a994272793;Parent=53995c3f42cd8ad8;Sampled=1

  • Format W3C : traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01

Pour afficher les traces :

  • Accédez à la CloudWatch console

  • Sélectionnez Recherche de transactions dans la barre de navigation de gauche

  • Filtrer par nom de service ou selon d'autres critères

  • Sélectionnez une trace pour afficher le graphique d'exécution détaillé

Métriques

Si vous avez activé l'observabilité en instrumentant le code de votre agent comme décrit dans Activation de l' AgentCore observabilité, votre agent génère automatiquement des métriques OTEL, qui sont envoyées à CloudWatch l'aide du format EMF (Enhanced Metric Format) :

  • Espace de nom : bedrock-agentcore

  • Accès via : CloudWatch Metrics console

  • Contenu : métriques personnalisées générées par le code et les frameworks de votre agent

  • Collecte automatique : aucun code supplémentaire n'est requis, généré par l'instrumentation ADOT

Outre les mesures émises par les agents, le AgentCore service publie des mesures de service standard pour. CloudWatch Reportez-vous aux données d'observabilité d'exécution AgentCore générées pour obtenir la liste de ces mesures.