AgentCore dados de observabilidade do gateway gerados

As seções a seguir descrevem as métricas, os registros e os intervalos do gateway gerados pela AgentCore Amazon CloudWatch. Essas métricas não estão disponíveis na página CloudWatch generativa de observabilidade da IA. As métricas do gateway são agrupadas em intervalos de um minuto. Para saber mais sobre a visualização das métricas do gateway, consulte Visualizar dados de observabilidade para seus agentes do Amazon Bedrock AgentCore .

Métricas fornecidas

O Gateway publica métricas de invocação e uso no. CloudWatch Você pode visualizar essas métricas e também configurar alarmes para alertá-lo quando determinadas métricas excederem os limites. Para saber mais, selecione um tópico:

Métricas de invocação

Essas métricas fornecem informações sobre invocações, desempenho e erros da API.

Para essas métricas, as seguintes dimensões são usadas:

Métricas de uso

Essas métricas fornecem informações sobre como seu gateway está sendo usado.

Veja as CloudWatch métricas do gateway

Para obter mais informações sobre CloudWatch métricas de visualização, consulte Visualizar métricas disponíveis no Guia CloudWatch do usuário da Amazon. O procedimento a seguir mostra como visualizar as métricas dos seus gateways:

Para visualizar as métricas do gateway no console

Configurando CloudWatch alarmes

Você pode usar a operação da PutMetricAlarmAPI para configurar CloudWatch alarmes para alertá-lo quando determinadas métricas excederem os limites. Por exemplo, talvez você queira ser notificado quando a taxa de erro exceder 5% ou quando a latência exceder 1 segundo.

O exemplo a seguir mostra como criar um alarme para altas taxas de erro usando a 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"

Esse alarme será acionado quando o número de erros do sistema exceder 5 em um período de 5 minutos. Quando o alarme for acionado, ele enviará uma notificação para o tópico SNS especificado.

Dados de registro fornecidos

AgentCore fornece registros que ajudam você a monitorar e solucionar os principais processos de recursos do AgentCore gateway. Para habilitar esses dados de log, você precisa criar um destino de log.

AgentCore pode gerar registros para o CloudWatch fluxo Logs, Amazon S3 ou Firehose. Se você usa um destino de CloudWatch registros, esses registros são armazenados no grupo de registros padrão /aws/vendedlogs/bedrock-agentcore/gateway/APPLICATION_LOGS/{gateway_id} ou em um grupo de registros personalizado começando com/aws/vendedlogs/. Consulte Habilitando a observabilidade para AgentCore tempo de execução, memória, gateway, ferramentas integradas e recursos de identidade para saber mais.

AgentCore registra as seguintes informações para os recursos do gateway:

Você também pode ver os corpos de solicitação e resposta como parte da integração do Vended Logs quando qualquer uma das operações de MCP é executada no Gateway. Eles podem fazer análises adicionais nesses registros, usando os trace_id campos span_id e para conectar os vãos vendidos e os troncos que estão sendo emitidos. Para obter mais informações sobre como criptografar seus gateways com chaves KMS gerenciadas pelo cliente, consulte Recursos e tópicos avançados do Amazon Bedrock Gateway. AgentCore

Log de amostra:

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

Registro de amostra com corpo de resposta:

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

Vãos fornecidos

AgentCore suporta extensões vendidas compatíveis com OTEL que você pode usar para rastrear invocações em diferentes primitivas que estão sendo usadas.

Exemplos de extensões vendidas para invocação de ferramentas:

Para outras invocações do método MCP, somente o kind:SERVER intervalo é emitido.

Embora esses intervalos emitam métricas, para investigar por que uma falha ocorreu em um período específico, um usuário do Gateway deve verificar os registros que são vendidos. Vários campos, por exemplo, spanId aws.request.id podem ajudar a unir esses vãos e troncos.