# Использование журналов выполнения рабочих процессов
Вы можете просматривать, искать и скачивать журналы для каждого задания в выполнении рабочего процесса.
> \[!NOTE]
> GitHub Enterprise Serverразмещенные в данный момент средства выполнения не поддерживаются в GitHub.
На странице выполнения рабочего процесса можно посмотреть состояние рабочего процесса, выполняется он или завершен. Для просмотра сведений о выполнении GitHub рабочего процесса необходимо войти в учетную запись, включая общедоступные репозитории. Дополнительные сведения см. в разделе [Права доступа на GitHub](/ru/enterprise-server@3.22/get-started/learning-about-github/access-permissions-on-github).
Если выполнение завершилось, вы можете узнать, был ли результат успешным, неудачным, отмененным или нейтральным. Если выполнение завершилось неудачно, можно просмотреть журналы сборки и выполнить по ним поиск, чтобы диагностировать сбой и повторно запустить рабочий процесс. Вы также можете просматривать оплачиваемые минуты выполнения задания, а также скачивать журналы и артефакты сборки.
GitHub Actions используйте API проверки для вывода состояний, результатов и журналов для рабочего процесса.
GitHub создает новый набор контрольных наборов для каждого запуска рабочего процесса. Набор проверок содержит контрольный прогон для каждого задания в рабочем процессе, и каждое задание включает шаги.
GitHub Actions выполняются как шаг в рабочем процессе. Дополнительные сведения об API проверки см. в разделе [Конечные точки REST API для проверок](/ru/enterprise-server@3.22/rest/checks).
> \[!NOTE]
> Убедитесь, что в репозитории фиксируются только допустимые файлы рабочего процесса. Если `.github/workflows` содержит недопустимый файл рабочего процесса, GitHub Actions создает для каждой новой фиксации рабочий процесс, завершающийся сбоем.
## Просмотр журналов для диагностики сбоев
Если выполнение рабочего процесса завершается неудачно, вы можете увидеть, какой шаг вызвал сбой, и проверить журналы сборки неудачного шага, чтобы устранить неполадки. Вы можете увидеть время, необходимое для выполнения каждого шага. Вы также можете скопировать постоянную ссылку на определенную строку в файле журнала, чтобы поделиться со своей командой. Для выполнения этих действий требуется доступ на чтение к репозиторию.
Помимо шагов, настроенных в файле рабочего процесса, GitHub добавляет два дополнительных шага к каждому заданию, чтобы настроить и завершить выполнение задания. Эти шаги регистрируются в рабочем процессе с именами "Настройка задания" и "Завершение задания".
Для заданий, выполняющихся в GitHubузлах runners, "Настройка задания" записывает сведения об образе средства выполнения и содержит ссылку на список предварительно установленных средств, которые присутствовали на компьютере runner.
1. На GitHubперейдите на главную страницу репозитория.
2. Под именем репозитория щелкните ** Actions**.
3. На левой боковой панели щелкните нужный рабочий процесс.
4. В списке запусков рабочего процесса щелкните имя запуска, чтобы просмотреть сводку по выполнению рабочего процесса.
5. В разделе **Задания** или на графе визуализации выберите задание, которое требуется просмотреть.
6. Все неудачные действия автоматически разворачиваются для отображения результатов.
7. Ссылку на определенную строку в журналах, можно также получить, щелкнув номер строки соответствующего шага. Затем можно скопировать ссылку из адресной строки браузера.
## Поиск по журналам
Вы можете выполнять поиск определенного шага в журналах сборки. При поиске в журналах в результаты включаются только развернутые шаги. Для выполнения этих действий требуется доступ на чтение к репозиторию.
1. На GitHubперейдите на главную страницу репозитория.
2. Под именем репозитория щелкните ** Actions**.
3. На левой боковой панели щелкните нужный рабочий процесс.
4. В списке запусков рабочего процесса щелкните имя запуска, чтобы просмотреть сводку по выполнению рабочего процесса.
5. В разделе **Задания** или на графе визуализации выберите задание, которое требуется просмотреть.
6. В правом верхнем углу выходных данных журнала в поле **поиска по журналам** введите поисковый запрос.
## Скачивание журналов
Вы можете скачивать файлы журналов из запуска рабочего процесса. Вы также можете скачать артефакты рабочего процесса. Дополнительные сведения см. в разделе [Хранение и предоставление общего доступа к данным с артефактами рабочего процесса](/ru/enterprise-server@3.22/actions/tutorials/store-and-share-data). Для выполнения этих действий требуется доступ на чтение к репозиторию.
1. На GitHubперейдите на главную страницу репозитория.
2. Под именем репозитория щелкните ** Actions**.
3. На левой боковой панели щелкните нужный рабочий процесс.
4. В списке запусков рабочего процесса щелкните имя запуска, чтобы просмотреть сводку по выполнению рабочего процесса.
5. В разделе **Задания** или на графе визуализации выберите задание, которое требуется просмотреть.
6. В правом верхнем углу журнала выберите раскрывающееся меню и нажмите кнопку **"Скачать архив журналов**".
> \[!NOTE]
> При скачивании архива журналов для рабочего процесса, который был частично выполнен повторно, архив включает только задания, которые были повторно запущены. Чтобы получить полный набор журналов для заданий, который выполнялись из рабочего процесса, необходимо скачать архивы журналов для предыдущих попыток запуска, в которых выполнялись другие задания.
## Удаление журналов
Файлы журнала можно удалить из рабочего процесса через GitHub веб-интерфейс или программным способом. Для выполнения этих действий требуется доступ для записи в репозиторий.
### Удаление журналов через GitHub веб-интерфейс
1. На GitHubперейдите на главную страницу репозитория.
2. Под именем репозитория щелкните ** Actions**.
3. На левой боковой панели щелкните нужный рабочий процесс.
4. В списке запусков рабочего процесса щелкните имя запуска, чтобы просмотреть сводку по выполнению рабочего процесса.
5. В правом верхнем углу выберите раскрывающееся меню и нажмите кнопку **"Удалить все журналы**".
6. Просмотрите запрос подтверждения.
После удаления журналов кнопка **Удалить все журналы** исчезает. Это указывает, что ы рабочем процессе больше не осталось файлов журналов.
### Удаление журналов программным способом
Для автоматического удаления всех журналов рабочего процесса можно использовать следующий скрипт. Это может быть полезным способом очистки журналов для нескольких запусков рабочего процесса.
Чтобы запустить приведенный ниже пример скрипта:
1. Скопируйте пример кода и сохраните его в файл с именем `delete-logs.sh`.
2. Предоставьте ему разрешение на выполнение с `chmod +x delete-logs.sh`помощью .
3. Выполните следующую команду, где `REPOSITORY_NAME` имя репозитория и `WORKFLOW_NAME` имя файла рабочего процесса.
```shell copy
./delete-logs.sh REPOSITORY_NAME WORKFLOW_NAME
```
Например, чтобы удалить все журналы в `monalisa/octocat` репозитории для `.github/workflows/ci.yaml` рабочего процесса, выполните команду `./delete-logs.sh monalisa/octocat ci.yaml`.
#### Пример сценария
```bash copy
#!/usr/bin/env bash
# Delete all logs for a given workflow
# Usage: delete-logs.sh
set -oe pipefail
REPOSITORY=$1
WORKFLOW_NAME=$2
# Validate arguments
if [[ -z "$REPOSITORY" ]]; then
echo "Repository is required"
exit 1
fi
if [[ -z "$WORKFLOW_NAME" ]]; then
echo "Workflow name is required"
exit 1
fi
echo "Getting all completed runs for workflow $WORKFLOW_NAME in $REPOSITORY"
RUNS=$(
gh api \
-H "Accept: application/vnd.github+json" \
-H "X-GitHub-Api-Version: 2022-11-28" \
"/repos/$REPOSITORY/actions/workflows/$WORKFLOW_NAME/runs" \
--paginate \
--jq '.workflow_runs[] | select(.conclusion != "") | .id'
)
echo "Found $(echo "$RUNS" | wc -l) completed runs for workflow $WORKFLOW_NAME"
# Delete logs for each run
for RUN in $RUNS; do
echo "Deleting logs for run $RUN"
gh api \
--silent \
--method DELETE \
-H "Accept: application/vnd.github+json" \
-H "X-GitHub-Api-Version: 2022-11-28" \
"/repos/$REPOSITORY/actions/runs/$RUN/logs" || echo "Failed to delete logs for run $RUN"
# Sleep for 100ms to avoid rate limiting
sleep 0.1
done
```
## Просмотр журналов с помощью GitHub CLI
> \[!NOTE]
> Дополнительные сведения о GitHub CLIсм. в разделе [О GitHub CLI](/ru/enterprise-server@3.22/github-cli/github-cli/about-github-cli).
Чтобы просмотреть журнал для определенного задания, используйте подкоманду `run view`. Замените `run-id` идентификатором запуска, для которого вы хотите просмотреть журналы.
GitHub CLI возвращает интерактивное меню для выбора задания из запуска. Если вы не указываете `run-id`, GitHub CLI возвращает интерактивное меню для выбора последнего запуска, а затем возвращает другое интерактивное меню для выбора задания из запуска.
```shell
gh run view RUN_ID --log
```
Вы также можете указать идентификатор задания с помощью флага `--job`. Замените `job-id` идентификатором задания, для которого вы хотите просмотреть журналы.
```shell
gh run view --job JOB_ID --log
```
Вы можете использовать `grep` для поиска в журнале. Например, следующая команда вернет все записи журнала, содержащие слово `error`.
```shell
gh run view --job JOB_ID --log | grep error
```
Чтобы отфильтровать журналы для вывода всех неудачных шагов, используйте `--log-failed` вместо `--log`.
```shell
gh run view --job JOB_ID --log-failed
```