Supervisión de los registros del agente hospedado con la CLI para desarrolladores de Azure

Transmita e inspeccione los registros de su agente hospedado de Microsoft Foundry implementado para la resolución de problemas y la observabilidad. Aprenderá a ver registros de consola, transmitir en tiempo real, inspeccionar eventos del sistema, filtrar por sesión y reconocer patrones de registro comunes.

Prerequisites

• Un agente hospedado implementado. Para implementar uno, consulte Implementación de un agente hospedado.
• Las extensiones de Foundry para azd se han instalado. Para conocer los pasos de instalación, consulte Instalación de las extensiones azd Foundry.
• Una sesión de la CLI de desarrollador Azure autenticada. Ejecute azd auth login si es necesario.
• Para los registros específicos de una sesión, un ID de sesión de la respuesta azd ai agent invoke. Para invocar un agente, consulte Invocación de un agente hospedado con la CLI para desarrolladores de Azure.

Visualización de registros de consola recientes

• Capturar registros de consola recientes:

  azd ai agent monitor
  

  Este comando captura los registros de consola recientes, incluidos stdout y stderr, de la última sesión de invocación del agente. Si no existe ninguna sesión, muestra los registros del contenedor en tiempo real. El comando finaliza después de obtener los registros disponibles. Utilice --follow para transmitir de forma continua.

Transmisión de registros en tiempo real

• Transmita registros de forma continua:

  azd ai agent monitor --follow
  

  Presione Ctrl+C para detener. Este es el modo más útil para la depuración. Ejecútelo en un terminal mientras envía solicitudes en otra.

Visualización de registros de eventos del sistema

• Mostrar eventos de ciclo de vida del contenedor en lugar de la salida de la consola:

  azd ai agent monitor --type system
  

  Utilice los registros de eventos del sistema para diagnosticar bloqueos de contenedores, los bucles de reinicio y problemas de recursos.

Visualización de registros específicos de la sesión

• Filtre los registros a una sesión de agente específica:

  azd ai agent monitor --session-id <session-id>
  

• Combínalo con --follow para transmisión en tiempo real:

  azd ai agent monitor --session-id <session-id> --follow
  

  Para encontrar identificadores de sesión, compruebe la salida de azd ai agent invoke. Imprime el identificador de sesión para cada solicitud.

Longitud del registro de control

• Mostrar las últimas 100 líneas:

  azd ai agent monitor --tail 100
  

  El intervalo es de 1 a 300. El valor predeterminado es 50.

Supervisión de un agente específico

• En proyectos de varios servicios, pase el nombre del agente:

  azd ai agent monitor my-agent
  

Reconocimiento de patrones de registro comunes

Pattern	Meaning	Action
Listening on 0.0.0.0:8088	El agente se inició correctamente.	No se necesita ninguno.
AuthenticationError	La Entra Agent Identity del agente no se puede autenticar.	Compruebe los roles de RBAC.
ModelNotFound	Discrepancia en el nombre del modelo de implementación.	Compruebe que el nombre de implementación en azure.yaml coincide con el portal de Foundry.
ResourceNotFound	El punto de conexión de Foundry no coincide.	Compruebe el valor FOUNDRY_PROJECT_ENDPOINT.
Eventos de reinicio de contenedor en los registros del sistema	Bucle de errores.	Comprobar el código para las excepciones no controladas; considere la posibilidad de aumentar los límites de recursos de contenedor en azure.yaml.
TimeoutError	La solicitud tardó demasiado tiempo.	Comprobar la capacidad de respuesta del modelo; aumentar el tiempo de espera en la invocación.

Siga un flujo de trabajo de depuración

Una sesión de depuración típica tiene este aspecto:

1. Ver los registros en tiempo real en un único terminal:

   azd ai agent monitor --follow
   

2. Enviar una solicitud en otro terminal:

   azd ai agent invoke "Test message"
   

3. Observe los registros de patrones de error o comportamiento inesperado.

4. Compruebe los eventos del sistema si el agente parece no responde:

   azd ai agent monitor --type system
   

Para obtener un flujo de trabajo de depuración completo, consulte Depuración de un agente hospedado.

Contenido relacionado

• Depure un agente hospedado para obtener flujos de trabajo de diagnóstico paso a paso.
• Pruebe un agente hospedado para obtener estrategias de validación antes de producción.
• Aísla las sesiones del agente hospedado por usuario para obtener registros en sesiones aisladas.