AgentCore generare dati di osservabilità della memoria
Per il tipo di risorsa di AgentCore memoria, AgentCore invia i parametri ad Amazon CloudWatch per impostazione predefinita. AgentCore emette anche un set predefinito di intervalli e log, se li abiliti. Vedi Enabling observability for AgentCore runtime, memory, gateway, strumenti integrati e risorse di identità per ulteriori informazioni sull'abilitazione di span e log.
Fai riferimento alle sezioni seguenti per saperne di più sui dati di osservabilità forniti per gli archivi di memoria degli agenti.
Metriche di memoria fornite
Il tipo AgentCore di risorsa di memoria fornisce le seguenti metriche per impostazione predefinita.
- Latenza
-
Il tempo totale trascorso tra la ricezione della richiesta e l'invio del token di risposta finale. Rappresenta l'elaborazione completa end-to-end della richiesta.
- Invocazioni
-
Il numero totale di richieste API effettuate al piano dati e al piano di controllo. Questa metrica tiene traccia anche del numero di eventi di ingestione della memoria.
- Errori di sistema
-
Numero di chiamate che generano errori sul AWS lato server.
- Errori dell'utente
-
Numero di invocazioni che provocano errori sul lato client.
- Errori
-
Numero totale di errori che si verificano durante l'elaborazione delle richieste API nel piano dati e nel piano di controllo. Questa metrica tiene traccia anche degli errori totali che si verificano durante l'ingestione della memoria.
- Throttles
-
Numero di invocazioni limitate dal sistema. Le richieste limitate vengono conteggiate come invocazioni, errori ed errori degli utenti.
- Numero di creazioni
-
Conta il numero di eventi di memoria e record di memoria creati.
Dati di ampiezza forniti
Per migliorare l'osservabilità, AgentCore fornisce intervalli strutturati che tracciano la relazione tra gli eventi e le memorie che generano o a cui accedono. Per abilitare questi dati di estensione, è necessario strumentare il codice dell'agente. Per ulteriori informazioni, consulta Aggiungere osservabilità alle AgentCore risorse Amazon Bedrock.
Questi dati relativi all'intervallo sono disponibili per intero in CloudWatch Logs and Application Signals. CloudWatch Per ulteriori informazioni sulla visualizzazione dei dati di osservabilità, consulta Visualizza i dati di osservabilità per i tuoi agenti Amazon AgentCore Bedrock.
La tabella seguente definisce le operazioni per le quali vengono creati gli intervalli e gli attributi per ogni intervallo acquisito.
| Nome operazione | Attributi Span | Description |
|---|---|---|
|
|
|
Crea un nuovo evento all'interno di una sessione di memoria |
|
|
|
Recupera un evento di memoria esistente |
|
|
|
Elenca gli eventi all'interno di una sessione |
|
DeleteEvent |
|
Elimina un evento dalla memoria |
|
RetrieveMemoryRecords |
|
Recupera i record di memoria per un determinato namespace |
|
ListMemoryRecords |
|
Elenca i record di memoria disponibili |
Dati di registro forniti
AgentCore fornisce registri strutturati che consentono di monitorare e risolvere i principali processi relativi alle risorse di AgentCore memoria. Per abilitare questi dati di registro, è necessario strumentare il codice dell'agente. Per ulteriori informazioni, consulta Aggiungere osservabilità alle AgentCore risorse Amazon Bedrock.
AgentCore può inviare i log allo stream CloudWatch Logs, Amazon S3 o Firehose. Se si utilizza una destinazione CloudWatch Logs, questi log vengono archiviati nel gruppo di log predefinito /aws/vendedlogs/bedrock-agentcore/memory/APPLICATION_LOGS/{memory_id} o in un gruppo di log personalizzato che inizia con. /aws/vendedlogs/ Per ulteriori informazioni, consulta Enabling observability for AgentCore runtime, memory, gateway, strumenti integrati e risorse di identità.
Quando viene richiamata l'DeleteMemoryoperazione, vengono generati i log per l'inizio e il completamento del processo di eliminazione. Tutti i registri degli errori di eliminazione corrispondenti verranno forniti con informazioni sul motivo per cui la chiamata non è riuscita.
Forniamo anche registri per varie fasi del processo di creazione della memoria a lungo termine, vale a dire l'estrazione e il consolidamento. Quando vengono forniti nuovi eventi di memoria a breve termine, AgentCore estrae i concetti chiave dalle risposte per iniziare la formazione di nuovi record di memoria a lungo termine. Una volta creati, vengono integrati con i record di memoria esistenti per creare un archivio unificato di memorie distinte.
Consulta la seguente suddivisione per scoprire come ogni flusso di lavoro ti aiuta a monitorare la formazione di nuove memorie:
Registri di estrazione
-
Inizio e completamento del processo di estrazione
-
Numero di memorie estratte con successo
-
Eventuali errori nella deserializzazione o nell'elaborazione degli eventi di input
Registri di consolidamento:
-
Avvio e completamento del processo di consolidamento
-
Numero di memorie che richiedono il consolidamento
-
Success/failure di aggiunte e aggiornamenti di memoria
-
stato di recupero della memoria correlato
La tabella seguente fornisce un'analisi più dettagliata del modo in cui i diversi flussi di lavoro delle risorse di memoria utilizzano i campi di registro insieme al corpo del registro stesso per fornire informazioni specifiche sulla richiesta.
| Nome del flusso di lavoro | Campi di log | Description |
|---|---|---|
|
Estrazione |
resource_arn, event_timestamp, memory_strategy_id, namespace, actor_id, session_id, event_id, RequestId, isError |
Analizza le conversazioni in arrivo per generare nuovi ricordi |
|
Consolidamento |
resource_arn, event_timestamp, memory_strategy_id, namespace, session_id, RequestId, isError |
Combina le memorie estratte con le memorie esistenti |
