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 configurando los secretos en el repositorio que contiene el flujo de trabajo, así que aplicarán los mismos requisitos de los permisos:

  • Para crear secretos para un repositorio de una cuenta personal, deberás ser el propietario del repositorio. A fin de crear secretos para un repositorio de la organización, debe tener acceso admin.
  • Para crear secretos para un entorno en el repositorio de una cuenta personal, debes ser el propietario del repositorio. A fin de crear secretos para un entorno en el repositorio de una organización, debe tener acceso de admin.
  • Para crear secretos en el nivel de la organización, debe tener acceso admin.
  • Para crear secretos utilizando la API de REST, debes tener acceso de escritura en el repositorio o acceso administrativo en la organización. Para más información, vea "API de secretos de GitHub Actions".

Para obtener más información sobre cómo establecer secretos, consulte "Creación y uso de secretos cifrados".

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 más información, consulta "Volver a ejecutar flujos de trabajo y trabajos".

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 secreto ACTIONS_RUNNER_DEBUG en true en el repositorio que contiene el flujo de trabajo.

  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 los registros, consulte "Descarga de registros".

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, establezca el secreto ACTIONS_STEP_DEBUG en true en el repositorio que contiene el flujo de trabajo.

  2. Después de establecer el secreto, se muestran más eventos de depuración en los registros del paso. Para obtener más información, consulte "Visualización de registros para diagnosticar errores".