AgentCore generar datos de observabilidad de memoria
Para el tipo de recurso de AgentCore 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. Consulte 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 el número 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 del 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 estos datos de intervalo, debe instrumentar su código de agente. Consulte Añadir observabilidad a sus AgentCore recursos de Amazon Bedrock para obtener más información.
Estos datos de intervalo están disponibles en su totalidad en CloudWatch los registros y en 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 de los principales procesos de recursos de AgentCore memoria. Para habilitar estos datos de registro, debe instrumentar su código de agente. Consulte Añadir 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 que comience por. /aws/vendedlogs/ Consulte 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.
Cuando se llama a la DeleteMemory operación, se generan registros para iniciar y completar el proceso de eliminación. Se proporcionarán todos los registros de errores de eliminación correspondientes con información sobre el motivo del error en la llamada.
También proporcionamos registros para varias etapas del proceso de creación de memoria a largo plazo, a saber, la extracción y la consolidación. Cuando se presentan 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 creados, se integran con los registros de memoria existentes para crear un almacén unificado de memorias distintas.
Consulte el siguiente desglose para saber cómo cada flujo de trabajo le ayuda a supervisar la formación de nuevas memorias:
Registros de extracción
-
Inicio y finalización del proceso de extracción
-
Número de memorias extraídas correctamente
-
¿Algún error al deserializar o procesar los eventos de entrada
Registros de consolidación:
-
Inicio y finalización del proceso de consolidación
-
Número 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 |
