View a markdown version of this page

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

Afficher les données d'observabilité de 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 sur Amazon CloudWatch

La page d'observabilité CloudWatch générative de l'IA affiche toutes les métriques fournies par le moteur d'exécution de l' AgentCore agent, ainsi que les données dérivées de l'étendue et du tracé 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 manière d'examiner les données de session et de suivi individuelles de vos agents, consultez la section relative aux AgentCore agents Amazon Bedrock dans le guide de l'utilisateur Amazon CloudWatch .

Afficher d'autres données dans CloudWatch

Toutes les métriques et les plages fournies par le service peuvent également être consultées CloudWatch, ainsi que toutes les métriques 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 Logs et sélectionnez Log groups

  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 d'agents ont le format suivant :

    • Logs standard - stdout/stderr sortie

      • Emplacement :/aws/bedrock-agentcore/runtimes/<agent_id>-<endpoint_name>/[runtime-logs] <UUID>

      • 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

    • Logs structurés OTEL - Informations détaillées sur le fonctionnement

      • Emplacement :/aws/bedrock-agentcore/runtimes/<agent_id>- <endpoint_name>/otel-rt-logs

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

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

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

Traces et portées

Les traces fournissent une visibilité sur les chemins d'exécution des demandes par l'intermédiaire de votre agent :

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

  • Accès via : console CloudWatch Transaction Search

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

Les traces capturent automatiquement :

  • Séquences d'invocation de l'agent

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

  • Appels et réponses LLM

  • Invocations d'outils et résultats

  • 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 du W3C : traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01

Pour afficher les traces, procédez comme suit :

  • Accédez à la CloudWatch console

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

  • Filtrer par nom de service ou par 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 au CloudWatch format EMF (Enhanced Metric Format) :

  • Espace de nom : bedrock-agentcore

  • Accès via : console CloudWatch Metrics

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

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

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