# Включение ведения журналов отладки

Если журналы рабочих процессов не предоставляют достаточно сведений для диагностики причин несоответствующего выполнения рабочего процесса, задания или шага, можно дополнительно включить ведение журнала отладки.

> \[!NOTE]
> GitHub Enterprise Serverразмещенные в данный момент средства выполнения не поддерживаются в GitHub.

Эти дополнительные журналы включены путем задания секретов или переменных в репозитории, содержащего рабочий процесс, поэтому те же требования к разрешениям будут применяться:

* Чтобы создать секреты или переменные на GitHub для репозитория организации, необходимо иметь `write` доступ. Для репозитория личной учетной записи вы должны быть соавтором репозитория.
* Чтобы создать секреты или переменные для среды в репозитории личная учетная запись, необходимо быть владельцем репозитория. Чтобы создать секреты или переменные для среды в репозитории организации, необходимо иметь `admin` доступ. Дополнительные сведения о средах см. в разделе [Управление средами для развертывания](/ru/enterprise-server@3.22/actions/how-tos/deploy/configure-and-manage-deployments/manage-environments).
* Владельцы и пользователи организации с разрешениями "Управление переменными действий организации" или "Управление секретами действий организации" могут создавать секреты или переменные на уровне организации.

Для получения дополнительной информации см. [Разрешения на кастомные организационные роли](/ru/enterprise-server@3.22/organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles).

Дополнительные сведения о настройке секретов и переменных см. в разделе \[AUTOTITLE и [Использование секретов в GitHub Actions](/ru/enterprise-server@3.22/actions/how-tos/write-workflows/choose-what-workflows-do/use-secrets)]\(/actions/how-tos/write-workflows/choose-what-workflows-do/use-variables).

Кроме того, любой пользователь, имеющий доступ к запуску рабочего процесса, может включить ведение журнала диагностики средства выполнения тестов и ведение журнала пошаговой отладки для повторного запуска рабочего процесса. Дополнительные сведения см. в разделе [Повторный запуск рабочих процессов и заданий](/ru/enterprise-server@3.22/actions/how-tos/manage-workflow-runs/re-run-workflows-and-jobs).

## Включение ведения журнала диагностики средства выполнения

Ведение журнала диагностики средства выполнения предоставляет дополнительные файлы журнала, содержащие сведения о том, как средство выполнения выполняет задание. В архив журнала добавляются два дополнительных файла журнала:

* Журнал процессов средства выполнения, который содержит сведения о координации и настройке средства для выполнения заданий.
* Журнал рабочих процессов, который регистрирует выполнение задания.

1. Чтобы включить ведение журнала диагностики runner, задайте в репозитории следующий секрет или переменную, содержащую рабочий процесс: `ACTIONS_RUNNER_DEBUG` значение `true`. Если заданы секрет и переменная, значение секрета имеет приоритет над переменной.
2. Чтобы скачать журналы диагностики средства выполнения, скачайте архив журналов выполнения рабочего процесса. Журналы диагностики средства выполнения содержатся в папке `runner-diagnostic-logs`. Дополнительные сведения о скачивании журналов см. в разделе [Использование журналов выполнения рабочих процессов](/ru/enterprise-server@3.22/actions/how-tos/monitor-workflows/use-workflow-run-logs#downloading-logs).

## Включение ведения журнала отладки шагов

Ведение журнала отладки шагов повышает уровень детализации журналов задания во время и после выполнения задания.

1. Чтобы включить ведение журнала отладки шага, задайте в репозитории следующий секрет или переменную, содержащую рабочий процесс: `ACTIONS_STEP_DEBUG``true`. Если заданы секрет и переменная, значение секрета имеет приоритет над переменной.
2. После задания секрета или переменной в журналах шагов отображаются дополнительные события отладки. Дополнительные сведения см. в разделе [Использование журналов выполнения рабочих процессов](/ru/enterprise-server@3.22/actions/how-tos/monitor-workflows/use-workflow-run-logs#viewing-logs-to-diagnose-failures).

Вы также можете использовать `runner.debug` контекст для условного запуска шагов только при включении отладочных логировок. Дополнительные сведения см. в разделе [Справочник по контекстам](/ru/enterprise-server@3.22/actions/reference/workflows-and-actions/contexts#runner-context).