{"meta":{"title":"Journaux insuffisamment détaillés","intro":"Accroître la verbosité des journaux et générer des artefacts de débogage si ces derniers manquent de détails de diagnostic.","product":"Sécurité et qualité du code","breadcrumbs":[{"href":"/fr/code-security","title":"Sécurité et qualité du code"},{"href":"/fr/code-security/reference","title":"Reference"},{"href":"/fr/code-security/reference/code-scanning","title":"Analyse du code"},{"href":"/fr/code-security/reference/code-scanning/troubleshoot-analysis-errors","title":"Résoudre les erreurs d’analyse"},{"href":"/fr/code-security/reference/code-scanning/troubleshoot-analysis-errors/logs-not-detailed-enough","title":"Journaux insuffisamment détaillés"}],"documentType":"article"},"body":"# Journaux insuffisamment détaillés\n\nAccroître la verbosité des journaux et générer des artefacts de débogage si ces derniers manquent de détails de diagnostic.\n\nSi 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.\n\n## Activation de la journalisation du débogage par étape\n\nLa journalisation du débogage par étape augmente la verbosité des journaux d’un travail pendant et après l’exécution.\n\nPour activer la journalisation du débogage par étapes :\n\n1. Dans le référentiel qui contient le flux de travail, définissez le secret ou la variable suivante : `ACTIONS_STEP_DEBUG``true` Si le secret et la variable sont tous les deux définis, la valeur du secret prévaut sur celle de la variable.\n2. Réexécutez le flux de travail ou déclenchez une nouvelle exécution.\n\nAprès avoir défini le secret ou la variable, d’autres événements de débogage sont affichés dans les journaux d’étapes. Consultez « [Utilisation des journaux d’exécution de flux de travail](/fr/actions/monitoring-and-troubleshooting-workflows/using-workflow-run-logs#viewing-logs-to-diagnose-failures) ».\n\nVous pouvez également utiliser le contexte `runner.debug` pour exécuter des étapes de manière conditionnelle uniquement lorsque la journalisation du débogage est activée. Consultez « [Référence des contextes](/fr/actions/reference/workflows-and-actions/contexts#runner-context) ».\n\n## Création d’artefacts de débogage CodeQL\n\n> \\[!WARNING]\n> 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.\n\nVous pouvez obtenir des artefacts pour vous aider à déboguer CodeQL.\nLes 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’artéfacts de workflow](/fr/actions/managing-workflow-runs/downloading-workflow-artifacts).\n\nCes artefacts vous aident à déboguer les problèmes avec CodeQL code scanning. Si vous contactez Support GitHub, ils peuvent demander ces données.\n\n### Création d’artefacts de débogage CodeQL pour la configuration par défaut CodeQL\n\nVous pouvez créer des artefacts de débogage CodeQL en activant la journalisation de débogage d’étape (voir [Activation de la journalisation du débogage par étape](#enabling-step-debug-logging)) et en déclenchant une nouvelle analyse CodeQL en envoyant un nouveau commit à une branche de demande de tirage.\n\nSi vous avez donné à CodeQL l'accès aux registres privés, des artefacts supplémentaires dont les noms commencent par `proxy-log-file` seront disponibles. Ils contiennent des journaux d’activité du proxy d’authentification utilisés par CodeQL configuration par défaut pour authentifier les demandes auprès des registres privés et peuvent être utilisés pour résoudre les problèmes de configurations de Registre privé. Pour en savoir plus, veuillez consulter la section [Accès des fonctionnalités de sécurité aux registres privés](/fr/code-security/how-tos/secure-at-scale/configure-organization-security/manage-usage-and-access/giving-org-access-private-registries).\n\n### Création d’artefacts de débogage CodeQL pour la configuration avancée CodeQL\n\nLe débogage des artefacts pour la configuration avancée CodeQL peut être réalisé de plusieurs façons différentes.\n\n#### Réexécuter les travaux avec la journalisation de débogage activée\n\nL’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 tâches](/fr/actions/managing-workflow-runs/re-running-workflows-and-jobs).\n\nVous 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.\n\n#### Utilisation d’un indicateur de flux de travail\n\nVous 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`.\n\n```yaml\n- name: Initialize CodeQL\n  uses: github/codeql-action/init@v4\n  with:\n    debug: true\n```\n\n#### Utiliser la journalisation de débogage pas à pas GitHub Actions\n\nSi vous activez la journalisation de débogage pas à pas pour GitHub Actions, CodeQL générera également des artefacts de débogage et les chargera dans le cadre de l'exécution du workflow. Pour obtenir des instructions, consultez [Activation de la journalisation du débogage pas à pas](#enabling-step-debug-logging)."}