AgentCore générer des données d'observabilité de la mémoire
Pour le type de ressource AgentCore mémoire, AgentCore envoie des métriques à Amazon CloudWatch par défaut. AgentCore génère également un ensemble par défaut de spans et de logs, si vous les activez. Consultez Activer l'observabilité pour l' AgentCore exécution, la mémoire, la passerelle, les outils intégrés et les ressources d'identité pour en savoir plus sur l'activation des spans et des logs.
Reportez-vous aux sections suivantes pour en savoir plus sur les données d'observabilité fournies pour les mémoires de vos agents.
Métriques de mémoire fournies
Le type de ressource AgentCore mémoire fournit les métriques suivantes par défaut.
- Latence
-
Le temps total écoulé entre la réception de la demande et l'envoi du jeton de réponse final. Représente le traitement complet de bout en bout de la demande.
- Invocations
-
Nombre total de demandes d'API adressées au plan de données et au plan de contrôle. Cette métrique permet également de suivre le nombre d'événements d'ingestion de mémoire.
- Erreurs du système
-
Nombre d'appels qui entraînent des erreurs AWS côté serveur.
- Erreurs de l'utilisateur
-
Nombre d’invocations qui entraînent des erreurs côté client.
- Erreurs
-
Nombre total d'erreurs survenant lors du traitement des demandes d'API dans le plan de données et le plan de contrôle. Cette métrique permet également de suivre le nombre total d'erreurs qui se produisent lors de l'ingestion de mémoire.
- Throttles
-
Nombre d’invocations que le système a limitées. Les demandes limitées sont considérées comme des invocations, des erreurs et des erreurs de l'utilisateur.
- Nombre de créations
-
Compte le nombre d'événements et d'enregistrements de mémoire créés.
Données d'envergure fournies
Pour améliorer l'observabilité, AgentCore fournit des plages structurées qui retracent la relation entre les événements et les souvenirs qu'ils génèrent ou auxquels ils accèdent. Pour activer ces données d'intervalle, vous devez instrumenter votre code d'agent. Consultez Ajouter de l'observabilité à vos AgentCore ressources Amazon Bedrock pour en savoir plus.
Ces données d'intervalle sont disponibles dans leur intégralité dans les CloudWatch journaux et les signaux CloudWatch d'application. Pour en savoir plus sur l'affichage des données d'observabilité, consultez Afficher les données d'observabilité de vos agents Amazon AgentCore Bedrock.
Le tableau suivant définit les opérations pour lesquelles des intervalles sont créés et les attributs de chaque intervalle capturé.
| Nom de l’opération | Attributs d'envergure | Description |
|---|---|---|
|
|
|
Crée un nouvel événement dans une session de mémoire |
|
|
|
Récupère un événement de mémoire existant |
|
|
|
Répertorie les événements d'une session |
|
DeleteEvent |
|
Supprime un événement de la mémoire |
|
RetrieveMemoryRecords |
|
Récupère les enregistrements de mémoire pour un espace de noms donné |
|
ListMemoryRecords |
|
Liste les enregistrements de mémoire disponibles |
Données de journal fournies
AgentCore fournit des journaux structurés qui vous aident à surveiller et à résoudre les problèmes liés aux principaux processus liés aux ressources de AgentCore mémoire. Pour activer ces données de journal, vous devez instrumenter votre code d'agent. Consultez Ajouter de l'observabilité à vos AgentCore ressources Amazon Bedrock pour en savoir plus.
AgentCore peut générer des CloudWatch journaux vers Logs, Amazon S3 ou Firehose Stream. Si vous utilisez une destination de CloudWatch journaux, ces journaux sont stockés dans le groupe de journaux par défaut /aws/vendedlogs/bedrock-agentcore/memory/APPLICATION_LOGS/{memory_id} ou dans un groupe de journaux personnalisé commençant par/aws/vendedlogs/. Consultez Activer l'observabilité pour l' AgentCore exécution, la mémoire, la passerelle, les outils intégrés et les ressources d'identité pour en savoir plus.
Lorsque l'DeleteMemoryopération est appelée, des journaux sont générés pour le début et la fin du processus de suppression. Tous les journaux d'erreurs de suppression correspondants seront fournis avec des informations expliquant pourquoi l'appel a échoué.
Nous fournissons également des journaux pour les différentes étapes du processus de création de mémoire à long terme, à savoir l'extraction et la consolidation. Lorsque de nouveaux événements de mémoire à court terme sont fournis, AgentCore extrait les concepts clés des réponses pour commencer la formation de nouveaux enregistrements de mémoire à long terme. Une fois qu'ils ont été créés, ils sont intégrés aux enregistrements de mémoire existants pour créer une banque unifiée de mémoires distinctes.
Consultez le détail suivant pour découvrir comment chaque flux de travail vous aide à surveiller la formation de nouveaux souvenirs :
Journaux d'extraction
-
Début et fin du processus d'extraction
-
Nombre de mémoires extraites avec succès
-
Toute erreur lors de la désérialisation ou du traitement des événements d'entrée
Journaux de consolidation :
-
Début et fin du processus de consolidation
-
Nombre de mémoires à consolider
-
Success/failure d'ajouts et de mises à jour de mémoire
-
État de récupération de mémoire associé
Le tableau suivant fournit une description plus détaillée de la manière dont les différents flux de travail liés aux ressources de mémoire utilisent les champs de journal en plus du corps du journal lui-même pour fournir des informations spécifiques à la demande.
| Nom du flux de travail | Champs de journal | Description |
|---|---|---|
|
Extraction |
resource_arn, event_timestamp, memory_strategy_id, namespace, actor_id, session_id, event_id, requestID, IsError |
Analyse les conversations entrantes pour générer de nouveaux souvenirs |
|
Consolidation |
resource_arn, event_timestamp, memory_strategy_id, namespace, session_id, requestID, IsError |
Combine les mémoires extraites avec les mémoires existantes |
