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
Puede habilitar el registro de depuración de pasos en GitHub Actions para aumentar el nivel de detalle de los registros de un trabajo durante su ejecución. Para más información, consulta Habilitación del registro de depuración.
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 debug-artifacts. 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 Descargar los artefactos del flujo de trabajo.
Estos artefactos te ayudarán a depurar los problemas con CodeQL code scanning. Si contactas al soporte de GitHub, podrían pedirte 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 de GitHub Actions 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. Para obtener información sobre cómo habilitar el registro de depuración de pasos GitHub Actions, consulte Habilitación del registro de depuración.
Si ha proporcionado a CodeQL acceso a registros privados, habrá artefactos adicionales cuyos nombres empiezan por proxy-log-file 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 Conceder acceso a las características de seguridad a registros privados 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 Volver a ejecutar flujos de trabajo y jobs.
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 init del archivo de Flujo de trabajo de análisis de CodeQL y establecer debug: true.
- name: Initialize CodeQL
uses: github/codeql-action/init@v4
with:
debug: true
Uso del registro de depuración de pasos de GitHub Actions
Si ha habilitado el registro de depuración de pasos de GitHub Actions, CodeQL también generará artefactos de depuración y los cargará. Consulta Habilitación del registro de depuración.