Revisión de registros para diagnosticar problemas de canalización

Azure DevOps Services | Azure DevOps Server 2022: Azure DevOps Server 2019 | TFS 2018

Los registros de canalización proporcionan una herramienta eficaz para determinar la causa de errores de canalización.

Un punto de partida típico es revisar los registros de la compilación o versión completadas. Para ver los registros, vaya al resumen de ejecución de canalización y seleccione el trabajo y la tarea. Si se ha generado un error en una tarea determinada, compruebe los registros de esa tarea.

Además de ver los registros en el resumen de compilación de la canalización, puede descargar registros completos que incluyen información de diagnóstico adicional y puede configurar registros más detallados para ayudar con la solución de problemas.

Configuración de registros detallados

Para ayudar con la solución de problemas, puede configurar los registros para que sean más detallados.

  • Para configurar registros detallados para una sola ejecución, puede iniciar una nueva compilación seleccionando Ejecutar canalización y seleccionando Habilitar diagnósticos del sistema, Ejecutar.

    Habilitación de diagnósticos del sistema

  • Para configurar registros detallados para todas las ejecuciones, puede agregar una variable denominada system.debug y establecer su valor en true.

  • Para configurar los registros detallados para una sola ejecución, puede iniciar una nueva compilación seleccionando Compilación de cola y estableciendo el valor de la system.debug variable en true.

  • Para configurar registros detallados para todas las ejecuciones, edite la compilación, vaya a la pestaña Variables y agregue una variable denominada system.debug, establezca su valor trueen y seleccione Permitir en tiempo de cola.

  • Para configurar registros detallados para una canalización YAML, agregue la system.debug variable en la variables sección :

    variables:
      system.debug: true
    

Visualización y descarga de registros

Para ver los registros individuales de cada paso, vaya a los resultados de la compilación de la ejecución y seleccione el trabajo y el paso.

Registro de tareas

Para descargar todos los registros, vaya a los resultados de la compilación de la ejecución, seleccione ...y elija Descargar registros.

Descarga de registros

Para descargar todos los registros, vaya a los resultados de la compilación de la ejecución, elija Descargar todos los registros como zip.

Además de los registros de diagnóstico de canalización, están disponibles los siguientes tipos de registro especializados y pueden contener información para ayudarle a solucionar problemas.

Registros de diagnóstico de trabajo

Puede obtener el registro de diagnóstico de la compilación completada generada por el proceso de trabajo en el agente de compilación. Busque el worker archivo de registro que tiene la marca de fecha y hora de la compilación completada. Por ejemplo: worker_20160623-192022-utc_6172.log.

Registros de diagnóstico del agente

Los registros de diagnóstico del agente proporcionan un registro de cómo se configuró el agente y qué ha ocurrido cuando se ejecutó. Busque los archivos de agent registro. Por ejemplo: agent_20160624-144630-utc.log. Hay dos tipos de archivos de registro del agente:

  • El archivo de registro generado al ejecutar config.cmd. Este registro:

    • Incluye esta línea cerca de la parte superior: Adding Command: configure

    • Muestra las opciones de configuración realizadas.

  • El archivo de registro generado al ejecutar run.cmd. Este registro:

    • No se puede abrir hasta que finalice el proceso.

    • Intenta conectarse a la organización de Azure DevOps o a Team Foundation Server.

    • Muestra cuándo se ejecutó cada trabajo y cómo se completó

Ambos registros muestran cómo se detectaron y estableceron las funcionalidades del agente.

Otros registros

Dentro de los registros de diagnóstico encontrará environment.txt y capabilities.txt.

El environment.txt archivo tiene información sobre el entorno en el que se ejecutó la compilación. Esto incluye información como qué tareas se ejecutan, si el firewall está habilitado o no, la información de la versión de PowerShell y otros elementos. Agregamos continuamente a estos datos para que sea más útil.

El capabilities.txt archivo proporciona una manera limpia de ver todas las funcionalidades instaladas en el equipo de compilación que ejecutó la compilación.

Registros de seguimiento HTTP

Importante

Los seguimientos HTTP y los archivos de seguimiento pueden contener contraseñas y otros secretos. No los publique en sitios públicos.

Uso del seguimiento HTTP integrado

Si el agente es la versión 2.114.0 o posterior, puede realizar un seguimiento de los encabezados de tráfico HTTP y escribirlos en el registro de diagnóstico. Establezca la VSTS_AGENT_HTTPTRACE variable de entorno antes de iniciar agent.listener.

Windows:
    set VSTS_AGENT_HTTPTRACE=true

macOS/Linux:
    export VSTS_AGENT_HTTPTRACE=true

Uso del seguimiento HTTP completo: Windows

  1. Inicie Fiddler.

  2. Se recomienda escuchar solo el tráfico del agente. > Tráfico de captura de archivos desactivado (F12)

  3. Habilite el descifrado del tráfico HTTPS. Herramientas > Fiddler Opciones > HTTPS pestaña. Descifrar el tráfico HTTPS

  4. Indique al agente que use el proxy:

    set VSTS_HTTP_PROXY=http://127.0.0.1:8888
    
  5. Ejecute el agente de forma interactiva. Si se ejecuta como servicio, puede establecer como la variable de entorno en el panel de control de la cuenta en la que se ejecuta el servicio.

  6. Reinicie el agente.

Uso del seguimiento HTTP completo: macOS y Linux

Use Charles Proxy (similar a Fiddler en Windows) para capturar el seguimiento HTTP del agente.

  1. Inicie Charles Proxy.

  2. Charles: Pestaña SSL de configuración > de proxy > proxy. Habilite. Agregar dirección URL.

  3. Charles: Proxy > Mac OSX Proxy. Se recomienda deshabilitar solo para ver el tráfico del agente.

    export VSTS_HTTP_PROXY=http://127.0.0.1:8888
    
  4. Ejecute el agente de forma interactiva. Si se ejecuta como un servicio, puede establecer en el archivo .env. Consulte el servicio nix.

  5. Reinicie el agente.