Skip to main content

Habilitar 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, debes ser el propietario de dicho repositorio. Para crear secretos para un repositorio de una organización, deberás tener acceso de administrador.
  • Para crear secretos para un ambiente en un repositorio de una cuenta personal, debes ser el propietario de dicho repositorio. Para crear secretos para un ambiente en el repositorio de una organización, deberás tener acceso de administrador.
  • Para crear secretos a nivel organizacional, deberás tener acceso de administrador.
  • Para crear secretos utilizando la API de REST, debes tener acceso de escritura en el repositorio o acceso administrativo en la organización. Para obtener más información, consulta la sección " API de secretos de GitHub Actions".

Para obtener más información sobre cómo establecer secretos, consulta la sección "Crear y usar secretos cifrados."

Adicionalmente, cualquiera que tenga acceso para ejecutar un flujo de trabajo puede habilitar el registro de diagnóstico de ejecutor y registro de depuración de pasos para una re-ejecución de flujo de trabajo. Para obtener más información, consulta la sección "Re-ejecución de flujos de trabajo y jobs".

Habilitar el registro de diagnóstico del ejecutor

El registro de diagnóstico en bitácoras para los ejecutores proporciona archivos de bitácora adicionales que contienen información acerca de como se ejecutan los jobs en estos. Los 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, establece el siguiente secreto en el repositorio que contiene el flujo de trabajo: ACTIONS_RUNNER_DEBUG en true.

  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 correner-diagnostic-logs. Para obtener más información sobre cómo descargar bitácoras, consulta la sección "Descargar bitácoras".

Habilitar el registro de depuración del paso

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

  1. Para habilitar el registro de depuración del paso, debes establecer el siguiente secreto en el repositorio que contiene el flujo de trabajo: ACTIONS_RUNNER_DEBUG en true.

  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, consulta "Ver registros para diagnosticar fallas".