Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.
GitHub AE is currently under limited release.

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 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 pour un dépôt de compte personnel, vous devez être le propriétaire du dépôt. Pour créer des secrets pour un dépôt d’organisation, vous devez avoir l’accès admin.
  • Pour créer des secrets 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 pour un environnement dans un dépôt d’organisation, vous devez avoir l’accès admin.
  • Pour créer des secrets au niveau de l’organisation, vous devez avoir l’accès admin.

Pour plus d’informations sur la définition de secrets, voir « Secrets chiffrés ».

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 dans le dépôt qui contient le workflow : ACTIONS_RUNNER_DEBUG sur true.
  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 « Téléchargement des journaux ».

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 dans le dépôt qui contient le workflow : ACTIONS_STEP_DEBUG sur true.
  2. Après avoir défini le secret, d’autres événements de débogage sont affichés dans les journaux d’étape. Pour plus d’informations, consultez « Affichage des journaux pour diagnostiquer les défaillances ».