{"meta":{"title":"Activation de la journalisation du débogage","intro":"Si les journaux de workflow ne fournissent pas suffisamment de détails pour diagnostiquer la raison pour laquelle un workflow, un travail ou une étape ne fonctionne pas comme prévu, vous pouvez activer une journalisation de débogage supplémentaire.","product":"GitHub Actions","breadcrumbs":[{"href":"/fr/actions","title":"GitHub Actions"},{"href":"/fr/actions/how-tos","title":"Guides pratiques"},{"href":"/fr/actions/how-tos/monitor-workflows","title":"Surveiller les workflows"},{"href":"/fr/actions/how-tos/monitor-workflows/enable-debug-logging","title":"Activer l’enregistrement du débogage"}],"documentType":"article"},"body":"# Activation de la journalisation du débogage\n\nSi les journaux de workflow ne fournissent pas suffisamment de détails pour diagnostiquer la raison pour laquelle un workflow, un travail ou une étape ne fonctionne pas comme prévu, vous pouvez activer une journalisation de débogage supplémentaire.\n\nCes journaux supplémentaires sont activés en définissant des secrets ou des variables dans le dépôt contenant le workflow, de sorte que les mêmes exigences en matière d’autorisations s’appliquent :\n\n* Pour créer des secrets ou des variables sur GitHub pour un référentiel d’organisation, vous devez avoir `admin` accès. Pour un référentiel de comptes personnels, vous devez être collaborateur du référentiel.\n* Pour créer des secrets pour un environnement dans un référentiel de compte personnel, vous devez être le propriétaire du référentiel. Pour créer des secrets ou des variables pour un environnement dans un référentiel d’organisation, vous devez disposer d’un accès `admin`. Pour plus d’informations sur les environnements, consultez [Gestion des environnements pour le déploiement](/fr/actions/deployment/targeting-different-environments/managing-environments-for-deployment).\n* Les propriétaires d’organisations peuvent créer des secrets ou des variables au niveau de l’organisation.\n\nPour plus d’informations sur la configuration des secrets et des variables, consultez [Utilisation de secrets dans GitHub Actions](/fr/actions/security-guides/using-secrets-in-github-actions) et [Stocker des informations dans des variables](/fr/actions/learn-github-actions/variables).\n\nDe plus, toute personne disposant d’un accès pour exécuter un workflow peut activer la journalisation des diagnostics de l’exécuteur et la journalisation du débogage par étape pour une réexécution de workflow. Pour plus d’informations, consultez « [Ré-exécution de workflows et de tâches](/fr/actions/managing-workflow-runs/re-running-workflows-and-jobs) ».\n\n## Activation de la journalisation des diagnostics de l’exécuteur\n\nLa journalisation des diagnostics de l’exécuteur fournit des fichiers journaux supplémentaires qui contiennent des informations sur la façon dont un exécuteur exécute un travail. Deux fichiers journaux supplémentaires sont ajoutés à l’archive des journaux :\n\n* Journal du processus de l’exécuteur, qui inclut des informations sur la coordination et la configuration des exécuteurs pour exécuter des travaux.\n* Journal du processus de travail, qui enregistre l’exécution d’un travail.\n\n1. Si vous souhaitez activer la journalisation des diagnostics pour les exécutions, définissez le secret ou la variable suivant dans le dépôt qui contient le workflow : `ACTIONS_RUNNER_DEBUG` sur `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. Pour télécharger les journaux des diagnostics de l’exécuteur, téléchargez l’archive des journaux de l’exécution de workflow. Les journaux des diagnostics de l’exécuteur sont contenus dans le dossier `runner-diagnostic-logs`. Pour plus d’informations sur le téléchargement des journaux, consultez [Utilisation des journaux d’exécution de flux de travail](/fr/actions/monitoring-and-troubleshooting-workflows/using-workflow-run-logs#downloading-logs).\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 d’un travail.\n\n1. Si vous souhaitez activer la journalisation de débogage des étapes, définissez le secret ou la variable suivant dans le dépôt qui contient le workflow : `ACTIONS_STEP_DEBUG` sur `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. Après avoir défini le secret ou la variable, d’autres événements de débogage sont affichés dans les journaux d’étapes. Pour plus d’informations, 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. Pour plus d’informations, consultez « [Référence des contextes](/fr/actions/reference/workflows-and-actions/contexts#runner-context) »."}