Skip to main content

Журналы недостаточно подробные

Увеличивайте многословность логов и генерируйте отладочные артефакты, когда логи не хватают диагностических деталей.

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

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

Логирование отладки шагов увеличивает объяснение логов задания во время и после выполнения.

Для включения поэтапного отладочного логирования:

  1. В репозитории, содержащем рабочий процесс, установите следующий секрет или переменную: ACTIONS_STEP_DEBUG в true. Если заданы секрет и переменная, значение секрета имеет приоритет над переменной.
  2. Запусти рабочий процесс заново или запусти новый запуск.

После задания секрета или переменной в журналах шагов отображаются дополнительные события отладки. См . раздел AUTOTITLE.

Вы также можете использовать runner.debug контекст для условного запуска шагов только при включении отладочных логировок. См . раздел AUTOTITLE.

Создание CodeQL артефактов отладки

Предупреждение

CodeQL Отладка артефактов содержит копию исходного кода, анализируемую CodeQL, поэтому мы рекомендуем совместно использовать эти пакеты только с людьми, которым разрешен доступ к этому исходному коду.

Артефакты можно получить для отладки CodeQL. Отладочные артефакты будут загружаны в рабочий процесс в виде артефактов с именами, начинающимися на debug-artifacts. Если CodeQL анализировать несколько языков одновременно в рамках выполнения рабочего процесса, для каждого языка будет один такой артефакт. Данные содержат CodeQL журналы, базы данных, CodeQL извлеченные файлы исходного кода и все файлы SARIF, созданные рабочим процессом. Дополнительные сведения о скачивании CodeQL артефактов см. в разделе Скачивание артефактов рабочего процесса.

Эти артефакты помогут выполнить отладку проблем.CodeQLcode scanning Если вы обратитесь Служба поддержки GitHub, они могут запросить эти данные.

Создание CodeQL артефактов отладки для CodeQL настройки по умолчанию

Вы можете создавать CodeQL артефакты отладки, включив ведение журнала отладки шага (см. включение ведения журнала отладки шага) и запуская новый анализ, например путем отправки новой CodeQL фиксации в ветвь запроса на вытягивание.

Если у вас есть CodeQL доступ к частным реестрам, будут доступны дополнительные артефакты, имена которых начинаются proxy-log-file . Они содержат журналы прокси-сервера проверки подлинности, который используется CodeQL по умолчанию для проверки подлинности запросов к частным реестрам и может использоваться для устранения неполадок конфигураций частного реестра. Дополнительные сведения см. в разделе Предоставление доступа к частным реестрам функций безопасности.

Создание CodeQL артефактов отладки для CodeQL расширенной настройки

Отладка артефактов для CodeQL расширенной настройки может быть получена различными способами.

Повторный запуск заданий с включённым логированием отладки

Самый простой вариант создания артефактов отладки для CodeQL расширенной настройки — повторное выполнение заданий с включенным ведением журнала отладки. Дополнительные сведения о повторном выполнении GitHub Actions рабочих процессов и заданий см. в разделе Повторный запуск рабочих процессов и заданий.

Необходимо выбрать параметр Включить ведение журнала отладки. Он позволит включить ведение журнала диагностики средства выполнения и ведение журнала отладки шага для выполнения. Затем вы сможете скачать CodeQL артефакты отладки для дальнейшего изучения. При создании CodeQL артефактов отладки при повторном выполнении заданий не требуется изменять файл рабочего процесса.

Использование флага рабочего процесса

Артефакты отладки можно создать CodeQL с помощью флага в рабочем процессе. Для этого необходимо изменить init шаг Рабочий процесс анализа CodeQL файла и задать debug: true.

- name: Initialize CodeQL
  uses: github/codeql-action/init@v4
  with:
    debug: true

Использование GitHub Actions ведения журнала отладки шага

Если включить GitHub Actions ведение журнала отладки шагов, CodeQL то также будут создаваться артефакты отладки и отправлять их в процессе выполнения рабочего процесса. Инструкции смотрите в разделе «Включение этапного отладочного логирования».