AgentCore Daten zur Speicherbeobachtbarkeit generieren
Gibt für den AgentCore Speicherressourcentyp AgentCore CloudWatch standardmäßig Metriken an Amazon aus. AgentCore gibt auch einen Standardsatz von Spans und Logs aus, sofern Sie diese aktivieren. Weitere Informationen zur Aktivierung von Spans und Logs finden Sie unter Observability für AgentCore Laufzeit-, Speicher-, Gateway-, integrierte Tools und Identitätsressourcen aktivieren.
In den folgenden Abschnitten erfahren Sie mehr über die bereitgestellten Observability-Daten für Ihre Agent-Speicherspeicher.
Bereitgestellte Speichermetriken
Der AgentCore Speicherressourcentyp stellt standardmäßig die folgenden Metriken bereit.
- Latenz
-
Die Gesamtzeit, die zwischen dem Empfang der Anfrage und dem Senden des endgültigen Antwort-Tokens vergangen ist. Stellt die vollständige Ende-zu-Ende-Verarbeitung der Anfrage dar.
- Aufrufe
-
Die Gesamtzahl der API-Anfragen an die Daten- und Kontrollebene. Mit dieser Metrik wird auch die Anzahl der Speicheraufnahmeereignisse erfasst.
- Systemfehler
-
Anzahl der Aufrufe, die zu AWS serverseitigen Fehlern führen.
- Benutzerfehler
-
Anzahl der Aufrufe, die zu clientseitigen Fehlern führen
- Fehler
-
Gesamtzahl der Fehler, die bei der Verarbeitung von API-Anfragen auf der Daten- und Kontrollebene auftreten. Mit dieser Metrik wird auch die Gesamtzahl der Fehler erfasst, die bei der Speicheraufnahme auftreten.
- Drosselungen
-
Anzahl der Aufrufe, die das System gedrosselt hat Gedrosselte Anfragen zählen als Aufrufe, Fehler und Benutzerfehler.
- Anzahl der Erstellungen
-
Zählt die Anzahl der erstellten Speicherereignisse und Speicherdatensätze.
Bereitgestellte Span-Daten
AgentCore Stellt zur Verbesserung der Beobachtbarkeit strukturierte Zeitspannen bereit, die die Beziehung zwischen Ereignissen und den Erinnerungen, die sie erzeugen oder auf die sie zugreifen, nachvollziehen. Um diese Span-Daten zu aktivieren, müssen Sie Ihren Agentencode instrumentieren. Weitere Informationen finden Sie unter Hinzufügen von Observability zu Ihren Amazon AgentCore Bedrock-Ressourcen.
Diese Span-Daten sind vollständig in CloudWatch Logs und CloudWatch Application Signals verfügbar. Weitere Informationen zum Anzeigen von Observability-Daten finden Sie unter Observability-Daten für Ihre Amazon AgentCore Bedrock-Agenten anzeigen.
Die folgende Tabelle definiert die Operationen, für die Spans erstellt werden, und die Attribute für jeden erfassten Bereich.
| Vorgangsname | Span-Attribute | Description |
|---|---|---|
|
|
|
Erzeugt ein neues Ereignis innerhalb einer Speichersitzung |
|
|
|
Ruft ein vorhandenes Speicherereignis ab |
|
|
|
Listet Ereignisse innerhalb einer Sitzung auf |
|
DeleteEvent |
|
Löscht ein Ereignis aus dem Speicher |
|
RetrieveMemoryRecords |
|
Ruft Speicherdatensätze für einen bestimmten Namespace ab |
|
ListMemoryRecords |
|
Listet verfügbare Speicherdatensätze auf |
Bereitgestellte Protokolldaten
AgentCore stellt strukturierte Protokolle bereit, mit denen Sie wichtige AgentCore Speicherressourcenprozesse überwachen und Fehler beheben können. Um diese Protokolldaten zu aktivieren, müssen Sie Ihren Agentencode instrumentieren. Weitere Informationen finden Sie unter Hinzufügen von Observability zu Ihren Amazon AgentCore Bedrock-Ressourcen.
AgentCore kann CloudWatch Protokolle in Logs, Amazon S3 oder Firehose Stream ausgeben. Wenn Sie ein CloudWatch Logs-Ziel verwenden, werden diese Protokolle in der Standard-Protokollgruppe /aws/vendedlogs/bedrock-agentcore/memory/APPLICATION_LOGS/{memory_id} oder in einer benutzerdefinierten Protokollgruppe gespeichert, die mit /aws/vendedlogs/ beginnt. Weitere Informationen finden Sie unter Observability für AgentCore Laufzeit-, Speicher-, Gateway-, integrierte Tools und Identitätsressourcen aktivieren.
Wenn der DeleteMemory Vorgang aufgerufen wird, werden Protokolle für den Start und den Abschluss des Löschvorgangs generiert. Alle entsprechenden Löschfehlerprotokolle werden mit Informationen darüber bereitgestellt, warum der Anruf fehlgeschlagen ist.
Wir stellen auch Protokolle für verschiedene Phasen des Entstehungsprozesses des Langzeitgedächtnisses zur Verfügung, nämlich Extraktion und Konsolidierung. Wenn neue Ereignisse im Kurzzeitgedächtnis erfasst werden, AgentCore extrahiert es Schlüsselkonzepte aus den Reaktionen, um mit der Bildung neuer Langzeitgedächtnisdaten zu beginnen. Sobald diese erstellt wurden, werden sie in bestehende Speicheraufzeichnungen integriert, sodass ein einheitlicher Speicher mit unterschiedlichen Erinnerungen entsteht.
In der folgenden Aufschlüsselung erfahren Sie, wie Sie mit den einzelnen Arbeitsabläufen die Entstehung neuer Erinnerungen überwachen können:
Extraktionsprotokolle
-
Beginn und Abschluss der Extraktionsverarbeitung
-
Anzahl der erfolgreich extrahierten Speicher
-
Alle Fehler bei der Deserialisierung oder Verarbeitung von Eingabeereignissen
Konsolidierungsprotokolle:
-
Beginn und Abschluss der Konsolidierungsverarbeitung
-
Anzahl der Speicher, die konsolidiert werden müssen
-
Success/failure von Speichererweiterungen und -aktualisierungen
-
Status des zugehörigen Speicherabrufs
Die folgende Tabelle enthält eine detailliertere Aufschlüsselung darüber, wie verschiedene Speicherressourcen-Workflows neben dem Protokolltext selbst Protokollfelder verwenden, um anforderungsspezifische Informationen bereitzustellen.
| Workflow-Name | Protokollfelder | Description |
|---|---|---|
|
Extraktion |
resource_arn, event_timestamp, memory_strategy_id, namespace, actor_id, session_id, event_id, requestId, isError |
Analysiert eingehende Konversationen, um neue Erinnerungen zu generieren |
|
Konsolidierung |
resource_arn, event_timestamp, memory_strategy_id, namespace, session_id, requestId, isError |
Kombiniert extrahierte Erinnerungen mit vorhandenen Erinnerungen |
