Si los registros no son lo suficientemente detallados para solucionar un problema, hay varios pasos que puede seguir para obtener información adicional y hacer que los registros sean más útiles.
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.
Para habilitar el registro de depuración del paso:
- En el repositorio que contiene el flujo de trabajo, establezca el siguiente secreto o variable:
ACTIONS_STEP_DEBUGentrue. Si se establecen tanto el secreto como la variable, el valor del secreto tiene prioridad sobre la variable. - Vuelva a ejecutar el flujo de trabajo o desencadene una nueva ejecución.
Después de establecer el secreto o la variable, se muestran más eventos de depuración en los registros de pasos. Consulta Uso de registros de flujo de trabajo.
También puede usar el contexto runner.debug para ejecutar los pasos de manera condicional solo cuando el registro de depuración está habilitado. Consulta Contextos de referencia.
Creación CodeQL de artefactos de depuración
Advertencia
CodeQL los artefactos de depuración contienen una copia del código CodeQLfuente que analiza , por lo que se recomienda compartir estos paquetes solo con personas autorizadas para acceder a ese código fuente.
Puede obtener artefactos para ayudarle a depurar CodeQL.
Los artefactos de depuración se cargarán en la ejecución de flujo como artefactos con nombres que empiezan con debug-artifacts. Si CodeQL analiza varios idiomas simultáneamente como parte de la ejecución del flujo de trabajo, habrá uno de estos artefactos para cada idioma. Los datos contienen los registros, CodeQL las CodeQL bases de datos, los archivos de código fuente extraídos y los archivos SARIF generados por el flujo de trabajo. Para obtener más información sobre la descarga de artefactos CodeQL, consulte Descargar los artefactos del flujo de trabajo.
Estos artefactos te ayudarán a depurar problemas con CodeQLcode scanning. Si se comunica con Soporte de GitHub, es posible que soliciten estos datos.
Creación CodeQL de artefactos de depuración para la CodeQL configuración predeterminada
Puede crear CodeQL artefactos de depuración habilitando el registro de depuración de pasos (consulte Habilitación del registro de depuración de pasos) y desencadenando un nuevo análisis, por ejemplo, insertando una nueva CodeQL confirmación en una rama de solicitud de incorporación de cambios.
Si ha concedido CodeQL acceso a registros privados, habrá artefactos adicionales cuyos nombres empiecen por proxy-log-file estarán disponibles. Contienen registros del proxy de autenticación que se usa de forma predeterminada para CodeQL autenticar solicitudes a registros privados y se pueden usar para solucionar problemas de configuraciones del registro privado. Consulta Conceder acceso a las características de seguridad a registros privados para obtener más información.
Creación de CodeQL artefactos de depuración para una CodeQL configuración avanzada
Los archivos de depuración para la configuración avanzada de CodeQL se pueden obtener de varias formas.
Volver a ejecutar trabajos con el registro de depuración habilitado
La forma más sencilla de crear artefactos de depuración para la configuración avanzada de CodeQL es volver a ejecutar trabajos con el registro de depuración activado. Para obtener más información sobre cómo volver a ejecutar GitHub Actions flujos de trabajo y trabajos, consulte Volver a ejecutar flujos de trabajo y tareas.
Asegúrate de seleccionar Habilitar registro de depuración. Esta opción habilita el registro de diagnóstico del ejecutor y el registro de depuración de pasos para la ejecución. A continuación, podrá descargar los CodeQL artefactos de depuración para seguir investigando. No es necesario modificar el archivo de flujo de trabajo al crear artefactos de depuración CodeQL al volver a ejecutar trabajos.
Uso de una marca de flujo de trabajo
Puede crear CodeQL artefactos de depuración usando una opción en su flujo de trabajo. Para ello, debe modificar el init paso del Flujo de trabajo de análisis de CodeQL archivo y establecer debug: true.
- name: Initialize CodeQL
uses: github/codeql-action/init@v4
with:
debug: true
Uso de GitHub Actions el registro de depuración paso a paso
Si habilita GitHub Actions el registro de depuración de pasos, CodeQL también generará artefactos de depuración y los cargará como parte de la ejecución del flujo de trabajo. Para obtener instrucciones, consulte Habilitación del registro de depuración de pasos.