# AgentCore données d'observabilité de la passerelle générées
Les sections suivantes décrivent les métriques, les journaux et les intervalles de passerelle AgentCore envoyés par Amazon CloudWatch. Ces statistiques ne sont pas disponibles sur la page d'observabilité de l'IA CloudWatch générative. Les métriques de la passerelle sont regroupées à intervalles d'une minute. Pour en savoir plus sur l'affichage des métriques de passerelle, consultez [Afficher les données d'observabilité de vos agents Amazon Bedrock AgentCore ](observability-view.md).
**Note**
Pour activer les journaux fournis par le service pour les AgentCore passerelles, vous devez configurer les ressources nécessaires. CloudWatch Consultez [Activer l'observabilité pour l' AgentCore exécution, la mémoire, la passerelle, les outils intégrés et les ressources d'identité](observability-configure.md#observability-configure-cloudwatch) pour en savoir plus.
**Topics**
+ [Métriques fournies](#observability-gateway-metrics-provided)
+ [Données de journal fournies](#observability-gateway-logs-provided)
+ [Portées fournies](#observability-gateway-vended-spans)
## Métriques fournies
Gateway publie des statistiques d'invocation et d'utilisation sur CloudWatch. Vous pouvez consulter ces mesures et également configurer des alarmes pour vous avertir lorsque certaines mesures dépassent les seuils. Pour en savoir plus, sélectionnez un sujet :
**Topics**
+ [Métriques d’invocation](#gateway-metrics-invocation)
+ [Métriques d’utilisation](#gateway-metrics-usage)
+ [Afficher les CloudWatch métriques de la passerelle](#gateway-metrics-view-console)
+ [Configuration des CloudWatch alarmes](#gateway-advanced-observability-alarms)
### Métriques d’invocation
Ces métriques fournissent des informations sur les appels d'API, les performances et les erreurs.
Pour ces mesures, les dimensions suivantes sont utilisées :
+ **Opération** : nom de l'opération d'API (ex. InvokeGateway).
+ **Protocole** — Le nom du protocole (ex. MCP).
+ **Méthode** — Représente l'opération MCP invoquée (ex. tools/list).
+ **Ressource** — Représente l'identifiant de la ressource (par exemple, l'ARN de la passerelle).
+ **Nom** — Représente le nom de l'outil.
| Métrique | Description | Statistiques | Uunités |
| --- | --- | --- | --- |
| Invocations | Le nombre total de demandes adressées à chaque API Data Plane. Chaque appel d'API compte comme un appel quel que soit le statut de la réponse. | Somme | Nombre |
| Throttles | Le nombre de demandes limitées (code d'état 429) par le service. | Somme | Nombre |
| SystemErrors | Le nombre de demandes qui ont échoué avec le code d'état 5xx. | Somme | Nombre |
| UserErrors | Le nombre de demandes qui ont échoué avec le code d'état 4xx sauf 429. | Somme | Nombre |
| 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. En d'autres termes, le temps de réponse initial. | Moyenne, minimale, maximale, p50, p90, p99 | Millisecondes |
| Duration | Le 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. | Moyenne, minimale, maximale, p50, p90, p99 | Millisecondes |
| TargetExecutionTime | Le temps total nécessaire pour exécuter la cible sur Lambda/ OpenAPI/etc. Cela permet de déterminer la contribution de la cible à la latence totale. | Moyenne, minimale, maximale, p50, p90, p99 | Millisecondes |
### Métriques d’utilisation
Ces mesures fournissent des informations sur la manière dont votre passerelle est utilisée.
| Métrique | Description | Statistiques | Uunités |
| --- | --- | --- | --- |
| TargetType | Le nombre total de requêtes traitées par chaque type de cible (MCP, Lambda, OpenAPI). | Somme | Nombre |
### Afficher les CloudWatch métriques de la passerelle
Pour plus d'informations sur l'affichage CloudWatch des métriques, consultez la section [Afficher les métriques disponibles](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html) dans le [guide de CloudWatch l'utilisateur Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/). La procédure suivante explique comment afficher les métriques de vos passerelles :
**Pour afficher les métriques de passerelle dans la console**
1. Ouvrez la CloudWatch console à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Dans le volet de navigation de gauche, choisissez **Toutes les mesures** dans la section **Mesures**.
1. Sous **Parcourir**, dans le menu déroulant qui affiche la AWS région actuelle, sélectionnez la région pour laquelle vous souhaitez obtenir des statistiques.
1. Choisissez l’espace de nom **AWS/Bedrock-AgentCore**.
1. Choisissez une dimension (ex. **Fonctionnement**) ou combinaison de dimensions (ex. **Méthode, opération, protocole**) pour afficher les métriques correspondantes.
1. Pour ajouter une métrique au CloudWatch graphique, cochez la case à côté de celle-ci.
### Configuration des CloudWatch alarmes
Vous pouvez utiliser le fonctionnement de l'[PutMetricAlarm](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html)API pour configurer des CloudWatch alarmes afin de vous avertir lorsque certaines mesures dépassent les seuils. Par exemple, vous souhaiterez peut-être être averti lorsque le taux d'erreur dépasse 5 % ou lorsque la latence dépasse 1 seconde.
L'exemple suivant montre comment créer une alarme en cas de taux d'erreur élevés à l'aide de la AWS CLI :
```
aws cloudwatch put-metric-alarm \
--alarm-name "HighErrorRate" \
--alarm-description "Alarm when error rate exceeds 5%" \
--metric-name "SystemErrors" \
--namespace "AWS/Bedrock-AgentCore" \
--statistic "Sum" \
--dimensions "Name=Resource,Value=my-gateway-arn" \
--period 300 \
--evaluation-periods 1 \
--threshold 5 \
--comparison-operator "GreaterThanThreshold" \
--alarm-actions "arn:aws:sns:us-west-2:123456789012:my-topic"
```
Cette alarme se déclenche lorsque le nombre d'erreurs du système dépasse 5 sur une période de 5 minutes. Lorsque l'alarme se déclenche, elle envoie une notification au sujet SNS spécifié.
## Données de journal fournies
AgentCore fournit des journaux qui vous aident à surveiller et à résoudre les problèmes liés aux principaux processus liés aux ressources de la AgentCore passerelle. Pour activer ces données de journal, vous devez créer une destination de journal.
AgentCore peut générer des CloudWatch journaux vers Logs, Amazon S3 ou Firehose Stream. Si vous utilisez une destination de CloudWatch journaux, ces journaux sont stockés dans le groupe de journaux par défaut `/aws/vendedlogs/bedrock-agentcore/gateway/APPLICATION_LOGS/{gateway_id}` ou dans un groupe de journaux personnalisé commençant par`/aws/vendedlogs/`. Consultez [Activer l'observabilité pour l' AgentCore exécution, la mémoire, la passerelle, les outils intégrés et les ressources d'identité](observability-configure.md#observability-configure-cloudwatch) pour en savoir plus.
AgentCore enregistre les informations suivantes pour les ressources de la passerelle :
+ Début et fin du traitement des demandes de passerelle
+ Messages d'erreur pour les configurations Target
+ Demandes MCP avec en-têtes d'autorisation manquants ou incorrects
+ Demandes MCP avec des paramètres de demande incorrects (outils, méthode)
Vous pouvez également consulter les corps de demande et de réponse dans le cadre de votre intégration à Vended Logs lorsque l'une des opérations MCP est effectuée sur la passerelle. Ils peuvent effectuer une analyse plus approfondie de ces journaux, en utilisant les `trace_id` champs `span_id` et pour relier les spans vendus aux journaux émis. Pour plus d'informations sur le chiffrement de vos passerelles à l'aide de clés KMS gérées par le client, consultez [Fonctionnalités avancées et rubriques relatives à Amazon](gateway-advanced.md) Bedrock Gateway. AgentCore
Exemple de journal :
```
{
"resource_arn": "arn:aws:bedrock-agentcore:us-east-1:123456789012:gateway/",
"event_timestamp": 1759370851622,
"body": {
"isError": false,
"log": "Started processing request with requestId: 1",
"requestBody": "{id=1, jsonrpc=2.0, method=tools/call, params={name=target-quick-start-f9scus___LocationTool, arguments={location=seattle}}}",
"id": "1"
},
"account_id": "123456789012",
"request_id": "12345678-1234-1234-1234-123456789012",
"trace_id": "160fc209c3befef4857ab1007d041db0",
"span_id": "81346de89c725310"
}
```
Exemple de journal avec le corps de la réponse :
```
{
"resource_arn": "arn:aws:bedrock-agentcore:us-east-1:123456789012:gateway/",
"event_timestamp": 1759370853807,
"body": {
"isError": false,
"responseBody": "{jsonrpc=2.0, id=1, result={isError=false, content=[{type=text, text=\"good\"}]}}",
"log": "Successfully processed request with requestId: 2",
"id": "1"
},
"account_id": "123456789012",
"request_id": "12345678-1234-1234-1234-123456789012",
"trace_id": "160fc209c3befef4857ab1007d041db0",
"span_id": "81346de89c725310"
}
```
## Portées fournies
AgentCore prend en charge les intervalles de vente conformes à la norme OTEL que vous pouvez utiliser pour suivre les invocations entre les différentes primitives utilisées.
Exemples d'intervalles distribués pour l'invocation d'outils :
+ `kind:SERVER`- suit les détails généraux de l'exécution, l'outil invoqué, les détails de la passerelle, l'ID de AWS demande, l'ID de trace et l'ID de span.
+ `kind:CLIENT`- couvre la cible spécifique qui a été invoquée et les détails qui la concernent, tels que le type de cible, le temps d'exécution de la cible, les heures de début et de fin de l'exécution de la cible, etc.
Pour les autres invocations de méthode MCP, seul le `kind:SERVER` span est émis.
Bien que ces intervalles émettent des métriques, pour déterminer pourquoi une défaillance s'est produite pendant une période spécifique, un utilisateur de Gateway doit consulter les journaux vendus. Différents champs, par exemple, `spanId` `aws.request.id` peuvent aider à assembler ces travées et ces bûches.
| Opération | Attributs d'envergure | Description |
| --- | --- | --- |
| Outils de liste | aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, gateway.id, aws.xray.origin, aws.resource.type, aws.region, latency\_ms, error\_type, jsonrpc.error.code, http.response.status\_code, gateway.name, url.path, overhead\_lat\_code ency\_ms | Lister les outils associés à une passerelle |
| Outil d'appel | aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, gateway.id, aws.xray.origin, aws.resource.type, aws.region, latency\_ms, error\_type, jsonrpc.error.code, http.response.status\_code, gateway.name, url.path, overhead\_lat\_code ency\_ms, nom de l'outil | Appelez un outil spécifique. Deux portées sont émises : 1. `kind:SERVER`qui suit les détails généraux de l'exécution (réussite ou non), l'outil invoqué, les détails de la passerelle, l'ID de AWS demande, l'ID de trace et l'ID de durée. 2. `kind:CLIENT`qui couvre la cible spécifique qui a été invoquée et les détails qui la concernent, tels que le type de cible, le temps d'exécution de la cible, les heures de début et de fin de l'exécution de la cible, etc. |
| Outils de recherche | aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, gateway.id, aws.xray.origin, aws.resource.type, aws.region, latency\_ms, error\_type, jsonrpc.error.code, http.response.status\_code, gateway.name, url.path, overhead\_lat\_code ency\_ms, nom de l'outil | Recherchez les dix outils les plus pertinents à partir d'une requête d'entrée |