Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
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 de spans et de journaux par défaut, si vous les activez. Consultez la section Activation de 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 journaux.
Reportez-vous aux sections suivantes pour en savoir plus sur les données d'observabilité fournies pour les mémoires de votre agent.
Métriques de mémoire fournies
Le type de ressource AgentCore mémoire fournit les mesures 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 qui se produisent 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 requêtes 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 de mémoire et d'enregistrements de mémoire créés.
Données d'envergure fournies
Pour améliorer l'observabilité, AgentCore fournit des intervalles structurés 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 de span, vous devez instrumenter votre code d'agent. Consultez la rubrique 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é, voir Afficher les données d'observabilité pour vos agents Amazon AgentCore Bedrock.
Le tableau suivant définit les opérations pour lesquelles les spans sont créées et les attributs de chaque span capturée.
| Nom de l’opération | Attributs Span | 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 |
|
Répertorie les enregistrements de mémoire disponibles |
Données de journal fournies
AgentCore fournit des journaux structurés qui vous aident à surveiller et à dépanner les 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 la rubrique 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 la section Activation de 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émarrage et la fin du processus de suppression. Tous les journaux d'erreurs de suppression correspondants seront fournis avec des informations sur les raisons pour lesquelles 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 un magasin unifié de mémoires distinctes.
Consultez la répartition suivante pour découvrir comment chaque flux de travail vous aide à surveiller la formation de nouveaux souvenirs :
Journaux d'extraction
-
Début et fin du traitement 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 traitement de consolidation
-
Nombre de mémoires nécessitant une consolidation
-
Success/failure d'ajouts et de mises à jour de mémoire
-
État de récupération de la mémoire associé
Le tableau suivant fournit une ventilation plus détaillée de la manière dont les différents flux de travail de ressources mémoire utilisent les champs de journal à côté 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 |
