{"meta":{"title":"Использование журналов выполнения рабочих процессов","intro":"Вы можете просматривать, искать и скачивать журналы для каждого задания в выполнении рабочего процесса.","product":"GitHub Actions","breadcrumbs":[{"href":"/ru/actions","title":"GitHub Actions"},{"href":"/ru/actions/how-tos","title":"Инструкции"},{"href":"/ru/actions/how-tos/monitor-workflows","title":"Мониторинг рабочих процессов"},{"href":"/ru/actions/how-tos/monitor-workflows/use-workflow-run-logs","title":"Использование журналов выполнения рабочего процесса"}],"documentType":"article"},"body":"# Использование журналов выполнения рабочих процессов\n\nВы можете просматривать, искать и скачивать журналы для каждого задания в выполнении рабочего процесса.\n\nНа странице выполнения рабочего процесса можно посмотреть состояние рабочего процесса, выполняется он или завершен. Для просмотра сведений о выполнении рабочего процесса, включая общедоступные репозитории, необходимо войти в учетную запись GitHub. Дополнительные сведения см. в разделе [Права доступа на GitHub](/ru/get-started/learning-about-github/access-permissions-on-github).\n\nЕсли выполнение завершилось, вы можете узнать, был ли результат успешным, неудачным, отмененным или нейтральным. Если выполнение завершилось неудачно, можно просмотреть журналы сборки и выполнить по ним поиск, чтобы диагностировать сбой и повторно запустить рабочий процесс. Вы также можете просматривать оплачиваемые минуты выполнения задания, а также скачивать журналы и артефакты сборки.\n\nGitHub Actions использует API проверок для вывода состояний, результатов и журналов рабочего процесса. GitHub создает новый набор проверок для каждого запуска рабочего процесса. Набор проверок содержит контрольный прогон для каждого задания в рабочем процессе, и каждое задание включает шаги. GitHub Actions выполняются как шаг в рабочем процессе. Дополнительные сведения об API проверки см. в разделе [Конечные точки REST API для проверок](/ru/rest/checks).\n\n> \\[!NOTE]\n> Убедитесь, что в репозитории фиксируются только допустимые файлы рабочего процесса. Если `.github/workflows` содержит недопустимый файл рабочего процесса, GitHub Actions создает для каждой новой фиксации рабочий процесс, завершающийся сбоем.\n\n## Просмотр журналов для диагностики сбоев\n\nЕсли выполнение рабочего процесса завершается неудачно, вы можете увидеть, какой шаг вызвал сбой, и проверить журналы сборки неудачного шага, чтобы устранить неполадки. Вы можете увидеть время, необходимое для выполнения каждого шага. Вы также можете скопировать постоянную ссылку на определенную строку в файле журнала, чтобы поделиться со своей командой. Для выполнения этих действий требуется доступ на чтение к репозиторию.\n\nПомимо шагов, настроенных в файле рабочего процесса, GitHub добавляет в каждое задание два дополнительных шага для настройки и завершения выполнения задания. Эти шаги регистрируются в рабочем процессе с именами \"Настройка задания\" и \"Завершение задания\".\n\nДля заданий, выполняемых в средствах выполнения, размещенных в GitHub, шаг \"Настройка задания\" записывает сведения об образе средства выполнения и включает ссылку на список предустановленных средств, которые имелись на компьютере средства выполнения.\n\n1. На GitHubперейдите на главную страницу репозитория.\n2. Под именем репозитория щелкните ** Actions**.\n\n \n3. На левой боковой панели щелкните нужный рабочий процесс.\n\n \n4. В списке запусков рабочего процесса щелкните имя запуска, чтобы просмотреть сводку по выполнению рабочего процесса.\n5. В разделе **Задания** или на графе визуализации выберите задание, которое требуется просмотреть.\n6. Все неудачные действия автоматически разворачиваются для отображения результатов.\n7. Ссылку на определенную строку в журналах, можно также получить, щелкнув номер строки соответствующего шага. Затем можно скопировать ссылку из адресной строки браузера.\n\n \n\n## Поиск по журналам\n\nВы можете выполнять поиск определенного шага в журналах сборки. При поиске в журналах в результаты включаются только развернутые шаги. Для выполнения этих действий требуется доступ на чтение к репозиторию.\n\n1. На GitHubперейдите на главную страницу репозитория.\n2. Под именем репозитория щелкните ** Actions**.\n\n \n3. На левой боковой панели щелкните нужный рабочий процесс.\n\n \n4. В списке запусков рабочего процесса щелкните имя запуска, чтобы просмотреть сводку по выполнению рабочего процесса.\n5. В разделе **Задания** или на графе визуализации выберите задание, которое требуется просмотреть.\n6. В правом верхнем углу выходных данных журнала в поле **поиска по журналам** введите поисковый запрос.\n\n## Скачивание журналов\n\nВы можете скачивать файлы журналов из запуска рабочего процесса. Вы также можете скачать артефакты рабочего процесса. Дополнительные сведения см. в разделе [Хранение и предоставление общего доступа к данным с артефактами рабочего процесса](/ru/actions/using-workflows/storing-workflow-data-as-artifacts). Для выполнения этих действий требуется доступ на чтение к репозиторию.\n\n1. На GitHubперейдите на главную страницу репозитория.\n2. Под именем репозитория щелкните ** Actions**.\n\n \n3. На левой боковой панели щелкните нужный рабочий процесс.\n\n \n4. В списке запусков рабочего процесса щелкните имя запуска, чтобы просмотреть сводку по выполнению рабочего процесса.\n5. В разделе **Задания** или на графе визуализации выберите задание, которое требуется просмотреть.\n6. В правом верхнем углу журнала выберите раскрывающееся меню (Показать параметры) и нажмите кнопку **\"Скачать архив** журнала\".\n\n \n\n> \\[!NOTE]\n> При скачивании архива журналов для рабочего процесса, который был частично выполнен повторно, архив включает только задания, которые были повторно запущены. Чтобы получить полный набор журналов для заданий, который выполнялись из рабочего процесса, необходимо скачать архивы журналов для предыдущих попыток запуска, в которых выполнялись другие задания.\n\n## Удаление журналов\n\nФайлы журнала можно удалить из рабочего процесса через веб-интерфейс GitHub или программным способом. Для выполнения этих действий требуется доступ для записи в репозиторий.\n\n### Удаление журналов с помощью веб-интерфейса GitHub\n\n1. На GitHubперейдите на главную страницу репозитория.\n\n2. Под именем репозитория щелкните ** Actions**.\n\n \n\n3. На левой боковой панели щелкните нужный рабочий процесс.\n\n \n\n4. В списке запусков рабочего процесса щелкните имя запуска, чтобы просмотреть сводку по выполнению рабочего процесса.\n\n5. В правом верхнем углу выберите раскрывающееся меню и нажмите кнопку **\"Удалить все журналы**\".\n\n \n\n6. Просмотрите запрос подтверждения.\n\nПосле удаления журналов кнопка **Удалить все журналы** исчезает. Это указывает, что ы рабочем процессе больше не осталось файлов журналов.\n\n### Удаление журналов программным способом\n\nДля автоматического удаления всех журналов рабочего процесса можно использовать следующий скрипт. Это может быть полезным способом очистки журналов для нескольких запусков рабочего процесса.\n\nЧтобы запустить приведенный ниже пример скрипта:\n\n1. Скопируйте пример кода и сохраните его в файл с именем `delete-logs.sh`.\n2. Предоставьте ему разрешение на выполнение с `chmod +x delete-logs.sh`помощью .\n3. Выполните следующую команду, где `REPOSITORY_NAME` имя репозитория и `WORKFLOW_NAME` имя файла рабочего процесса.\n\n ```shell copy\n ./delete-logs.sh REPOSITORY_NAME WORKFLOW_NAME\n ```\n\n Например, чтобы удалить все журналы в `monalisa/octocat` репозитории для `.github/workflows/ci.yaml` рабочего процесса, выполните команду `./delete-logs.sh monalisa/octocat ci.yaml`.\n\n#### Пример сценария\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## Просмотр журналов с помощью GitHub CLI\n\n> \\[!NOTE]\n> Дополнительные сведения о GitHub CLIсм. в разделе [О GitHub CLI](/ru/github-cli/github-cli/about-github-cli).\n\nЧтобы просмотреть журнал для определенного задания, используйте подкоманду `run view`. Замените `run-id` идентификатором запуска, для которого вы хотите просмотреть журналы. GitHub CLI отобразит интерактивное меню для выбора задания из запуска. Если вы не укажете `run-id`, GitHub CLI отобразит интерактивное меню для выбора последнего запуска, а затем другое интерактивное меню для выбора задания из этого запуска.\n\n```shell\ngh run view RUN_ID --log\n```\n\nВы также можете указать идентификатор задания с помощью флага `--job`. Замените `job-id` идентификатором задания, для которого вы хотите просмотреть журналы.\n\n```shell\ngh run view --job JOB_ID --log\n```\n\nВы можете использовать `grep` для поиска в журнале. Например, следующая команда вернет все записи журнала, содержащие слово `error`.\n\n```shell\ngh run view --job JOB_ID --log | grep error\n```\n\nЧтобы отфильтровать журналы для вывода всех неудачных шагов, используйте `--log-failed` вместо `--log`.\n\n```shell\ngh run view --job JOB_ID --log-failed\n```"}