View a markdown version of this page

Visualizza i dati di osservabilità per i tuoi agenti Amazon Bedrock AgentCore - Amazon Bedrock AgentCore
Visualizza i dati utilizzando l'osservabilità generativa dell'intelligenza artificiale in Amazon CloudWatchVisualizza altri dati in CloudWatch

Visualizza i dati di osservabilità per i tuoi agenti Amazon Bedrock AgentCore

Dopo aver implementato l'osservabilità nel tuo agente, puoi visualizzare le metriche e le tracce raccolte sia nella pagina di osservabilità dell'IA generativa della CloudWatch console che nei registri. CloudWatch Fai riferimento alle seguenti sezioni per scoprire come visualizzare le metriche per i tuoi agenti.

Visualizza i dati utilizzando l'osservabilità generativa dell'intelligenza artificiale in Amazon CloudWatch

La pagina di osservabilità CloudWatch generativa dell'IA mostra tutte le metriche fornite dal servizio in uscita dal runtime dell' AgentCore agente, nonché i dati derivati da span e trace se hai abilitato la strumentazione nel codice dell'agente. Per visualizzare la dashboard di osservabilità in CloudWatch, apri la pagina Amazon CloudWatch GenAi Observability.

Con l'osservabilità dell'intelligenza artificiale generativa CloudWatch, puoi visualizzare dashboard personalizzate con grafici e altre visualizzazioni dei tuoi dati, oltre a suddivisioni degli errori, visualizzazioni di tracce e altro ancora. Per ulteriori informazioni sull'utilizzo dell'osservabilità generativa dell'IA CloudWatch, incluso come esaminare le sessioni individuali e i dati di tracciamento dei tuoi agenti, consulta gli agenti di Amazon Bedrock AgentCore nella guida per l'utente di Amazon. CloudWatch

Visualizza altri dati in CloudWatch

È inoltre possibile visualizzare tutte le metriche e gli intervalli forniti dal servizio CloudWatch, insieme a qualsiasi metrica generata dal codice dell'agente strumentato.

Per visualizzare questi dati, consulta le seguenti sezioni.

Log

  1. Aprire la console CloudWatch.

  2. Nel riquadro di navigazione a sinistra, espandi Registri e seleziona Gruppi di log

  3. Utilizza il campo di ricerca per trovare il gruppo di log relativo all'agente, alla memoria o alla risorsa gateway.

    AgentCore i gruppi di log degli agenti hanno il seguente formato:

    • Registri standard: output stdout/stderr

      • Posizione:/aws/bedrock-/<agent_id>- agentcore/runtimes<endpoint_name>/[runtime-logs] <UUID>

      • Contiene: errori di runtime, registri delle applicazioni, istruzioni di debug

      • Esempio di utilizzo:

        • print («Richiesta di elaborazione...») # Appare nei log standard

        • logging.info («Richiesta elaborata con successo») # Compare nei log standard

    • Registri strutturati OTEL - Informazioni operative dettagliate

      • Ubicazione<endpoint_name>:/aws/bedrock-agentcore/runtimes/<agent_id>- /otel-rt-logs

      • Contiene: dettagli sull'esecuzione, tracciamento degli errori, dati sulle prestazioni

      • Raccolta automatica: non è richiesto alcun codice aggiuntivo, generato dalla strumentazione ADOT

      • Vantaggi: può includere ID di correlazione che collegano i log alle tracce pertinenti

Tracce e intervalli

Le tracce forniscono visibilità sui percorsi di esecuzione delle richieste tramite il tuo agente:

  • Posizione: il flusso di spans log nel gruppo di log dell'agente (/aws/bedrock-agentcore/runtimes/<agent_id>-<endpoint_name>) o il flusso di default log nel gruppo di aws/spans log per gli agenti che utilizzano la destinazione span condivisa. Per ulteriori informazioni, consulta Span destination for agent ospitati nel runtime di Amazon Bedrock AgentCore .

  • Accesso tramite: CloudWatch Transaction Search console

  • Requisiti: CloudWatch la ricerca delle transazioni deve essere abilitata

Le tracce acquisiscono automaticamente:

  • Sequenze di invocazione degli agenti

  • Integrazione con i componenti del framework (LangChainecc.)

  • Chiamate e risposte LLM

  • Richiamazioni e risultati degli strumenti

  • Percorsi di errore ed eccezioni

Per il tracciamento distribuito tra i servizi, puoi utilizzare intestazioni HTTP standard:

  • AWS X-Ray formato: X-Amzn-Trace-Id: Root=1-5759e988-bd862e3fe1be46a994272793;Parent=53995c3f42cd8ad8;Sampled=1

  • Formato W3C: traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01

Per visualizzare le tracce:

  • Vai alla CloudWatch console

  • Seleziona Transaction Search dalla barra di navigazione a sinistra

  • Filtra per nome del servizio o altri criteri

  • Seleziona una traccia per visualizzare il grafico di esecuzione dettagliato

Metriche

Se hai abilitato l'osservabilità utilizzando la strumentazione del codice dell'agente come descritto in Abilitazione dell' AgentCore osservabilità, l'agente genera automaticamente le metriche OTEL, che vengono inviate CloudWatch utilizzando Enhanced Metric Format (EMF):

  • Spazio dei nomi: bedrock-agentcore

  • CloudWatch Accesso tramite: console Metrics

  • Contenuto: metriche personalizzate generate dal codice e dai framework dell'agente

  • Raccolta automatica: non è richiesto alcun codice aggiuntivo, generato dalla strumentazione ADOT

Oltre alle metriche emesse dagli agenti, il servizio pubblica le metriche di servizio standard su. AgentCore CloudWatch Fai riferimento ai dati di osservabilità AgentCore generati in fase di esecuzione per un elenco di queste metriche.