Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

AgentCore datos de observabilidad de pasarelas generados

En las siguientes secciones se describen las métricas, los registros y los intervalos de Gateway enviados AgentCore a Amazon. CloudWatch Estas métricas no están disponibles en la página de observabilidad de la IA CloudWatch generativa. Las métricas de Gateway se agrupan en lotes en intervalos de un minuto. Para obtener más información sobre la visualización de las métricas de Gateway, consulte Ver los datos de observabilidad de sus agentes de Amazon Bedrock AgentCore .

Métricas proporcionadas

Gateway publica las métricas de invocación y uso en CloudWatch. Puede ver estas métricas y también configurar alarmas para que le avisen cuando determinadas métricas superen los umbrales. Para obtener más información, selecciona un tema:

Métricas de invocación

Estas métricas proporcionan información sobre las invocaciones, el rendimiento y los errores de la API.

Para estas métricas, se utilizan las siguientes dimensiones:

Métricas de uso

Estas métricas proporcionan información sobre cómo se utiliza su puerta de enlace.

Ver las métricas de la pasarela CloudWatch

Para obtener más información sobre la visualización de CloudWatch las métricas, consulte Ver las métricas disponibles en la Guía del CloudWatch usuario de Amazon. El siguiente procedimiento muestra cómo ver las métricas de sus pasarelas:

Para ver las métricas de las puertas de enlace en la consola

Configuración de alarmas CloudWatch

Puedes usar la operación de la PutMetricAlarm API para configurar CloudWatch alarmas que te avisen cuando determinadas métricas superen los umbrales. Por ejemplo, es posible que desees recibir una notificación cuando la tasa de errores supere el 5% o cuando la latencia supere 1 segundo.

En el siguiente ejemplo, se muestra cómo crear una alarma para tasas de error altas mediante 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"

Esta alarma se activará cuando el número de errores del sistema supere los 5 en un período de 5 minutos. Cuando se active la alarma, se enviará una notificación al tema de SNS especificado.

Datos de registro proporcionados

AgentCore proporciona registros que le ayudan a supervisar y solucionar problemas en los procesos clave de los recursos de la AgentCore puerta de enlace. Para habilitar estos datos de registro, debe crear un destino de registro.

AgentCore puede enviar los CloudWatch registros a Logs, Amazon S3 o Firehose Stream. Si utiliza un destino de CloudWatch registros, estos registros se almacenan en el grupo de registros predeterminado /aws/vendedlogs/bedrock-agentcore/gateway/APPLICATION_LOGS/{gateway_id} o en un grupo de registros personalizado empezando /aws/vendedlogs/ por. Consulta Cómo habilitar la observabilidad AgentCore de los recursos de tiempo de ejecución, memoria, puerta de enlace, herramientas integradas y identidad para obtener más información.

AgentCore registra la siguiente información para los recursos de la puerta de enlace:

También puedes ver los cuerpos de solicitud y respuesta como parte de tu integración con Vended Logs cuando se realiza alguna de las operaciones de MCP en el Gateway. Pueden analizar más a fondo estos registros utilizando los trace_id campos span_id y para conectar los intervalos vendidos con los registros que se están emitiendo. Para obtener más información sobre cómo cifrar sus puertas de enlace con claves de KMS administradas por el cliente, consulte las funciones y los temas avanzados de Amazon Bedrock Gateway. AgentCore

Registros de ejemplo:

{
    "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"
}

Ejemplo de registro con el cuerpo de la respuesta:

{
    "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"
}

Intervalos proporcionados

AgentCore admite intervalos de distribución compatibles con OTEL, que puedes usar para rastrear las invocaciones en las diferentes primitivas que se están utilizando.

Ejemplos de intervalos de tiempo vendidos para la invocación de herramientas:

Para otras invocaciones de métodos MCP, solo se emite el kind:SERVER intervalo.

Si bien estos intervalos emiten métricas, para investigar por qué se produjo un error en un intervalo específico, el usuario de Gateway debe comprobar los registros enviados. Varios campos, por ejemplo, spanId o aws.request.id pueden ayudar a unir estos intervalos y troncos.