Skip to main content
我们经常发布文档更新,此页面的翻译可能仍在进行中。 有关最新信息,请访问英语文档

启用调试日志记录

如果工作流程日志没有提供足够的详细信息来诊断工作流程、作业或步骤未按预期工作的原因,您可以启用额外的调试日志。

注意:GitHub Enterprise Server 目前不支持 GitHub 托管的运行器。 可以在 GitHub public roadmap 上查看有关未来支持计划的更多信息。

这些额外的日志将通过在包含工作流的仓库中设置机密来启用,因此将应用相同的权限要求:

  • 要为个人帐户存储库创建机密,你必须是存储库所有者。 要为组织存储库创建机密,你必须拥有 admin 访问权限。
  • 若要在个人帐户存储库中为某个环境创建机密,你必须是存储库所有者。 若要在组织存储库中为某个环境创建机密,你必须拥有 admin 访问权限。
  • 要在组织级别创建机密,必须拥有 admin 访问权限。

若要详细了解如何设置机密,请参阅“加密机密”。

此外,有权运行工作流的任何人都可以为工作流重新运行启用运行器诊断日志记录和步骤调试日志记录。 有关详细信息,请参阅“重新运行工作流和作业”。

启用运行程序诊断日志

Runner diagnostic logging provides additional log files that contain information about how a runner is executing a job. 两个额外的日志文件被添加到日志存档中:

  • 运行程序进程日志,其中包含关于如何协调和设置运行程序执行作业的信息。
  • 工作程序进程日志,用于记录作业执行情况。
  1. 若要启用运行器诊断日志记录,请在包含工作流 ACTIONS_RUNNER_DEBUG 的存储库中将以下机密设置为 true
  2. 要下载运行程序诊断日志,请下载工作流程运行情况的日志存档。 运行程序诊断日志包含在 runner-diagnostic-logs 文件夹中。 关于下载日志的详细信息,请参阅“下载日志”。

启用步骤调试日志

步骤调试日志增加了作业执行期间和执行之后的作业日志的详细程度。

  1. 若要启用步骤调试日志记录,请在包含工作流 ACTIONS_STEP_DEBUG 的存储库中将以下机密设置为 true
  2. 设置机密后,步骤日志中会显示更多调试事件。 有关详细信息,请参阅“查看日志以诊断故障”