View a markdown version of this page

Vea los datos de observabilidad de sus agentes de Amazon Bedrock AgentCore - Amazon Bedrock AgentCore
Visualiza los datos mediante la observabilidad generativa de la IA en Amazon CloudWatchVea otros datos en CloudWatch

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

Tras implementar la observabilidad en su agente, podrá ver las métricas y los rastreos recopilados tanto en la página de observabilidad de la IA generativa de la CloudWatch consola como en los registros. CloudWatch Consulte las siguientes secciones para obtener información sobre cómo ver las métricas de sus agentes.

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

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

Con la observabilidad generativa mediante IA CloudWatch, puede ver cuadros de mando personalizados con gráficos y otras visualizaciones de sus datos, así como desgloses de errores, visualizaciones de trazas y mucho más. Para obtener más información sobre el uso de la observabilidad generativa mediante IA CloudWatch, incluida la forma de ver las sesiones individuales de sus agentes y los datos de rastreo, consulte los agentes de Amazon Bedrock AgentCore en la guía del usuario de Amazon. 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 el 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 agente, memoria o recurso de puerta de enlace.

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

    • Registros estándar: stdout/stderr salida

      • Ubicación:/aws/bedrock-agentcore/runtimes/<agent_id>-<endpoint_name>/[runtime-logs] <UUID>

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

      • Ejemplo de uso:

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

        • logging.info («Solicitud procesada correctamente») # Aparece en los registros estándar

    • Registros estructurados de OTEL: información detallada sobre las operaciones

      • 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 ADOT

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

Rastros y alcances

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

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

  • Acceda a través de: consola de búsqueda de CloudWatch transacciones

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

Las trazas capturan automáticamente:

  • Secuencias de invocación de agentes

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

  • Llamadas y respuestas de LLM

  • Invocaciones y resultados de herramientas

  • Rutas de error y excepciones

Para el rastreo distribuido entre los servicios, puedes 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 las trazas:

  • Navega a la CloudWatch consola

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

  • Filtre por nombre de servicio u otros criterios

  • Seleccione una traza para ver el gráfico de ejecución detallado

Métricas

Si ha activado la observabilidad instrumentando su código de agente tal 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 también publica las métricas de servicio estándar. CloudWatch Consulte los datos de observabilidad en tiempo de ejecución AgentCore generados para obtener una lista de estas métricas.