Skip to main content

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 en GitHub para un repositorio de una cuenta personal, debes ser propietario del repositorio. Para crear secretos o variables en GitHub para un repositorio de una organización, debes tener acceso de admin. Por último, para crear secretos o variables para un repositorio de cuentas personales o un repositorio de una organización a través de la API REST, es preciso tener acceso de colaborador.
  • 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".
  • Los propietarios de la organización y los usuarios con los permisos "Administrar variables de acciones de la organización" o "Administrar secretos de acciones de la organización" pueden crear secretos o variables en el nivel de organización.

Para más información, consulta "Acerca de los roles personalizados de organización".

Para más información sobre cómo establecer secretos y variables, consulta: "Uso de secretos en Acciones de GitHub" 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».