Skip to main content

启用调试日志记录

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

Note

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

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

  • 若要在 GitHub 上为个人帐户存储库创建机密或变量,你必须是存储库所有者。 若要在 GitHub 上为组织存储库创建机密或变量,你必须拥有 admin 访问权限。 最后,若要通过 REST API 为个人帐户存储库或组织存储库创建机密或变量,你必须拥有协作者访问权限。
  • 要为个人帐户存储库中的环境创建密码或变量,你必须是存储库所有者。 要为组织存储库中的环境创建密码或变量,必须具有 admin 访问权限。 有关环境的详细信息,请参阅“管理部署环境”。
  • 组织所有者和拥有“管理组织操作变量”或“管理组织操作机密”权限的用户可以在组织级别创建机密或变量。

有关详细信息,请参阅“关于自定义组织角色”。

有关设置机密或变量的详细信息,请参阅“在 GitHub Actions 中使用机密”和“在变量中存储信息”。

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

启用运行程序诊断日志

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

  • 运行程序进程日志,其中包含关于如何协调和设置运行程序执行作业的信息。
  • 工作程序进程日志,用于记录作业执行情况。
  1. 若要启用运行器诊断日志记录,请设置包含工作流的存储库中的以下机密或变量设置:ACTIONS_RUNNER_DEBUGtrue。 如果同时设置了机密和变量,则机密的值优先于变量。
  2. 要下载运行程序诊断日志,请下载工作流程运行情况的日志存档。 运行程序诊断日志包含在 runner-diagnostic-logs 文件夹中。 关于下载日志的详细信息,请参阅“使用工作流运行日志”。

启用步骤调试日志

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

  1. 若要启用步骤调试日志记录,请设置包含工作流的存储库中的以下机密或变量设置:ACTIONS_STEP_DEBUGtrue。 如果同时设置了机密和变量,则机密的值优先于变量。
  2. 设置机密或变量后,步骤日志中将显示更多的调试事件。 有关详细信息,请参阅“使用工作流运行日志”。