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
Argomenti
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 |