AgentCore dati di osservabilità del gateway generati

Le seguenti sezioni descrivono le metriche, i log e gli intervalli del gateway inviati ad AgentCore Amazon. CloudWatch Queste metriche non sono disponibili nella pagina sull'osservabilità dell'IA CloudWatch generativa. Le metriche del gateway vengono raggruppate a intervalli di un minuto. Per ulteriori informazioni sulla visualizzazione delle metriche del gateway, consulta Visualizza i dati di osservabilità per i tuoi agenti Amazon AgentCore Bedrock.

Metriche fornite

Gateway pubblica le metriche di invocazione e utilizzo su. CloudWatch Puoi visualizzare queste metriche e anche impostare allarmi per avvisarti quando determinate metriche superano le soglie. Per saperne di più, seleziona un argomento:

Parametri di invocazione

Queste metriche forniscono informazioni sulle chiamate, sulle prestazioni e sugli errori delle API.

Per queste metriche, vengono utilizzate le seguenti dimensioni:

Parametri di utilizzo

Queste metriche forniscono informazioni su come viene utilizzato il gateway.

Visualizza le metriche del gateway CloudWatch

Per ulteriori informazioni sulla visualizzazione dei CloudWatch parametri, consulta Visualizza i parametri disponibili nella Amazon CloudWatch User Guide. La procedura seguente mostra come visualizzare le metriche per i tuoi gateway:

Per visualizzare le metriche del gateway nella console

Configurazione degli allarmi CloudWatch

Puoi utilizzare l'operazione PutMetricAlarmAPI per impostare CloudWatch allarmi per avvisarti quando determinate metriche superano le soglie. Ad esempio, potresti voler ricevere una notifica quando il tasso di errore supera il 5% o quando la latenza supera 1 secondo.

L'esempio seguente mostra come creare un allarme per tassi di errore elevati utilizzando 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"

Questo allarme si attiva quando il numero di errori di sistema supera i 5 in un periodo di 5 minuti. Quando l'allarme si attiva, invierà una notifica all'argomento SNS specificato.

Dati di registro forniti

AgentCore fornisce registri che consentono di monitorare e risolvere i principali processi relativi alle risorse del AgentCore gateway. Per abilitare questi dati di registro, è necessario creare una destinazione di registro.

AgentCore può inviare i log allo stream CloudWatch Logs, Amazon S3 o Firehose. Se si utilizza una destinazione CloudWatch Logs, questi log vengono archiviati nel gruppo di log predefinito /aws/vendedlogs/bedrock-agentcore/gateway/APPLICATION_LOGS/{gateway_id} o in un gruppo di log personalizzato che inizia con. /aws/vendedlogs/ Per ulteriori informazioni, consulta Enabling observability for AgentCore runtime, memory, gateway, strumenti integrati e risorse di identità.

AgentCore registra le seguenti informazioni per le risorse del gateway:

È inoltre possibile visualizzare i corpi delle richieste e delle risposte come parte dell'integrazione con Vend Logs quando una qualsiasi delle operazioni MCP viene eseguita sul Gateway. Possono eseguire ulteriori analisi su questi log, utilizzando i trace_id campi span_id and per collegare gli span vended e i log emessi. Per ulteriori informazioni sulla crittografia dei gateway con chiavi KMS gestite dal cliente, consulta Caratteristiche e argomenti avanzati per Amazon Bedrock Gateway. AgentCore

Registro di esempio:

{
    "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 di esempio con corpo della risposta:

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

Intervalli forniti

AgentCore supporta gli intervalli di vendita conformi a OTEL che è possibile utilizzare per tenere traccia delle invocazioni tra le diverse primitive utilizzate.

Esempi di intervalli di vendita per Tool Invocation:

Per altre chiamate al metodo MCP, viene emesso solo lo kind:SERVER span.

Sebbene questi intervalli emettano parametri, per capire perché si è verificato un errore per un intervallo specifico, un utente del Gateway deve controllare i log forniti. Vari campi, ad esempio, aws.request.id possono aiutare a spanId unire questi intervalli e registri.