Skip to main content

Enabling debug logging

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.

Ces 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 :

  • Pour créer des secrets ou des variables sur GitHub pour 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 sur GitHub pour un référentiel d’une organisation, vous devez disposer d’un accès admin. Enfin, pour créer des secrets ou des variables pour un dépôt référentiel de personnel ou un référentiel d’organisation via l’API REST, vous devez disposer d’un accès collaborateur.
  • Pour créer des secrets ou des variables pour un environnement dans un dépôt de compte personnel, vous devez être le propriétaire du dépôt. Pour créer des secrets ou des variables pour un environnement dans un dépôt d’organisation, vous devez avoir l’accès admin. Pour plus d’informations sur les environnements, consultez « Utilisation d’environnements pour le déploiement ».
  • Les propriétaires d’organisations et les utilisateurs disposant des autorisations « Gérer les variables d’action de l’organisation » ou « Gérer les secrets d’action d’organisation » peuvent créer des secrets ou des variables au niveau de l’organisation.

Pour plus d’informations, consultez « À propos des rôles d'organisation personnalisés ».

Pour plus d’informations sur la définition de secrets et de variables, consultez « Utilisation de secrets dans GitHub Actions » et « Variables ».

De 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 travaux ».

Activation de la journalisation des diagnostics de l’exécuteur

La 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 :

  • 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.
  • Journal du processus de travail, qui enregistre l’exécution d’un travail.
  1. Si vous souhaitez activer la journalisation des diagnostics pour les exécuteurs, définissez ce secret ou cette variable dans le dépôt qui contient le workflow : ACTIONS_RUNNER_DEBUG sur true. Si le secret et la variable sont définis, la valeur du secret est prioritaire sur la variable.
  2. 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 « Using workflow run logs ».

Activation de la journalisation du débogage par étape

La journalisation du débogage par étape augmente la verbosité des journaux d’un travail pendant et après l’exécution d’un travail.

  1. Pour activer la journalisation du débogage par étape, définissez ce secret ou cette variable dans le dépôt qui contient le workflow : ACTIONS_STEP_DEBUG sur true. Si le secret et la variable sont définis, la valeur du secret est prioritaire sur la variable.
  2. Après avoir défini le secret ou la variable, d’autres événements de débogage sont affichés dans les journaux d’étape. Pour plus d’informations, consultez « Using workflow run logs ».