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 .

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 :

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 :

Métriques d’utilisation

Ces mesures fournissent des informations sur la manière dont votre passerelle est utilisée.

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 dans le guide de CloudWatch l'utilisateur Amazon. La procédure suivante explique comment afficher les métriques de vos passerelles :

Pour afficher les métriques de passerelle dans la console

Configuration des CloudWatch alarmes

Vous pouvez utiliser le fonctionnement de l'PutMetricAlarmAPI 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é pour en savoir plus.

AgentCore enregistre les informations suivantes pour les ressources de la passerelle :

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 Bedrock Gateway. AgentCore

Exemple de journal :

{
    "resource_arn": "arn:aws:bedrock-agentcore:us-east-1:123456789012:gateway/<gatewayid>",
    "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/<gatewayid>",
    "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 :

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.