As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

AgentCore dados de observabilidade do gateway gerados

As seções a seguir descrevem as métricas, os registros e os intervalos do gateway enviados 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 de métricas de 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 em. 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.

Exibir CloudWatch métricas do gateway

Para obter mais informações sobre a visualização de CloudWatch métricas, consulte Exibir 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 PutMetricAlarm API 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 do SNS especificado.

Dados de registro fornecidos

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

AgentCore pode enviar registros para CloudWatch Logs, Amazon S3 ou Firehose stream. Se você usar um destino de CloudWatch registros, esses registros serã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 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 do MCP é executada no Gateway. Eles podem fazer uma análise mais aprofundada desses registros, usando os trace_id campos span_id e para conectar os períodos distribuídos e os registros 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 períodos 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.