Métriques d'exécution de l'observabilité Métriques et journaux d'utilisation des ressources Données d'envergure fournies Données du journal des applications Types d’erreurs

AgentCore données d'observabilité d'exécution générées

Les mesures d'exécution fournies par vous AgentCore donnent une visibilité sur les niveaux d'activité d'exécution de vos agents, la latence de traitement, l'utilisation des ressources et les taux d'erreur. AgentCore fournit également des mesures agrégées pour le nombre total d'appels et de sessions.

Rubriques

Métriques d'exécution de l'observabilité
Métriques et journaux d'utilisation des ressources
Données d'envergure fournies
Données du journal des applications
Types d’erreurs

Métriques d'exécution de l'observabilité

La liste suivante décrit les mesures d'exécution fournies par AgentCore. Les métriques d'exécution sont groupées à intervalles d'une minute. Pour en savoir plus sur l'affichage des statistiques d'exécution, voir Afficher les données d'observabilité pour vos agents Amazon Bedrock AgentCore .

Invocations: Indique le nombre total de demandes adressées à l'API Data Plane. Chaque appel d'API compte comme une invocation, indépendamment de la taille de la charge utile de la demande ou de l'état de la réponse.
Invocations (agrégées): Affiche le nombre total d'invocations pour toutes les ressources
Throttles: Affiche le nombre de demandes limitées par le service en raison d'un dépassement des limites de TPS (transactions par seconde) ou de quotas autorisées. Ces requêtes sont renvoyées ThrottlingException avec le code d'état HTTP 429. Surveillez cette métrique pour déterminer si vous devez revoir vos quotas de service ou optimiser les modèles de demandes.
Erreurs du système: Indique le nombre d'erreurs côté serveur rencontrées AgentCore lors du traitement des demandes. Un nombre élevé d’erreurs côté serveur peut indiquer des problèmes potentiels d’infrastructure ou de service qui nécessitent une enquête. Consultez la section Types d'erreur pour obtenir la liste des codes d'erreur possibles.
Erreurs de l'utilisateur: Représente le nombre d'erreurs côté client résultant de demandes non valides. La résolution de ces problèmes nécessite l'intervention de l'utilisateur. Des niveaux élevés d'erreurs côté client peuvent indiquer des problèmes liés au formatage des demandes ou aux autorisations qui doivent être résolus. Consultez la section Types d'erreur pour obtenir la liste des codes d'erreur possibles.
Latence: Temps total écoulé entre la réception de la demande et l'envoi du jeton de réponse final. Représente le temps de traitement complet de bout en bout de la demande.
Total Errors (Nombre total d'erreurs): Nombre total d'erreurs du système et de l'utilisateur. Dans la AgentCore console Amazon Bedrock, cette métrique affiche le nombre d'erreurs en pourcentage du nombre total d'appels.
Nombre de sessions: Indique le nombre de nouvelles sessions d'agent créées au cours de la période de référence. Chaque session est comptabilisée une fois au moment de la création ; les appels ultérieurs à la même session n'incrémentent pas cette métrique. Il s'agit d'un compteur cumulatif et non d'une mesure des sessions actuellement actives. Utile pour surveiller l'utilisation globale de la plateforme, les tendances des taux de création de sessions et comprendre les modèles d'engagement des utilisateurs.
Sessions (agrégées): Indique le nombre total de nouvelles sessions créées pour toutes les ressources au cours de la période de référence.
ActiveSessionCount: Indique le nombre de sessions actuellement actives pour votre compte. Contrairement à la SessionCount métrique (un compteur cumulé), cette métrique est une jauge en temps réel indiquant le nombre de sessions en cours à un moment donné. Amazon Bedrock AgentCore publie cette statistique une fois par minute et par type de service. Utilisez-le pour surveiller l'utilisation actuelle de la capacité, définir des alarmes en cas de pics d'utilisation inattendus et comprendre la consommation de vos quotas de session. Utilisez la Service dimension — avec des valeurs AgentCore.RuntimeAgentCore.CodeInterpreter, ou AgentCore.Browser — pour filtrer cette métrique par type de charge de travail. Amazon Bedrock AgentCore publie cette métrique directement sur votre AWS compte dans l'espace de AWS/Bedrock-AgentCore noms.
ActiveStreamingConnections: (WebSocket uniquement) Affiche le nombre actuel de WebSocket connexions actives par agent. Surveillez cette métrique pour comprendre l'utilisation de la connexion et détecter les interruptions ou les pics de connexion pour la planification des capacités. La seule statistique significative est une somme d'une minute.
InboundStreamingBytesProcessed: (WebSocket uniquement) Affiche le nombre total d'octets traités avec succès dans les WebSocket trames reçues des clients vers les conteneurs d'agents. Utilisez cette métrique pour surveiller le débit de données et identifier les modèles d'utilisation.
OutboundStreamingBytesProcessed: (WebSocket uniquement) Affiche le nombre total d'octets traités avec succès dans les WebSocket trames envoyées depuis les conteneurs d'agents aux clients. Surveillez cette métrique pour comprendre les modèles de réponse des agents et garantir une transmission de données réussie.

Métriques et journaux d'utilisation des ressources

Amazon Bedrock AgentCore Runtime fournit une télémétrie complète de l'utilisation des ressources, y compris des mesures de consommation du processeur et de la mémoire pour vos ressources d'exécution.

Note

Les données d'utilisation des ressources peuvent être retardées de 60 minutes au maximum et la précision peut varier selon les indicateurs.

Métriques distribuées

L' AgentCore environnement d'exécution Amazon Bedrock fournit automatiquement des mesures d'utilisation des ressources au niveau du compte, de l'exécution de l'agent et du point de terminaison de l'agent. Ces mesures sont publiées à une résolution d'une minute. CloudWatch L'agrégation Amazon et la conservation des données métriques suivront les politiques de conservation CloudWatch des données standard d'Amazon. Pour plus d'informations, consultez https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html #Metric.

Voici les ensembles de dimensions et les mesures disponibles pour surveiller vos ressources :

Nom	Dimensions	Description
CPUUsed-vCPUHours	Service ; Service, Ressource ; Service, Ressource, Nom	La quantité totale de processeur virtuel consommée par CPU-Hours unité v, disponible au niveau des ressources et des comptes. Utile pour le suivi des ressources et la visibilité estimée de la facturation.
MemoryUsed-GBHours	Service ; Service, Ressource ; Service, Ressource, Nom	Quantité totale de mémoire consommée par GB-Hours unité, disponible au niveau des ressources et des comptes. Utile pour le suivi des ressources et la visibilité estimée de la facturation.

Explication des dimensions

Service - AgentCore.Runtime
Ressource - Agent Arn
Nom : nom du point de terminaison de l'agent, au format AgentName suivant : EndpointName

Les statistiques au niveau du compte sont disponibles dans la console d' AgentCore observabilité Amazon CloudWatch Bedrock, sous l'onglet Runtime. Le tableau de bord affiche les graphiques d'utilisation de la mémoire et du processeur générés à partir de ces mesures, représentant l'utilisation totale des ressources par tous les agents de votre compte dans la région.

Les mesures au niveau des terminaux des agents sont disponibles AgentEndpoint sur la page d'Amazon CloudWatch Bedrock AgentCore Observability Console. Le tableau de bord affiche les graphiques d'utilisation de la mémoire et du processeur générés à partir de ces mesures, représentant l'utilisation totale des ressources sur toutes les sessions invoquées par le point de terminaison de l'agent spécifié.

Note

Les données de télémétrie sont fournies à des fins de surveillance. La facturation réelle est calculée sur la base des données d'utilisation mesurées et peut différer des valeurs télémétriques en raison du calendrier d'agrégation, des processus de rapprochement et de la précision des mesures. Reportez-vous à votre relevé AWS de facturation pour connaître les frais faisant autorité.

Journaux vended

Bedrock AgentCore Runtime fournit des journaux automatisés pour les mesures d'utilisation au niveau de la session avec une granularité d'une seconde. Chaque enregistrement de journal contient des données de consommation de ressources, notamment l'utilisation du processeur (agent.runtime.vcpu.hours.used) et la consommation de mémoire (agent.runtime.memory.gb_hours.used).

Chaque enregistrement de journal aura le schéma suivant :

Type de journal	Champs de journal	Description
JOURNAUX_D'UTILISATION	event_timestamp, resource_arn, service.name, cloud.provider, cloud.region, account.id, region, resource.id, session.id, agent.name, elapsed_time_seconds, agent.runtime.vcpu.hours.used, agent.runtime.memory.gb_hours.used	Journaux d'utilisation des ressources pour le suivi des ressources au niveau de la session.

Pour activer le type de journal USAGE_LOG pour vos agents, voir Ajouter de l'observabilité à vos ressources Amazon Bedrock. AgentCore Les journaux sont ensuite affichés dans la destination configurée (AWS LogGroupAmazon S3 ou Amazon Kinesis Firehose) telle que configurée.

Sur la page Session d'agent de la console d' AgentCore observabilité Amazon CloudWatch Bedrock, vous pouvez consulter les mesures d'utilisation des ressources générées à partir de ces journaux. Pour optimiser votre expérience de visualisation des métriques, sélectionnez la plage de temps souhaitée à l'aide du sélecteur en haut à droite pour vous concentrer sur des données spécifiques d'utilisation du processeur et de la mémoire.

Note

Données d'envergure fournies

Pour améliorer l'observabilité, AgentCore fournit des intervalles structurés qui fournissent une visibilité sur les appels à l'exécution des agents. Pour activer ces données de span, vous devez activer l'observabilité sur votre ressource d'agent. Consultez la section Ajouter de l'observabilité à vos AgentCore ressources Amazon Bedrock pour connaître les étapes et obtenir des informations détaillées. Ces données d'intervalle sont disponibles dans Amazon CloudWatch Logs. Les spans apparaissent dans le groupe de journaux de l'agent (/aws/bedrock-agentcore/runtimes/<agent_id>-<endpoint_name>), ou 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. Le tableau suivant définit l'opération pour laquelle les spans sont créées et les attributs de chaque span capturée.

Nom de l’opération	Attributs Span	Description
InvokeAgentRuntime	aws.operation.name, aws.resource.arn, aws.request_id, aws.agent.id, aws.endpoint.name, aws.account.id, session.id, latency_ms, error_type, aws.resource.type, aws.xray.origin, aws.region	Invoque l'environnement d'exécution de l'agent.

aws.operation.name - le nom de l'opération () InvokeAgentRuntime
aws.resource.arn : nom de ressource Amazon pour l'exécution de l'agent
aws.request_id - ID de demande pour l'invocation
aws.agent.id : identifiant unique pour l'exécution de l'agent
aws.endpoint.name : nom du point de terminaison utilisé pour appeler le runtime de l'agent
aws.account.id - identifiant de compte du client
session.id - l'ID de session pour l'invocation
latency_ms - la latence de la requête en millisecondes
error_type : accélérateur, système ou utilisateur (présent uniquement en cas d'erreur)
aws.resource.type - le type de ressource CFN
aws.xray.origin - le type de ressource CFN utilisé par x-ray pour identifier le service
aws.region - la région dans laquelle se trouve la ressource client

Données du journal des applications

AgentCore fournit des journaux d'application structurés qui vous permettent d'obtenir une meilleure visibilité sur les appels d'exécution de vos agents et sur la consommation des ressources au niveau de la session. Ces données de journal sont fournies lors de l'activation de l'observabilité sur votre ressource d'agent. Consultez la section Ajouter de l'observabilité à vos AgentCore ressources Amazon Bedrock pour connaître les étapes et obtenir des informations détaillées. AgentCore peut générer des CloudWatch journaux vers Logs, Amazon S3 ou Firehose stream. Si vous utilisez une destination CloudWatch Logs, ces journaux sont stockés dans les journaux des applications de votre agent ou dans votre propre groupe de journaux personnalisé.

Type de journal	Champs de journal	Description
JOURNAUX_DES APPLICATIONS	timestamp, resource_arn, event_timestamp, account_id, request_id, session_id, trace_id, span_id, service_name, operation, request_payload, response_payload	Journaux d'applications InvokeRuntimeOperation avec champs de suivi, charges utiles de demandes et de réponses

request_payload - la charge utile de la demande lors de l'invocation de l'agent
response_payload - la réponse à l'appel de l'agent

Types d’erreurs

La liste suivante définit les types d'erreur possibles pour les erreurs d'utilisateur, de système et de limitation.

Codes d'erreur utilisateur

InvocationError.Validation- Le client a fourni une entrée non valide (400)
InvocationError.ResourceNotFound- La ressource demandée n'existe pas (404)
InvocationError.AccessDenied- Le client n'a pas les autorisations nécessaires (403)
InvocationError.Conflict- Conflit de ressources (409)

Codes d'erreur système

InvocationError.Internal- Erreur interne du serveur (500)

Codes d'erreur de limitation

InvocationError.Throttling- Limitation de débit (429)
InvocationError.ServiceQuota- Service-side quota/limit atteint (402)

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

AgentCore données d'observabilité générées

Données d'observabilité de la mémoire