View a markdown version of this page

Vea los datos de observabilidad de sus agentes de Amazon Bedrock AgentCore - Base amazónica AgentCore
Visualice los datos mediante la observabilidad generativa de la IA en Amazon CloudWatchVea otros datos en CloudWatch

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.

Vea los datos de observabilidad de sus agentes de Amazon Bedrock AgentCore

Tras implementar la observabilidad en tu agente, puedes ver las métricas y los seguimientos recopilados tanto en la página de observabilidad de la IA generativa de la CloudWatch consola como en los registros. CloudWatch Consulta las siguientes secciones para obtener información sobre cómo ver las métricas de tus agentes.

Visualice los datos mediante la observabilidad generativa de la IA en Amazon CloudWatch

La página de observabilidad de la IA CloudWatch generativa muestra todas las métricas proporcionadas por el servicio generadas por el tiempo de ejecución del AgentCore agente, así como los datos derivados del intervalo y la traza, si has habilitado la instrumentación en el código de tu agente. Para ver el panel de observabilidad en, abre la página de Amazon Observability. CloudWatch CloudWatch GenAi

Con la observabilidad generativa de la IA CloudWatch, puede ver paneles personalizados con gráficos y otras visualizaciones de sus datos, así como desgloses de errores, visualizaciones de rastreo y mucho más. Para obtener más información sobre el uso de la observabilidad generativa de la IA en la guía del usuario de Amazon CloudWatch, incluida la forma de ver los datos de rastreo y sesión individuales de sus agentes, consulte los agentes de Amazon Bedrock. AgentCore CloudWatch

Vea otros datos en CloudWatch

También se pueden ver todas las métricas y los intervalos proporcionados por el servicio CloudWatch, junto con cualquier métrica que genere su código de agente instrumentado.

Para ver estos datos, consulte las siguientes secciones.

Registros

  1. Abra la consola de CloudWatch.

  2. En el panel de navegación de la izquierda, expanda Registros y seleccione Grupos de registros

  3. Utilice el campo de búsqueda para buscar el grupo de registros de su recurso de agente, memoria o puerta de enlace.

    AgentCore los grupos de registros de agentes tienen el siguiente formato:

    • Registros estándar: stdout/stderr salida

      • Ubicación:/aws/bedrock-/<agent_id>- agentcore/runtimes<endpoint_name>/[registros de tiempo de ejecución] <UUID>

      • Contiene: errores de tiempo de ejecución, registros de aplicaciones e instrucciones de depuración

      • Ejemplo de uso:

        • print («Procesando solicitud...») # Aparece en los registros estándar

        • logging.info («La solicitud se procesó correctamente») # Aparece en los registros estándar

    • Registros estructurados de OTEL: información operativa detallada

      • Ubicación:/aws/bedrock-agentcore/runtimes/- <agent_id><endpoint_name>/otel-rt-logs

      • Contiene: detalles de ejecución, seguimiento de errores y datos de rendimiento

      • Recopilación automática: no se requiere código adicional, generado por la instrumentación de ADOT

      • Ventajas: Puede incluir identificadores de correlación que vinculen los registros con los rastros relevantes

Trazos y tramos

Los rastreos proporcionan visibilidad de las rutas de ejecución de las solicitudes a través de su agente:

  • Ubicación: la secuencia de spans registros del grupo de registros del agente (/aws/bedrock-agentcore/runtimes/<agent_id>-<endpoint_name>) o la secuencia de default registros del grupo de aws/spans registros en el caso de los agentes que utilizan el destino del intervalo compartido. Para obtener más información, consulte el destino de Span para los agentes alojados en Amazon Bedrock AgentCore Runtime.

  • Acceso mediante: consola de búsqueda de CloudWatch transacciones

  • Requisitos: La búsqueda de CloudWatch transacciones debe estar habilitada

Los rastros capturan automáticamente:

  • Secuencias de invocación del agente

  • Integración con los componentes del marco (LangChain, etc.)

  • Llamadas y respuestas de LLM

  • Invocaciones y resultados de la herramienta

  • Rutas de error y excepciones

Para el rastreo distribuido entre los servicios, puede usar encabezados HTTP estándar:

  • AWS X-Ray formato: X-Amzn-Trace-Id: Root=1-5759e988-bd862e3fe1be46a994272793;Parent=53995c3f42cd8ad8;Sampled=1

  • Formato W3C: traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01

Para ver los rastros:

  • Navega hasta la CloudWatch consola

  • Selecciona Búsqueda de transacciones en el menú de navegación de la izquierda

  • Filtra por nombre de servicio u otros criterios

  • Seleccione un seguimiento para ver el gráfico de ejecución detallado

Métricas

Si ha habilitado la observabilidad instrumentando el código de su agente tal y como se describe en Habilitar la AgentCore observabilidad, su agente genera automáticamente las métricas de OTEL, que se envían CloudWatch mediante el formato métrico mejorado (EMF):

  • Espacio de nombres: bedrock-agentcore

  • Acceso a través de: consola de métricas CloudWatch

  • Contenido: métricas personalizadas generadas por el código y los marcos de su agente

  • Recopilación automática: no se requiere código adicional, generado por la instrumentación de ADOT

Además de las métricas emitidas por los agentes, el AgentCore servicio publica las métricas de servicio estándar para. CloudWatch Consulte los datos de observabilidad en tiempo de ejecución AgentCore generados para obtener una lista de estas métricas.