Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
AgentCore generar datos de observabilidad de la memoria
Para el tipo AgentCore de recurso de memoria, AgentCore envía las métricas a Amazon de forma CloudWatch predeterminada. AgentCore también genera un conjunto predeterminado de intervalos y registros, si los habilitas. Consulta Cómo habilitar la observabilidad para el AgentCore tiempo de ejecución, la memoria, la puerta de enlace, las herramientas integradas y los recursos de identidad para obtener más información sobre cómo habilitar los intervalos y los registros.
Consulte las siguientes secciones para obtener más información sobre los datos de observabilidad proporcionados para los almacenes de memoria de sus agentes.
Métricas de memoria proporcionadas
El tipo de recurso de AgentCore memoria proporciona las siguientes métricas de forma predeterminada.
- Latencia
-
El tiempo total transcurrido entre la recepción de la solicitud y el envío del token de respuesta final. Representa el procesamiento completo de principio a fin de la solicitud.
- Invocations
-
El número total de solicitudes de API realizadas al plano de datos y al plano de control. Esta métrica también registra la cantidad de eventos de ingesta de memoria.
- Errores del sistema
-
Número de invocaciones que provocan errores en el AWS servidor.
- Errores de usuario
-
Número de invocaciones que dan lugar a errores del lado del cliente.
- Errores
-
Número total de errores que se producen al procesar las solicitudes de API en el plano de datos y el plano de control. Esta métrica también registra el total de errores que se producen durante la ingesta de memoria.
- Limitaciones
-
Número de invocaciones que el sistema ha limitado. Las solicitudes limitadas cuentan como invocaciones, errores y errores de usuario.
- Recuento de creaciones
-
Cuenta el número de eventos de memoria y registros de memoria creados.
Datos de intervalo proporcionados
Para mejorar la observabilidad, AgentCore proporciona intervalos estructurados que trazan la relación entre los eventos y los recuerdos que generan o a los que acceden. Para habilitar este intervalo de datos, debe instrumentar el código de su agente. Consulte Añadir la observabilidad a sus AgentCore recursos de Amazon Bedrock para obtener más información.
Los datos de este intervalo están disponibles en su totalidad en CloudWatch los registros y las señales de CloudWatch aplicación. Para obtener más información sobre la visualización de los datos de observabilidad, consulte Ver los datos de observabilidad de sus agentes de Amazon Bedrock AgentCore .
En la siguiente tabla se definen las operaciones para las que se crean los intervalos y los atributos de cada intervalo capturado.
| Nombre de operación | Atributos de intervalo | Description (Descripción) |
|---|---|---|
|
|
|
Crea un nuevo evento dentro de una sesión de memoria |
|
|
|
Recupera un evento de memoria existente |
|
|
|
Muestra los eventos de una sesión |
|
DeleteEvent |
|
Elimina un evento de la memoria |
|
RetrieveMemoryRecords |
|
Recupera los registros de memoria de un espacio de nombres determinado |
|
ListMemoryRecords |
|
Muestra los registros de memoria disponibles |
Datos de registro proporcionados
AgentCore proporciona registros estructurados que le ayudan a supervisar y solucionar problemas en los procesos clave de los recursos de AgentCore memoria. Para habilitar estos datos de registro, debe instrumentar su código de agente. Consulte Añadir la observabilidad a sus AgentCore recursos de Amazon Bedrock para obtener más información.
AgentCore puede enviar CloudWatch registros a Logs, Amazon S3 o Firehose Stream. Si utiliza un destino de CloudWatch registros, estos registros se almacenan en el grupo de registros predeterminado /aws/vendedlogs/bedrock-agentcore/memory/APPLICATION_LOGS/{memory_id} o en un grupo de registros personalizado empezando /aws/vendedlogs/ por. Consulta Cómo habilitar la observabilidad AgentCore de los recursos de tiempo de ejecución, memoria, puerta de enlace, herramientas integradas y identidad para obtener más información.
Cuando se llama a la DeleteMemory operación, se generan registros para iniciar y completar el proceso de eliminación. Los registros de errores de eliminación correspondientes se proporcionarán con información sobre los motivos por los que se produjo un error en la llamada.
También proporcionamos registros de varias etapas del proceso de creación de memoria a largo plazo, a saber, la extracción y la consolidación. Cuando se proporcionan nuevos eventos de memoria a corto plazo, AgentCore extrae los conceptos clave de las respuestas para iniciar la formación de nuevos registros de memoria a largo plazo. Una vez que se han creado, se integran con los registros de memoria existentes para crear un almacén unificado de recuerdos distintos.
Consulta el siguiente desglose para saber cómo cada flujo de trabajo te ayuda a supervisar la formación de nuevos recuerdos:
Registros de extracción
-
Inicio y finalización del proceso de extracción
-
Número de memorias extraídas correctamente
-
Cualquier error al deserializar o procesar los eventos de entrada
Registros de consolidación:
-
Inicio y finalización del proceso de consolidación
-
Cantidad de memorias que requieren consolidación
-
Success/failure de adiciones y actualizaciones de memoria
-
Estado de recuperación de memoria relacionado
La siguiente tabla proporciona un desglose más detallado de cómo los diferentes flujos de trabajo de recursos de memoria utilizan los campos de registro junto con el propio cuerpo del registro para proporcionar información específica de la solicitud.
| Nombre del flujo de trabajo | Campos de registro | Description (Descripción) |
|---|---|---|
|
Extracción |
resource_arn, event_timestamp, memory_strategy_id, namespace, actor_id, session_id, event_id, requestID, isError |
Analiza las conversaciones entrantes para generar nuevos recuerdos |
|
Consolidación |
resource_arn, event_timestamp, memory_strategy_id, namespace, session_id, requestID, isError |
Combina las memorias extraídas con las memorias existentes |
