Si vos journaux d’activité ne sont pas suffisamment détaillés pour résoudre un problème, vous pouvez effectuer plusieurs étapes pour obtenir des informations supplémentaires et rendre les journaux plus utiles.
Activation de la journalisation du débogage par étape
Vous pouvez activer la journalisation des étapes de débogage dans GitHub Actions pour augmenter le détail des journaux d’activité d’un travail pendant son exécution. Pour plus d’informations, consultez « Activation de la journalisation du débogage ».
Création d’artefacts de débogage CodeQL
Avertissement
Les artefacts de débogage CodeQL contiennent une copie du code source analysé par CodeQL. Nous vous suggérons donc de partager ces packs uniquement avec des personnes autorisées à accéder à ce code source.
Vous pouvez obtenir des artefacts pour vous aider à déboguer CodeQL.
Les artefacts de débogage seront chargés dans l'exécution du flux de travail en tant qu’artefacts avec des noms commençant par debug-artifacts. Si CodeQL analyse simultanément plusieurs langues dans le cadre de l’exécution du flux de travail, il y aura un artefact de ce type pour chaque langue. Les données contiennent les journaux CodeQL, les bases de données CodeQL, les fichiers extraits de code source et tous les fichiers SARIF générés par le flux de travail. Pour plus d’informations sur le téléchargement des artefacts CodeQL, consultez Téléchargement d’artefacts de workflow.
Ces artefacts vous aident à déboguer les problèmes avec CodeQL code scanning. Si vous contactez le support GitHub, il se peut qu’il vous demande ces données.
Création d’artefacts de débogage pour la configuration par défaut CodeQL
Vous pouvez créer des artefacts de débogage CodeQL en activant la journalisation de débogage d'étape GitHub Actions et en déclenchant une nouvelle analyse CodeQL, par exemple, en envoyant un nouveau commit à une branche de pull request. Pour plus d’informations sur la façon d’activer la journalisation des débogages pas à pas pour GitHub Actions, consultez Activation de la journalisation du débogage.
Création d'artefacts de débogage pour l'installation avancée de CodeQL
Le débogage des artefacts de CodeQL pour la configuration avancée peut être réalisé de plusieurs façons différentes.
Réexécuter les tâches avec la journalisation de débogage activée
L’option la plus simple pour créer des artefacts de débogage pour CodeQL dans une configuration avancée consiste à réexécuter des tâches avec la journalisation du débogage activée. Pour plus d’informations sur la réexécution des workflows et travaux GitHub Actions, consultez Ré-exécution de workflows et de travaux.
Vous devez veiller à sélectionner Activer la journalisation du débogage. Cette option permet d’activer la journalisation des diagnostics de l’exécuteur et la journalisation du débogage par étape pour l’exécution. Vous pourrez ensuite télécharger les artefacts de débogage CodeQL pour une analyse plus approfondie. Vous n’avez pas besoin de modifier le fichier de workflow lors de la création d’artefacts de débogage CodeQL en réexécutant les travaux.
Utilisation d’un indicateur de flux de travail
Vous pouvez créer des artefacts de débogage CodeQL en utilisant un indicateur dans votre workflow. Pour ce faire, vous devez modifier l’étape init de votre fichier Workflow d’analyse CodeQL et définir debug: true.
- name: Initialize CodeQL
uses: github/codeql-action/init@v4
with:
debug: true
La journalisation de débogage pas à pas en utilisant GitHub Actions
Si vous avez activé la journalisation de débogage des étapes pour GitHub Actions, CodeQL générera également des artefacts de débogage et les chargera. Consultez Activation de la journalisation du débogage.