View a markdown version of this page

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

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à.

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 log. CloudWatch Fai riferimento alle sezioni seguenti per scoprire come visualizzare le metriche per i tuoi agenti.

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

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

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

Visualizza altri dati in CloudWatch

È inoltre possibile visualizzare tutte le metriche e gli intervalli forniti dal servizio CloudWatch, insieme a tutte le metriche emesse 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 Logs e seleziona Log groups

  3. Usa il campo di ricerca per trovare il gruppo di log per il tuo agente, memoria o risorsa gateway.

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

    • Log standard - stdout/stderr output

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

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

      • Esempio di utilizzo:

        • print («Elaborazione della richiesta...») # Viene visualizzato nei registri standard

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

    • Log strutturati OTEL - Informazioni dettagliate sul funzionamento

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

      • Contiene: dettagli di 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 l'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 dello span condiviso. Per ulteriori informazioni, consulta Span destination per gli agenti ospitati nel runtime di Amazon AgentCore Bedrock.

  • Accesso tramite: CloudWatch Transaction Search console

  • Requisiti: CloudWatch la ricerca delle transazioni deve essere abilitata

Le tracce acquisiscono automaticamente:

  • Sequenze di richiamo degli agenti

  • Integrazione con i componenti del framework (LangChainecc.)

  • Chiamate e risposte LLM

  • Richiami e risultati degli strumenti

  • Percorsi di errore ed eccezioni

Per il tracciamento distribuito tra i servizi, puoi utilizzare le 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:

  • Passa alla CloudWatch console

  • Seleziona Transaction Search dalla barra di navigazione a sinistra

  • Filtra in base al nome del servizio o ad altri criteri

  • Seleziona una traccia per visualizzare il grafico di esecuzione dettagliato

Metriche

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

  • Spazio dei nomi: bedrock-agentcore

  • CloudWatch Accesso tramite: console Metrics

  • Contenuti: 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 dall'agente, il servizio pubblica le metriche di servizio standard su. AgentCore CloudWatch Fai riferimento ai dati di osservabilità in fase di esecuzione AgentCore generati per un elenco di queste metriche.