{"meta":{"title":"Utilisation des journaux d’exécution de flux de travail","intro":"Vous pouvez afficher, rechercher et télécharger les journaux pour chaque travail dans une exécution de workflow.","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/use-workflow-run-logs","title":"Utiliser les journaux d’exécution du flux de travail"}],"documentType":"article"},"body":"# Utilisation des journaux d’exécution de flux de travail\n\nVous pouvez afficher, rechercher et télécharger les journaux pour chaque travail dans une exécution de workflow.\n\nVous 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](/fr/get-started/learning-about-github/access-permissions-on-github) ».\n\nSi 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.\n\nGitHub 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 « [Points de terminaison d’API REST pour les vérifications](/fr/rest/checks) ».\n\n> \\[!NOTE]\n> 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.\n\n## Visualisation des logs pour diagnostiquer les défaillances\n\nSi 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.\n\nOutre 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 ».\n\nPour 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.\n\n1. Sur GitHub, accédez à la page principale du référentiel.\n2. Sous le nom de votre référentiel, cliquez sur ** Actions**.\n\n \n3. Dans la barre latérale gauche, cliquez sur le workflow que vous souhaitez afficher.\n\n \n4. 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.\n5. Sous **Travaux** ou dans le graphe de visualisation, cliquez sur le travail que vous souhaitez afficher.\n6. Toutes les étapes qui ont échoué sont automatiquement développées pour afficher les résultats.\n7. 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.\n\n \n\n## Recherche dans les logs\n\nVous 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.\n\n1. Sur GitHub, accédez à la page principale du référentiel.\n2. Sous le nom de votre référentiel, cliquez sur ** Actions**.\n\n \n3. Dans la barre latérale gauche, cliquez sur le workflow que vous souhaitez afficher.\n\n \n4. 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.\n5. Sous **Travaux** ou dans le graphe de visualisation, cliquez sur le travail que vous souhaitez afficher.\n6. 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.\n\n## Téléchargement des logs\n\nVous 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 « [Stocker et partager des données avec les artefacts de workflow](/fr/actions/using-workflows/storing-workflow-data-as-artifacts) ». L’accès en lecture au dépôt est requis pour effectuer ces étapes.\n\n1. Sur GitHub, accédez à la page principale du référentiel.\n2. Sous le nom de votre référentiel, cliquez sur ** Actions**.\n\n \n3. Dans la barre latérale gauche, cliquez sur le workflow que vous souhaitez afficher.\n\n \n4. 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.\n5. Sous **Travaux** ou dans le graphe de visualisation, cliquez sur le travail que vous souhaitez afficher.\n6. Dans le coin supérieur droit du journal, sélectionnez le menu déroulant et cliquez sur **Télécharger l’archive du journal**.\n\n \n\n> \\[!NOTE]\n> Lorsque vous téléchargez l’archive des logs pour un workflow partiellement réexécuté, l’archive inclut uniquement les tâches qui ont été réexécutées. 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.\n\n## Suppression des journaux\n\nVous pouvez supprimer les fichiers journaux de l’exécution de votre workflow via l’interface web GitHub ou par programmation. L’accès en écriture au dépôt est requis pour effectuer ces étapes.\n\n### Suppression des journaux via l’interface web GitHub\n\n1. Sur GitHub, accédez à la page principale du référentiel.\n\n2. Sous le nom de votre référentiel, cliquez sur ** Actions**.\n\n \n\n3. Dans la barre latérale gauche, cliquez sur le workflow que vous souhaitez afficher.\n\n \n\n4. 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.\n\n5. Dans le coin supérieur droit, sélectionnez le menu déroulant et cliquez sur **Supprimer tous les journaux**.\n\n \n\n6. Passez en revue la fenêtre de confirmation.\n\nUne 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.\n\n### Suppression des journaux par programmation\n\nVous pouvez utiliser le script suivant pour supprimer automatiquement tous les journaux d’activité d’un workflow. Il peut s'agir d'un moyen utile de nettoyer les logs lors de l'exécution de plusieurs workflows.\n\nPour exécuter l’exemple de script ci-dessous :\n\n1. Copiez l’exemple de code et enregistrez-le dans un fichier appelé `delete-logs.sh`.\n2. Octroyez les autorisations d’exécution avec `chmod +x delete-logs.sh`.\n3. Exécutez la commande suivante, où `REPOSITORY_NAME` correspond au nom de votre référentiel et `WORKFLOW_NAME` au nom de fichier de votre workflow.\n\n ```shell copy\n ./delete-logs.sh REPOSITORY_NAME WORKFLOW_NAME\n ```\n\n Par exemple, pour supprimer tous les journaux dans le référentiel `monalisa/octocat` pour le workflow `.github/workflows/ci.yaml`, vous exécuteriez `./delete-logs.sh monalisa/octocat ci.yaml`.\n\n#### Exemple de script\n\n```bash copy\n#!/usr/bin/env bash\n\n# Delete all logs for a given workflow\n# Usage: delete-logs.sh \n\nset -oe pipefail\n\nREPOSITORY=$1\nWORKFLOW_NAME=$2\n\n# Validate arguments\nif [[ -z \"$REPOSITORY\" ]]; then\n echo \"Repository is required\"\n exit 1\nfi\n\nif [[ -z \"$WORKFLOW_NAME\" ]]; then\n echo \"Workflow name is required\"\n exit 1\nfi\n\necho \"Getting all completed runs for workflow $WORKFLOW_NAME in $REPOSITORY\"\n\nRUNS=$(\n gh api \\\n -H \"Accept: application/vnd.github+json\" \\\n -H \"X-GitHub-Api-Version: 2022-11-28\" \\\n \"/repos/$REPOSITORY/actions/workflows/$WORKFLOW_NAME/runs\" \\\n --paginate \\\n --jq '.workflow_runs[] | select(.conclusion != \"\") | .id'\n)\n\necho \"Found $(echo \"$RUNS\" | wc -l) completed runs for workflow $WORKFLOW_NAME\"\n\n# Delete logs for each run\nfor RUN in $RUNS; do\n echo \"Deleting logs for run $RUN\"\n gh api \\\n --silent \\\n --method DELETE \\\n -H \"Accept: application/vnd.github+json\" \\\n -H \"X-GitHub-Api-Version: 2022-11-28\" \\\n \"/repos/$REPOSITORY/actions/runs/$RUN/logs\" || echo \"Failed to delete logs for run $RUN\"\n\n # Sleep for 100ms to avoid rate limiting\n sleep 0.1\ndone\n```\n\n## Affichage des journaux avec GitHub CLI\n\n> \\[!NOTE]\n> Pour plus d’informations sur GitHub CLI, consultez [À propos de l’interface CLI GitHub](/fr/github-cli/github-cli/about-github-cli).\n\nPour 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 vous permettant de choisir une tâche à partir de l'exécution en cours. 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.\n\n```shell\ngh run view RUN_ID --log\n```\n\nVous 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.\n\n```shell\ngh run view --job JOB_ID --log\n```\n\nVous 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`.\n\n```shell\ngh run view --job JOB_ID --log | grep error\n```\n\nPour filtrer les journaux selon les étapes ayant échoué, utilisez `--log-failed` plutôt que `--log`.\n\n```shell\ngh run view --job JOB_ID --log-failed\n```"}