AgentCore datos de observabilidad de la puerta de enlace generados

En las siguientes secciones se describen las métricas, los registros y los intervalos de la puerta de enlace AgentCore que envía a Amazon CloudWatch. Estas métricas no están disponibles en la página de observabilidad CloudWatch generativa de la IA. Las métricas de Gateway se agrupan en lotes a intervalos de un minuto. Para obtener más información sobre cómo ver las métricas de gateway, consulte Ver 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, consulta Ver las métricas disponibles en la Guía del CloudWatch usuario de Amazon. El siguiente procedimiento le muestra cómo ver las métricas de sus pasarelas:

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

Configurar alarmas CloudWatch

Puede utilizar la operación de la PutMetricAlarmAPI para configurar CloudWatch alarmas que le 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.

El siguiente ejemplo 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, enviará una notificación al tema de SNS especificado.

Datos de registro proporcionados

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

AgentCore puede enviar 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 que comience por. /aws/vendedlogs/ Consulte Habilitar la observabilidad para el AgentCore tiempo de ejecución, la memoria, la puerta de enlace, las herramientas integradas y los recursos de identidad para obtener más información.

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

También puedes ver los cuerpos de las solicitudes y las respuestas como parte de tu integración con Vended Logs cuando se realiza alguna de las operaciones de MCP en la pasarela. Pueden realizar un análisis más detallado de estos registros, utilizando los trace_id campos span_id y para conectar los intervalos de venta y los registros que se están emitiendo. Para obtener más información sobre el cifrado de sus puertas de enlace con claves de KMS administradas por el cliente, consulte Características y 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 venta compatibles con OTEL que se pueden utilizar para realizar un seguimiento de las invocaciones en las diferentes primitivas que se estén utilizando.

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

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

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