AgentCore outils intégrés générés, données d'observabilité
Rubriques
Métriques des outils d'observabilité
AgentCore fournit les métriques intégrées suivantes pour l'interpréteur de code et les outils du navigateur. Built-in les métriques de l'outil sont regroupées par lots à intervalles d'une minute. Pour en savoir plus sur les AgentCore outils, consultez Exécuter du code et analyser des données à l'aide d'Amazon Bedrock AgentCore Code Interpreter et Interagir avec des applications Web à l'aide du navigateur Amazon Bedrock AgentCore .
Outil Invoke :
- Invocations
-
Le nombre total de demandes adressées à l'API Data Plane. Chaque appel d'API compte comme un appel, quels que soient la taille de la charge utile de la demande ou le statut de la réponse.
- Throttles
-
Le nombre de demandes limitées par le service en raison du dépassement des limites de TPS (transactions par seconde) ou de quotas autorisés. Ces demandes sont renvoyées ThrottlingException avec le code d'état HTTP 429.
- SystemErrors
-
Nombre d'erreurs côté serveur rencontrées lors du traitement des demandes.
- UserErrors
-
Le nombre d'erreurs côté client résultant de demandes non valides. Cela nécessite une action de l'utilisateur pour le résoudre.
- Latence
-
Temps écoulé entre le moment où le service reçoit la demande et le moment où il commence à envoyer le premier jeton de réponse. Important pour mesurer le temps de réponse initial.
Créer une session d'outils :
- Invocations
-
Le nombre total de demandes adressées à l'API Data Plane. Chaque appel d'API compte comme un appel, quels que soient la taille de la charge utile de la demande ou le statut de la réponse.
- Throttles
-
Le nombre de demandes limitées par le service en raison du dépassement des limites de TPS (transactions par seconde) ou de quotas autorisés. Ces demandes sont renvoyées ThrottlingException avec le code d'état HTTP 429.
- SystemErrors
-
Nombre d'erreurs côté serveur rencontrées lors du traitement des demandes.
- UserErrors
-
Le nombre d'erreurs côté client résultant de demandes non valides. Cela nécessite une action de l'utilisateur pour le résoudre.
- Latence
-
Temps écoulé entre le moment où le service reçoit la demande et le moment où il commence à envoyer le premier jeton de réponse. Important pour mesurer le temps de réponse initial.
- Duration
-
Durée de la session d'outil (l'opération devient CodeInterpreterSession/BrowserSession).
Prise de contrôle par l'utilisateur du navigateur :
- TakerOverCount
-
Le nombre total d'utilisateurs prenant le relais
- TakerOverReleaseCount
-
Nombre total d'utilisateurs qui ont relâché le contrôle
- TakerOverDuration
-
La durée de prise de contrôle par l'utilisateur
Statistiques et journaux d'utilisation des ressources
Amazon Bedrock AgentCore Built-in Tools fournit une télémétrie complète de l'utilisation des ressources, y compris des mesures de consommation de processeur et de 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.
Indicateurs de vente
Par défaut, Bedrock AgentCore Built-in Tools fournit des mesures pour le niveau du compte et le niveau de l'outil à une résolution d'une minute. CloudWatch L'agrégation et la conservation des données métriques d'Amazon respectent 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.
| Nom | Dimensions | Description |
|---|---|---|
|
CPUUsed-vCPUHours |
Service ; Service, Ressource |
La quantité totale de CPU virtuelle consommée en CPU-Hours unité v, disponible au niveau de la ressource et du compte. Utile pour le suivi des ressources et la visibilité estimée de la facturation. |
|
MemoryUsed-GBHours |
Service ; Service, Ressource |
Quantité totale de mémoire consommée par GB-Hours unité, disponible au niveau des ressources et du compte. Utile pour le suivi des ressources et la visibilité estimée de la facturation. |
Explication des dimensions
-
Service - AgentCore.CodeInterpreter ou AgentCore.Browser
-
Ressource - ID de Built-in l'outil
Les statistiques au niveau du compte sont disponibles dans la console d' AgentCore observabilité Amazon CloudWatch Bedrock sous l'onglet Built-in Outils. Le tableau de bord de la console contiendra un graphique d'utilisation de la mémoire et un graphique d'utilisation du processeur généré à partir des métriques d'utilisation. Ces graphiques représentent l'utilisation totale des ressources pour tous les outils du type d'outil sélectionné dans le compte de la région.
Les mesures au niveau des outils sont disponibles sur la page Outils de la console d' AgentCore observabilité Amazon CloudWatch Bedrock. Le tableau de bord de la console contiendra un graphique d'utilisation de la mémoire et un graphique d'utilisation du processeur généré à partir des métriques d'utilisation. Les graphiques représentent l'utilisation totale des ressources au cours de toutes les sessions de l'outil sélectionné.
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 de télémétrie 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 autorisés.
Journaux vendus
Amazon Bedrock AgentCore Built-in Tools permet d'activer les journaux automatiques pour la télémétrie d'utilisation au niveau de la session avec une granularité d'une seconde. Chaque enregistrement de journal contient une donnée d'utilisation des ressources d'une seconde. Les métriques actuellement prises en charge incluent :
-
Code Interprefer code Interpreter.vcpu.hours.used et code _hours.used Interpreter.memory.gb
-
Navigateur browser.vcpu.hours.used et browser.memory.gb_hours.used
Chaque donnée d'utilisation des ressources utilisera le schéma suivant dans l'enregistrement du journal.
Interprète de code
| 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, elapsed_time_seconds, code, code _hours.used Interpreter.vcpu.hours.used Interpreter.memory.gb |
Journaux d'utilisation des ressources pour le suivi des ressources au niveau des sessions. |
Navigateur
| 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, elapsed_time_seconds, browser.vcpu.hours.used, browser.memory.gb_hours.used |
Journaux d'utilisation des ressources pour le suivi des ressources au niveau des sessions. |
Pour plus d'informations sur l'activation des journaux, consultez Ajouter de l'observabilité à vos ressources Amazon Bedrock AgentCore . Ces journaux sont ensuite affichés dans la destination telle que configurée (AWS LogGroupAmazon S3 ou Amazon Kinesis Firehose).
Sur la page Built-in Tools Session de la console d' AgentCore observabilité Amazon CloudWatch Bedrock, vous pouvez consulter les statistiques d'utilisation des ressources générées à partir de ces journaux. Pour optimiser votre expérience d'affichage 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 relatives à l'utilisation du processeur et de la mémoire.
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 de télémétrie 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 autorisés.
Données d'envergure fournies
Pour améliorer l'observabilité, AgentCore fournit des plages structurées qui offrent une visibilité sur les API des outils intégrés. Pour activer ces données d'intervalle, vous devez activer l'observabilité sur votre ressource d'outils intégrée. Consultez Ajouter de l'observabilité à vos AgentCore ressources Amazon Bedrock pour connaître les étapes à suivre et obtenir des informations détaillées. Ces données d'intervalle sont disponibles dans leur intégralité dans AWS CloudWatch les journaux du groupe de aws/spans journaux. Le tableau suivant définit l'opération pour laquelle les intervalles sont créés et les attributs de chaque intervalle capturé.
Interprète de code
| Nom de l’opération | Attributs d'envergure | Description |
|---|---|---|
|
StartCodeInterpreterSession |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type |
Démarre une session d'interpréteur de code. |
|
StopCodeInterpreterSession |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type, session_duration_s |
Arrête une session d'interpréteur de code. |
|
InvokeCodeInterpreter |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type |
Invoque un interpréteur de code avec le code d'entrée. |
|
CodeInterpreterSessionExpire |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type, session_duration_s |
Expire une session d'interpréteur de code si elle n' StopCodeInterpreterSession est pas appelée et la session expire. |
-
toolsession.id - l'identifiant de la session de l'outil
-
session_duration_s - la durée de la session en secondes avant sa fin
Navigateur
| Nom de l’opération | Attributs d'envergure | Description |
|---|---|---|
|
StartBrowserSession |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type |
Démarre une session de navigation. |
|
StopBrowserSession |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type, session_duration_s |
Arrête une session de navigateur. |
|
ConnectBrowserAutomationStream |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type |
Connectez-vous à un flux d'automatisation du navigateur. |
|
BrowserSessionExpire |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type, session_duration_s |
Expire une session d'interpréteur de code si elle n' StopBrowserSession est pas appelée et la session expire. |
Données du journal des applications
AgentCore fournit des journaux d'applications structurés qui vous aident à obtenir une meilleure visibilité sur les appels d'exécution de vos agents et sur la consommation de ressources au niveau de la session. Ces données de journal sont fournies lors de l'activation de l'observabilité sur les ressources de votre agent. Consultez Ajouter de l'observabilité à vos AgentCore ressources Amazon Bedrock pour connaître les étapes à suivre 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 d'application de votre agent ou dans votre propre groupe de journaux personnalisé.
| Type de journal | Champs de journal | Description |
|---|---|---|
|
JOURNAUX D'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'application pour InvokeCodeInterpreter les champs de suivi, les charges utiles des demandes et des réponses |
