View a markdown version of this page

AgentCore dati di osservabilità degli strumenti integrati generati - Fondamento Amazon AgentCore

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à degli strumenti integrati generati

metriche degli strumenti di osservabilità

AgentCore fornisce le seguenti metriche integrate per l'interprete di codice e gli strumenti del browser. Built-in le metriche degli strumenti vengono raggruppate a intervalli di un minuto. Per ulteriori informazioni sugli AgentCore strumenti, consulta Esecuzione del codice e analisi dei dati utilizzando Amazon Bedrock AgentCore Code Interpreter e Interazione con le applicazioni Web utilizzando Amazon Bedrock Browser. AgentCore

Strumento Invoke:

Invocazioni

Il numero totale di richieste effettuate all'API Data Plane. Ogni chiamata API conta come una chiamata, indipendentemente dalla dimensione del payload della richiesta o dallo stato della risposta.

Throttles

Il numero di richieste limitate dal servizio a causa del superamento dei limiti TPS (Transactions Per Second) o di quota consentiti. Queste richieste vengono restituite ThrottlingException con il codice di stato HTTP 429.

SystemErrors

Il numero di errori sul lato server riscontrati durante l'elaborazione delle richieste.

UserErrors

Il numero di errori sul lato client derivanti da richieste non valide. Ciò richiede l'intervento dell'utente per risolverlo.

Latenza

Il tempo trascorso tra il momento in cui il servizio riceve la richiesta e il momento in cui inizia a inviare il primo token di risposta. Importante per misurare il tempo di risposta iniziale.

Crea una sessione di utensili:

Invocazioni

Il numero totale di richieste effettuate all'API Data Plane. Ogni chiamata API conta come una chiamata, indipendentemente dalla dimensione del payload della richiesta o dallo stato della risposta.

Throttles

Il numero di richieste limitate dal servizio a causa del superamento dei limiti TPS (Transactions Per Second) o di quota consentiti. Queste richieste vengono restituite ThrottlingException con il codice di stato HTTP 429.

SystemErrors

Il numero di errori sul lato server riscontrati durante l'elaborazione delle richieste.

UserErrors

Il numero di errori sul lato client derivanti da richieste non valide. Ciò richiede l'intervento dell'utente per risolverlo.

Latenza

Il tempo trascorso tra il momento in cui il servizio riceve la richiesta e il momento in cui inizia a inviare il primo token di risposta. Importante per misurare il tempo di risposta iniziale.

Durata

La durata della sessione dell'utensile (l'operazione diventa CodeInterpreterSession/BrowserSession).

Acquisizione da parte dell'utente del browser:

TakerOverCount

Il numero totale di utenti che subentrano

TakerOverReleaseCount

Il numero totale di utenti che rilasciano il controllo

TakerOverDuration

La durata del subentro da parte dell'utente

Metriche e registri sull'utilizzo delle risorse

Amazon Bedrock AgentCore Built-in Tools fornisce una telemetria completa sull'utilizzo delle risorse, comprese le metriche di consumo di CPU e memoria per le risorse di runtime.

Nota

I dati sull'utilizzo delle risorse possono subire ritardi fino a 60 minuti e la precisione può variare a seconda delle metriche.

Metriche vendute

Per impostazione predefinita, Bedrock AgentCore Built-in Tools fornisce le metriche a livello di account e di strumento con una risoluzione di 1 minuto. CloudWatch L'aggregazione e la conservazione dei dati metrici di Amazon seguono le politiche standard di conservazione dei dati di Amazon. CloudWatch Per ulteriori informazioni, consulta #Metric. https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html

Nome Dimensioni Description

CPUUsed-vCPUHours

Servizio; Servizio, Risorsa

La quantità totale di CPU virtuale consumata in v CPU-Hours unit, disponibile a livello di risorsa e account. Utile per il monitoraggio delle risorse e la visibilità stimata della fatturazione.

MemoryUsed-GBHours

Servizio; Servizio, Risorsa

La quantità totale di memoria consumata in GB-Hours unità, disponibile a livello di risorsa e account. Utile per il monitoraggio delle risorse e la visibilità stimata della fatturazione.

Spiegazione delle dimensioni

  • Servizio - AgentCore.CodeInterpreter o AgentCore.Browser

  • Risorsa: ID Built-in dello strumento

Le metriche a livello di account sono disponibili nella console di Amazon CloudWatch Bedrock AgentCore Observability nella scheda Built-in Strumenti. La dashboard sulla console conterrà un grafico sull'utilizzo della memoria e un grafico sull'utilizzo della CPU generato dalle metriche di utilizzo. Questi grafici rappresentano l'utilizzo totale delle risorse tra tutti gli strumenti del tipo di strumento selezionato nell'account nella regione.

Le metriche a livello di strumento sono disponibili nella pagina Strumenti della Amazon CloudWatch Bedrock AgentCore Observability Console. La dashboard sulla console conterrà un grafico sull'utilizzo della memoria e un grafico sull'utilizzo della CPU generato dalle metriche di utilizzo. I grafici rappresentano l'utilizzo totale delle risorse in tutte le sessioni dello strumento selezionato.

Nota

I dati di telemetria vengono forniti a scopo di monitoraggio. La fatturazione effettiva viene calcolata in base ai dati di utilizzo misurati e può differire dai valori di telemetria a causa dei tempi di aggregazione, dei processi di riconciliazione e della precisione delle misurazioni. Fai riferimento al tuo estratto conto per gli addebiti autorevoli. AWS

Registri venduti

Amazon Bedrock AgentCore Built-in Tools offre la possibilità di abilitare i log venduti per la telemetria dell'utilizzo a livello di sessione con una granularità di 1 secondo. Ogni record di log contiene un dato di utilizzo delle risorse di 1 secondo. Le metriche attualmente supportate includono:

  • Code Interprefer code Interpreter.vcpu.hours.used e code _hours.used Interpreter.memory.gb

  • Browser browser.vcpu.hours.used e browser.memory.gb_hours.used

Ogni dato di utilizzo delle risorse utilizzerà il seguente schema nel record di registro.

Interprete di codice

Tipo di log Campi di log Description

USAGE_LOGS

event_timestamp, resource_arn, service.name, cloud.provider, cloud.region, account.id, region, resource.id, session.id, elapsed_time_seconds, code, code _hours.used Interpreter.vcpu.hours.used Interpreter.memory.gb

Registri sull'utilizzo delle risorse per il monitoraggio delle risorse a livello di sessione.

Browser

Tipo di log Campi di log Description

USAGE_LOGS

event_timestamp, resource_arn, service.name, cloud.provider, cloud.region, account.id, region, resource.id, session.id, elapsed_time_seconds, browser.vcpu.hours.used, browser.memory.gb_hours.used

Registri di utilizzo delle risorse per il monitoraggio delle risorse a livello di sessione.

Per ulteriori informazioni sull'attivazione dei log, consulta Aggiungere l'osservabilità alle tue risorse Amazon Bedrock. AgentCore Questi log vengono quindi visualizzati nella destinazione così come configurata (Amazon S3 o Amazon AWS LogGroup Kinesis Firehose).

Nella pagina Built-in Tools Session della Amazon CloudWatch Bedrock AgentCore Observability Console, puoi visualizzare le metriche sull'utilizzo delle risorse generate da questi log. Per ottimizzare l'esperienza di visualizzazione delle metriche, seleziona l'intervallo di tempo desiderato utilizzando il selettore in alto a destra per concentrarti su dati specifici di CPU e utilizzo della memoria.

Nota

I dati di telemetria vengono forniti a scopo di monitoraggio. La fatturazione effettiva viene calcolata in base ai dati di utilizzo misurati e può differire dai valori di telemetria a causa dei tempi di aggregazione, dei processi di riconciliazione e della precisione delle misurazioni. Fai riferimento al tuo estratto conto per gli addebiti autorevoli. AWS

Dati di intervallo forniti

Per migliorare l'osservabilità, AgentCore fornisce intervalli strutturati che forniscono visibilità nelle API degli strumenti integrati. Per abilitare questo intervallo di dati, devi abilitare l'osservabilità sulla tua risorsa di strumenti integrata. Consulta Aggiungere l'osservabilità alle tue AgentCore risorse Amazon Bedrock per passaggi e dettagli. Questi dati di intervallo sono disponibili per intero in AWS CloudWatch Logs nel gruppo di log. aws/spans La tabella seguente definisce l'operazione per la quale vengono creati gli intervalli e gli attributi per ogni intervallo acquisito.

Interprete di codice

Nome operazione Attributi Span Description

StartCodeInterpreterSession

aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type

Avvia una sessione di interprete di codice.

StopCodeInterpreterSession

aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type, session_duration_s

Interrompe una sessione di interprete di codice.

InvokeCodeInterpreter

aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type

Richiama un interprete di codice con codice di input.

CodeInterpreterSessionExpire

aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type, session_duration_s

Fa scadere una sessione dell'interprete di codice se StopCodeInterpreterSession non viene chiamata e la sessione scade.

  • toolsession.id: l'id della sessione dello strumento

  • session_duration_s - la durata della sessione in secondi prima della fine

Browser

Nome operazione Attributi Span Description

StartBrowserSession

aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type

Avvia una sessione del browser.

StopBrowserSession

aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type, session_duration_s

Interrompe una sessione del browser.

ConnectBrowserAutomationStream

aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type

Connettiti a uno stream di automazione del browser.

BrowserSessionExpire

aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type, session_duration_s

Fa scadere una sessione dell'interprete di codice se StopBrowserSession non viene chiamata e la sessione scade.

Dati di registro dell'applicazione

AgentCore fornisce registri strutturati delle applicazioni che consentono di ottenere visibilità sulle chiamate di runtime degli agenti e sul consumo di risorse a livello di sessione. Questi dati di registro vengono forniti quando si abilita l'osservabilità sulla risorsa dell'agente. Consulta Aggiungere l'osservabilità alle tue AgentCore risorse Amazon Bedrock per passaggi e dettagli. AgentCore può inviare CloudWatch log su Logs, Amazon S3 o Firehose stream. Se utilizzi una destinazione CloudWatch Logs, questi log vengono archiviati nei log dell'applicazione del tuo agente o nel tuo gruppo di log personalizzato.

Tipo di log Campi di log Description

APPLICATION_LOGS

timestamp, resource_arn, event_timestamp, account_id, request_id, session_id, trace_id, span_id, service_name, operation, request_payload, response_payload

Registri delle applicazioni InvokeCodeInterpreter con campi di tracciamento e payload di richiesta e risposta