Skip to main content
Publicamos actualizaciones para la documentación con frecuencia y es posible que aún se esté traduciendo esta página. Para obtener la información más reciente, consulta la documentación en inglés.

Habilitación del registro de depuración

Si los registros de flujo de trabajo no proporcionan suficiente detalle para diagnosticar por qué un flujo de trabajo o paso no funciona como se espera, puedes habilitar más registros de depuración.

Estas bitácoras extra se habilitan estableciendo los secretos o las variables en el repositorio que contiene el flujo de trabajo, así que se aplicarán los mismos requisitos de los permisos:

  • Para crear secretos o variables para un repositorio de una cuenta personal, el repositorio debe ser de tu propiedad. Para crear secretos o variables para un repositorio de una organización, debes tener acceso a admin.
  • Para crear secretos o variables para un entorno en un repositorio de una cuenta personal, el repositorio debe ser de tu propiedad. Para crear secretos o variables para un entorno en un repositorio de una organización, debes tener acceso a admin. Para obtener más información sobre los entornos, consulta "Utilizar ambientes para el despliegue".
  • Para crear secretos o variables en el nivel de organización, debes tener acceso de admin.

Para más información sobre cómo establecer secretos y variables, consulta: "Secretos cifrados" y "variables".

Además, cualquier persona que tenga acceso para ejecutar un flujo de trabajo puede habilitar el registro de diagnóstico del ejecutor y el registro de depuración de pasos para volver a ejecutar un flujo de trabajo. Para obtener más información, vea «Volver a ejecutar flujos de trabajo y jobs».

Habilitar el registro de diagnóstico del ejecutor

Las bitácoras de diagnóstico del ejecutor proporcionan archivos de bitácora adicionales que contienen información acerca de cómo éstos ejecutan un job. Dos archivos de registro adicionales se agregan al archivo de registro:

  • El registro del proceso del ejecutor, que incluye información acerca de la coordinación y la configuración de los ejecutores para ejecutar tareas.
  • El registro del proceso del trabajador, que registra la ejecución de una tarea.
  1. Para habilitar el registro de diagnóstico del ejecutor, establezca el siguiente secreto o variable en el repositorio que contiene el flujo de trabajo: ACTIONS_RUNNER_DEBUG en true. Si se establecen tanto el secreto como la variable, el valor del secreto tiene prioridad sobre la variable.
  2. Para descargar los registros de diagnóstico del ejecutor, descarga el archivo de registro del flujo de trabajo. Los registros de diagnóstico del ejecutor se encuentran en la carpeta runner-diagnostic-logs. Para obtener más información sobre cómo descargar registros, consulta: "Uso de registros de ejecución de flujo de trabajo".

Habilitar el registro de depuración del paso

El registro de depuración del paso aumenta el nivel de detalle de los registros de un trabajo durante y después de la ejecución de una tarea.

  1. Para habilitar el registro de depuración de pasos, establece el siguiente secreto o variable en el repositorio que contiene el flujo de trabajo: ACTIONS_STEP_DEBUG en true. Si se establecen tanto el secreto como la variable, el valor del secreto tiene prioridad sobre la variable.
  2. Después de establecer el secreto o la variable, se muestran más eventos de depuración en los registros de pasos. Para obtener más información, vea «Uso de registros de ejecución de flujo de trabajo».