跳至主要内容

关于监控和故障排除

你可以使用 GitHub Actions 中的工具来监视和调试你的工作流。

监视你的工作流

监视你的组织或企业中的当前作业

若要识别并发或排队中的任何约束,你可以查看你的组织或企业中当前在 GitHub 托管的运行器上处理了多少个作业。有关更多信息,请参阅“监视你的当前作业”。

使用可视化图形

每个工作流运行都会生成一个实时图形,说明运行进度。你可以使用此图形来监视和调试工作流。例如

Screenshot of the visualization graph of a workflow run.

有关详细信息,请参阅“使用可视化图”。

添加工作流状态徽章

状态徽章显示工作流当前是失败还是通过。添加状态徽章的常见位置是存储库的 README.md 文件,但你可以将其添加到任何你喜欢的网页。默认情况下,徽章显示默认分支的状态。你还可以使用 URL 中的 branchevent 查询参数显示特定分支或事件的工作流运行状态。

Screenshot of a workflow status badge. The left side contains the octocat logo and "GitHub Actions Demo", the name of the workflow. The right half is green with the text "passing."

有关详细信息,请参阅“添加工作流状态徽章”。

查看作业执行时间

要确定作业运行了多长时间,你可以查看其执行时间。有关详细信息,请参阅“查看作业执行时间”。

查看工作流运行历史记录

你可以查看工作流中每个作业和步骤的状态。有关详细信息,请参阅“查看工作流运行历史记录”。

对工作流进行故障排除

使用工作流运行日志

每个工作流运行都会生成活动日志,你可以查看、搜索和下载这些日志。有关详细信息,请参阅“使用工作流运行日志”。

启用调试日志记录

如果工作流日志没有提供足够的详细信息来诊断工作流、作业或步骤为何没有按预期工作,你可以启用其他调试日志记录。有关详细信息,请参阅“启用调试日志记录”。

取消工作流

如果你尝试取消工作流但取消不成功,请确保你没有使用 always 表达式。always 表达式会导致工作流步骤即使在工作流被取消时也会运行,从而导致取消挂起。有关详细信息,请参阅“表达式”。

监视和排除自托管运行程序的故障

如果您使用自托管运行程序,则可以查看其活动并诊断常见问题。

有关更多信息,请参阅“监控和故障排除自托管运行程序”。