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.
AgentCore outils intégrés générés, données d'observabilité
Rubriques
Métriques des outils d'observabilité
AgentCore fournit les mesures intégrées suivantes pour l'interpréteur de code et les outils du navigateur. Built-in les métriques des outils sont regroupées à 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 une invocation, indépendamment de la taille de la charge utile de la demande ou de l'état de la réponse.
- Throttles
-
Le nombre de demandes limitées par le service en raison du dépassement des limites autorisées du TPS (transactions par seconde) ou des quotas. Ces requêtes sont renvoyées ThrottlingException avec le code d'état HTTP 429.
- SystemErrors
-
Le 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. La résolution de ce problème nécessite l'intervention de l'utilisateur.
- Latence
-
Le 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 une invocation, indépendamment de la taille de la charge utile de la demande ou de l'état de la réponse.
- Throttles
-
Le nombre de demandes limitées par le service en raison du dépassement des limites autorisées du TPS (transactions par seconde) ou des quotas. Ces requêtes sont renvoyées ThrottlingException avec le code d'état HTTP 429.
- SystemErrors
-
Le 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. La résolution de ce problème nécessite l'intervention de l'utilisateur.
- Latence
-
Le 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 de l'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
-
Le nombre total d'utilisateurs qui ont relâché le contrôle
- TakerOverDuration
-
La durée de prise en charge par l'utilisateur
Métriques 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 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 d'un indicateur à l'autre.
Métriques distribuées
Par défaut, Bedrock AgentCore Built-in Tools distribue des statistiques pour le niveau du compte et le niveau de l'outil à une résolution d'une minute. CloudWatch L'agrégation Amazon et la conservation des données métriques suivent 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 processeur virtuel consommée par 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 des comptes. Utile pour le suivi des ressources et la visibilité estimée de la facturation. |
Explication des dimensions
-
Service - AgentCore.CodeInterpreter ou AgentCore.Browser
-
Ressource : identifiant Built-in de 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és à partir des mesures 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és à partir des mesures d'utilisation. Les graphiques représentent l'utilisation totale des ressources pour 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 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 en vente
Amazon Bedrock AgentCore Built-in Tools permet d'activer les journaux distribués 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 mesures actuellement prises en charge incluent :
-
Code Interprefer code Interpreter.vcpu.hours.used et code _hours.used Interpreter.memory.gb
-
Navigateurs 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 de la session. |
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 de la session. |
Pour plus d'informations sur l'activation des journaux, voir 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 Session d' Built-in outils 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
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é.
Données d'envergure fournies
Pour améliorer l'observabilité, AgentCore fournit des intervalles structurés qui fournissent une visibilité sur les API des outils intégrés. Pour activer ces données d'étendue, vous devez activer l'observabilité sur votre ressource d'outils intégrée. 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 leur intégralité dans AWS CloudWatch Logs, dans le groupe de aws/spans journaux. Le tableau suivant définit l'opération pour laquelle les spans sont créées et les attributs de chaque span capturée.
Interprète de code
| Nom de l’opération | Attributs Span | 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 un 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 Span | 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 navigateur. |
|
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 du 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'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 InvokeCodeInterpreter avec champs de suivi, charges utiles de demandes et de réponses |
