Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

AgentCore dati di osservabilità del gateway generati

Le sezioni seguenti descrivono le metriche, i log e gli intervalli del gateway inviati AgentCore ad Amazon. CloudWatch Queste metriche non sono disponibili nella pagina di 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 Visualizzare i dati di osservabilità per i tuoi agenti Amazon Bedrock. AgentCore

Metriche fornite

Gateway pubblica le metriche di richiamo 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 alle API, sulle prestazioni e sugli errori.

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 delle CloudWatch metriche, consulta Visualizza le metriche 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

Impostazione degli allarmi CloudWatch

Puoi utilizzare l'operazione PutMetricAlarm API per impostare CloudWatch allarmi che ti avvisino 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 CLI: AWS

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 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 problemi relativi alle principali risorse del AgentCore gateway. Per abilitare questi dati di registro, è necessario creare una destinazione di registro.

AgentCore può inviare i CloudWatch log a Logs, Amazon S3 o Firehose stream. Se utilizzi 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 saperne di AgentCore più, consulta Abilitazione dell'osservabilità per runtime, memory, gateway, strumenti integrati e risorse di identità.

AgentCore registra le seguenti informazioni per le risorse del gateway:

Puoi anche visualizzare gli organi di richiesta e risposta come parte della tua integrazione con Vended Logs quando una qualsiasi delle operazioni MCP viene eseguita sul Gateway. Possono effettuare ulteriori analisi su questi log, utilizzando i trace_id campi span_id and per collegare gli intervalli di distribuzione e i log emessi. Per ulteriori informazioni sulla crittografia dei gateway con chiavi KMS gestite dal cliente, consulta Funzionalità e argomenti avanzati per Amazon Bedrock Gateway. AgentCore

Esempio di registro:

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

Esempio di registro 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 vended conformi a OTEL che è possibile utilizzare per tenere traccia delle invocazioni su diverse primitive utilizzate.

Esempi di intervalli forniti per Tool Invocation:

Per altre chiamate al metodo MCP, viene emesso solo l'kind:SERVERintervallo.

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