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: en . 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 AUTOTITLE.
También puede usar el contexto para ejecutar los pasos de manera condicional solo cuando el registro de depuración está habilitado. Consulta AUTOTITLE.
Crear artefactos de depuración de CodeQL
Advertencia
La depuración de artefactos de CodeQL CLI contiene una copia del código fuente que analiza CodeQL, por lo que se recomienda compartir estas agrupaciones solo con personas autorizadas para acceder a ese código fuente.
Puedes obtener artefactos para que te ayuden a depurar CodeQL. Los artefactos de depuración se cargarán en la ejecución de flujo como artefactos con nombres que empiezan con . Si CodeQL analiza varios lenguajes simultáneamente como parte de la ejecución del flujo de trabajo, habrá un artefacto de este tipo para cada lenguaje. Los datos contienen las bases de datos, los archivos de código fuente extraídos y los archivos SARIF de CodeQL. la(s) base(s) de datos de CodeQL que genere el flujo de trabajo. Para obtener más información sobre la descarga de artefactos CodeQL, consulte AUTOTITLE.
Estos artefactos te ayudarán a depurar los problemas con CodeQL code scanning. Si se pone en contacto con Soporte de GitHub, le podrían pedir estos datos.
Creación de artefactos de depuración de CodeQL para la configuración predeterminada de CodeQL
Puede crear artefactos de depuración de CodeQL habilitando el registro de depuración de pasos (consulte Habilitación de registro de depuración de pasos) y desencadenando un nuevo análisis de CodeQL, por ejemplo, insertando una nueva confirmación en la rama de una solicitud de incorporación de cambios.
Si ha proporcionado a CodeQL acceso a registros privados, habrá artefactos adicionales cuyos nombres empiezan por disponibles. Contienen registros del proxy de autenticación que la configuración predeterminada de CodeQL utiliza para autenticar solicitudes a registros privados y pueden utilizarse para solucionar problemas en configuraciones de registros privados. Consulta AUTOTITLE para obtener más información.
Creación de artefactos de depuración de CodeQL para la configuración avanzada de CodeQL
Los artefactos de depuración para la configuración avanzada de CodeQL se pueden obtener de varias maneras diferentes.
Volver a ejecutar trabajos con el registro de depuración habilitado
La opción más sencilla para crear artefactos de depuración para la configuración avanzada de CodeQL es volver a ejecutar los trabajos con el registro de depuración habilitado. Para obtener más información sobre cómo volver a ejecutar los flujos de trabajo y los trabajos de GitHub Actions, consulte AUTOTITLE.
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 artefactos de depuración de CodeQL para investigar más a fondo. No necesitas volver a ejecutar trabajos para modificar el archivo de flujo de trabajo al crear artefactos de depuración de CodeQL.
Uso de una marca de flujo de trabajo
Puedes crear artefactos de depuración de CodeQL mediante el uso de una marca en el flujo de trabajo. Para ello, tienes que modificar el paso del archivo de Flujo de trabajo de análisis de CodeQL y establecer .
- name: Initialize CodeQL
uses: github/codeql-action/init@v4
with:
debug: true
Uso del registro de depuración de pasos de GitHub Actions
Si habilita el registro de depuración de pasos de GitHub Actions, 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.