AgentCore dati di osservabilità generati dagli strumenti integrati
Argomenti
strumenti di osservabilità, metriche
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 con Amazon Bedrock AgentCore Code Interpreter e Interazione con le applicazioni Web utilizzando Amazon AgentCore Bedrock Browser.
Strumento Invoke:
- Invocazioni
-
Il numero totale di richieste effettuate all'API Data Plane. Ogni chiamata API conta come un'unica chiamata, indipendentemente dalla dimensione del payload della richiesta o dallo stato della risposta.
- Throttles
-
Il numero di richieste rallentate dal servizio a causa del superamento dei limiti di quota o TPS (Transactions Per Second) consentiti. Queste richieste restituiscono il codice di stato HTTP ThrottlingException 429.
- SystemErrors
-
Il numero di errori sul lato server riscontrati durante l'elaborazione della richiesta.
- UserErrors
-
Il numero di errori sul lato client derivanti da richieste non valide. Ciò richiede l'intervento dell'utente per la risoluzione.
- Latenza
-
Il tempo trascorso tra il momento in cui il servizio riceve la richiesta e l'inizio dell'invio del primo token di risposta. Importante per misurare il tempo di risposta iniziale.
Crea sessione utensile:
- Invocazioni
-
Il numero totale di richieste effettuate all'API Data Plane. Ogni chiamata API conta come un'unica chiamata, indipendentemente dalla dimensione del payload della richiesta o dallo stato della risposta.
- Throttles
-
Il numero di richieste rallentate dal servizio a causa del superamento dei limiti di quota o TPS (Transactions Per Second) consentiti. Queste richieste restituiscono il codice di stato HTTP ThrottlingException 429.
- SystemErrors
-
Il numero di errori sul lato server riscontrati durante l'elaborazione della richiesta.
- UserErrors
-
Il numero di errori sul lato client derivanti da richieste non valide. Ciò richiede l'intervento dell'utente per la risoluzione.
- Latenza
-
Il tempo trascorso tra il momento in cui il servizio riceve la richiesta e l'inizio dell'invio del 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 della presa del controllo 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, inclusi i parametri 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 potrebbe variare a seconda dei parametri.
Metriche vendute
Per impostazione predefinita, Bedrock AgentCore Built-in Tools fornisce le metriche a livello di account e strumento con una risoluzione di 1 minuto. CloudWatch L'aggregazione di Amazon e la conservazione dei dati metrici seguono le politiche standard di conservazione CloudWatch dei dati di Amazon. 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 nell'CPU-Hours unità v, 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 Amazon CloudWatch Bedrock AgentCore Observability Console nella scheda Built-in Strumenti. La dashboard sulla console conterrà un grafico sull'utilizzo della memoria e un grafico sull'utilizzo della CPU generato dai parametri 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 generati dai parametri 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 sulla base dei dati di utilizzo misurati e può differire dai valori di telemetria a causa dei tempi di aggregazione, dei processi di riconciliazione e della precisione di misurazione. Fai riferimento alla tua dichiarazione di fatturazione 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 registro contiene un dato di utilizzo delle risorse di 1 secondo. Le metriche attualmente supportate includono:
-
Codice Code Interprefer Interpreter.vcpu.hours.used e code _hours.used Interpreter.memory.gb
-
Browser.vcpu.hours.used e browser.memory.gb_hours.used
Ogni dato di utilizzo delle risorse utilizzerà lo schema seguente 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 di 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, browser.memory.gb_hours.used |
Registri di utilizzo delle risorse per il monitoraggio delle risorse a livello di sessione. |
Per ulteriori informazioni sull'abilitazione dei log, consulta Aggiungere osservabilità alle risorse Amazon AgentCore Bedrock. Questi log vengono quindi visualizzati nella destinazione così come configurati (AWS LogGroupAmazon S3 o Amazon Kinesis Firehose).
Nella pagina Built-in Tools Session di Amazon CloudWatch Bedrock AgentCore Observability Console, puoi vedere i parametri di utilizzo delle risorse generati 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 sull'utilizzo della CPU e della memoria.
Nota
I dati di telemetria vengono forniti a scopo di monitoraggio. La fatturazione effettiva viene calcolata sulla base dei dati di utilizzo misurati e può differire dai valori di telemetria a causa dei tempi di aggregazione, dei processi di riconciliazione e della precisione di misurazione. Fai riferimento alla tua dichiarazione di fatturazione per gli addebiti autorevoli. AWS
Dati di ampiezza forniti
Per migliorare l'osservabilità, AgentCore fornisce intervalli strutturati che forniscono visibilità nelle API degli strumenti integrati. Per abilitare questi dati di estensione, è necessario abilitare l'osservabilità sulla risorsa di strumenti integrata. Per istruzioni e dettagli, consulta Aggiungere osservabilità alle AgentCore risorse Amazon Bedrock. Questi dati relativi all'intervallo sono disponibili per intero in AWS CloudWatch Logs nel gruppo log. aws/spans La tabella seguente definisce l'operazione per cui 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 di 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 |
Connect a un flusso 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 di interprete di codice se StopBrowserSession non viene chiamata e la sessione scade. |
Dati del registro dell'applicazione
AgentCore fornisce registri delle applicazioni strutturati che consentono di ottenere visibilità sulle chiamate in fase di esecuzione 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. Per istruzioni e dettagli, consulta Aggiungere osservabilità alle AgentCore risorse Amazon Bedrock. AgentCore può inviare i log allo stream CloudWatch Logs, Amazon S3 o Firehose. Se utilizzi una destinazione CloudWatch Logs, questi log vengono archiviati nei log delle applicazioni 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, nome_servizio, operazione, request_payload, response_payload |
Registri delle applicazioni InvokeCodeInterpreter con campi di tracciamento, payload di richieste e risposte |
