Skip to main content

Using workflow run logs

Vous pouvez afficher, rechercher et télécharger les journaux pour chaque travail dans une exécution de workflow.

Vous pouvez voir si une exécution de workflow est en cours ou terminée à partir de la page d’exécutions de workflow. Vous devez être connecté à un compte GitHub pour afficher les informations sur les exécutions de workflow, notamment pour les dépôts publics. Pour plus d’informations, consultez « Autorisations d’accès sur GitHub ».

Si l’exécution est terminée, vous pouvez voir si le résultat a été un succès, un échec, une annulation ou une opération neutre. Si l’exécution a échoué, vous pouvez afficher les journaux de génération et y effectuer des recherches pour diagnostiquer l’échec et réexécuter le workflow. Vous pouvez également afficher les minutes d’exécution de travaux facturables, ou télécharger les journaux et les artefacts de build.

GitHub Actions utilise l’API Vérifications pour générer des états, résultats et journaux pour un workflow. GitHub crée une suite de vérifications pour chaque exécution de workflow. La suite de vérifications contient une exécution de vérification pour chaque travail dans le workflow, et chaque travail inclut des étapes. GitHub Actions est exécuté en tant qu’étape dans un workflow. Pour plus d’informations sur l’API Vérifications, consultez « Vérifications ».

Remarque : Vérifiez que vous commitez uniquement des fichiers de workflow valides dans votre dépôt. Si .github/workflows contient un fichier de workflow non valide, GitHub Actions génère une exécution de workflow défaillante pour chaque nouveau commit.

Affichage des journaux pour diagnostiquer les défaillances

Si l’exécution de votre workflow échoue, vous pouvez voir quelle étape a provoqué l’échec et passer en revue les journaux de génération de l’étape ayant échoué pour résoudre les problèmes. Vous pouvez voir le temps nécessaire à l’exécution de chaque étape. Vous pouvez également copier un lien permanent vers une ligne spécifique dans le fichier journal à partager avec votre équipe. L’accès en lecture au dépôt est requis pour effectuer ces étapes.

Outre les étapes configurées dans le fichier de workflow, GitHub ajoute deux étapes supplémentaires à chaque travail pour configurer et terminer l’exécution du travail. Ces étapes sont enregistrées dans l’exécution du workflow avec les noms « Configurer un travail » et « Terminer un travail ».

Pour les travaux exécutés sur les exécuteurs hébergés par GitHub, « Configurer un travail » enregistre les détails de l’image de l’exécuteur et inclut un lien vers la liste des outils préinstallés présents sur l’ordinateur de l’exécuteur.

  1. Dans GitHub.com, accédez à la page principale du dépôt. 1. Sous le nom de votre référentiel, cliquez sur Actions. Onglet Actions dans le volet de navigation du dépôt principal 1. Dans la barre latérale gauche, cliquez sur le workflow que vous souhaitez afficher. Liste de workflows dans la barre latérale à gauche 1. Dans la liste des exécutions de workflow, cliquez sur le nom de l’exécution pour voir le résumé de l’exécution du workflow.

    Nom de l’exécution de workflow 1. Sous Travaux ou dans le graphe de visualisation, cliquez sur le travail que vous souhaitez afficher.

    Travail du codebase lint 1. Toutes les étapes qui ont échoué sont automatiquement développées pour afficher les résultats.

    Résultats de workflow super linter 1. Si vous le souhaitez, pour bénéficier d’un lien vers une ligne spécifique des journaux, cliquez sur le numéro de ligne de l’étape. Vous pouvez ensuite copier le lien à partir de la barre d’adresses de votre navigateur web.

    Bouton permettant de copier le lien

Recherche dans les journaux

Vous pouvez rechercher dans les journaux de génération une étape particulière. Lorsque vous effectuez une recherche dans les journaux, seules les étapes développées sont incluses dans les résultats. L’accès en lecture au dépôt est requis pour effectuer ces étapes.

  1. Dans GitHub.com, accédez à la page principale du dépôt. 1. Sous le nom de votre référentiel, cliquez sur Actions. Onglet Actions dans le volet de navigation du dépôt principal 1. Dans la barre latérale gauche, cliquez sur le workflow que vous souhaitez afficher. Liste de workflows dans la barre latérale à gauche 1. Dans la liste des exécutions de workflow, cliquez sur le nom de l’exécution pour voir le résumé de l’exécution du workflow.

    Nom de l’exécution de workflow 1. Sous Travaux ou dans le graphe de visualisation, cliquez sur le travail que vous souhaitez afficher.

    Travail du codebase lint

  2. Dans le coin supérieur droit de la sortie du journal, dans la zone de recherche Rechercher dans les journaux, tapez une requête de recherche. Zone de recherche pour rechercher dans les journaux

Téléchargement des journaux

Vous pouvez télécharger les fichiers journaux à partir de votre exécution de workflow. Vous pouvez également télécharger les artefacts d’un workflow. Pour plus d’informations, consultez « Persistance des données de workflow à l’aide d’artefacts ». L’accès en lecture au dépôt est requis pour effectuer ces étapes.

  1. Dans GitHub.com, accédez à la page principale du dépôt. 1. Sous le nom de votre référentiel, cliquez sur Actions. Onglet Actions dans le volet de navigation du dépôt principal 1. Dans la barre latérale gauche, cliquez sur le workflow que vous souhaitez afficher. Liste de workflows dans la barre latérale à gauche 1. Dans la liste des exécutions de workflow, cliquez sur le nom de l’exécution pour voir le résumé de l’exécution du workflow.

    Nom de l’exécution de workflow 1. Sous Travaux ou dans le graphe de visualisation, cliquez sur le travail que vous souhaitez afficher.

    Travail du codebase lint

  2. Dans le coin supérieur droit, cliquez sur et sélectionnez Télécharger l’archive des journaux.

    Menu déroulant Télécharger les journaux

Remarque : Lorsque vous téléchargez l’archive des journaux pour un workflow partiellement réexécuté, l’archive inclut uniquement les travaux qui ont été réexécutés. Pour obtenir un ensemble complet de journaux pour les travaux exécutés à partir d’un workflow, vous devez télécharger les archives des journaux pour les tentatives d’exécution précédentes qui ont exécuté les autres travaux.

Suppression des journaux

Vous pouvez supprimer les fichiers journaux à partir de votre exécution de workflow. L’accès en écriture au dépôt est requis pour effectuer ces étapes.

  1. Dans GitHub.com, accédez à la page principale du dépôt. 1. Sous le nom de votre référentiel, cliquez sur Actions. Onglet Actions dans le volet de navigation du dépôt principal 1. Dans la barre latérale gauche, cliquez sur le workflow que vous souhaitez afficher. Liste de workflows dans la barre latérale à gauche 1. Dans la liste des exécutions de workflow, cliquez sur le nom de l’exécution pour voir le résumé de l’exécution du workflow.

    Nom de l’exécution de workflow

  2. Dans le coin supérieur droit, cliquez sur .

    Icône de menu kebab horizontal

  3. Pour supprimer les fichiers journaux, cliquez sur le bouton Supprimer tous les journaux et passez en revue l’invite de confirmation.

    Supprimer tous les journaux

Une fois les journaux supprimés, le bouton Supprimer tous les journaux est supprimé pour indiquer qu’aucun fichier journal n’est conservé dans l’exécution de workflow.

Affichage des journaux avec GitHub CLI

Pour en savoir plus sur GitHub CLI, consultez « À propos de GitHub CLI ».

Pour afficher le journal d’un travail spécifique, utilisez la sous-commande run view. Remplacez run-id par l’ID de l’exécution pour laquelle vous voulez afficher des journaux. GitHub CLI retourne un menu interactif pour vous permettre de choisir un travail à partir de l’exécution. Si vous ne spécifiez pas run-id, GitHub CLI retourne un menu interactif pour vous permettre de choisir une exécution récente, puis un autre menu interactif pour vous permettre de choisir un travail à partir de l’exécution.

gh run view run-id --log

Vous pouvez également utiliser l’indicateur --job pour spécifier un ID de travail. Remplacez job-id par l’ID du travail pour lequel vous voulez afficher des journaux.

gh run view --job job-id --log

Vous pouvez utiliser grep pour effectuer une recherche dans le journal. Par exemple, cette commande retourne toutes les entrées de journal qui contiennent le mot error.

gh run view --job job-id --log | grep error

Pour filtrer les journaux selon les étapes ayant échoué, utilisez --log-failed plutôt que --log.

gh run view --job job-id --log-failed