查看 GitHub Actions 指标

您可以查看指标来监控您的组织或仓库使用 GitHub Actions 的情况以及它们的性能。

谁可以使用此功能？

拥有“查看组织 Actions 指标”权限的组织所有者和用户可以查看组织级指标。

具有基本仓库角色的用户可以查看仓库级指标。

本文内容

关于 GitHub Actions 指标

GitHub Actions 指标提供了对您的工作流和作业在组织和仓库级别上的执行情况的深入了解。有两种类型的指标可以帮助您分析工作流的不同方面

  • GitHub Actions 使用情况指标：使用情况指标可帮助您跟踪工作流和作业消耗的分钟数。您可以使用这些数据来了解运行 Actions 的成本，并确保您保持在计划限制内。这对于识别高使用率的工作流或仓库特别有用。
  • GitHub Actions 性能指标：性能指标侧重于工作流和作业的效率和可靠性。使用性能指标，您可以监控关键指标，例如作业运行时间、排队时间和失败率，以识别瓶颈、运行缓慢的作业或频繁失败的工作流。

启用对 GitHub Actions 指标的访问

组织所有者可以创建自定义组织角色，以允许用户查看其组织的 GitHub Actions 使用情况指标。要向用户提供访问权限，请在创建自定义组织角色时选择“查看组织 Actions 指标”角色。更多信息，请参见“关于自定义组织角色”。

关于 GitHub Actions 使用情况指标

GitHub Actions 使用情况指标使您可以分析组织如何使用 Actions 分钟数。您可以查看与以下内容相关的使用情况信息：

  • 工作流。查看组织中每个工作流的使用数据，并使用此信息来查找优化机会，例如重构工作流或使用更大的运行器。
  • 作业。查看哪些作业最消耗资源以及它们在何处运行。
  • 代码库。获取组织中每个代码库及其 Actions 分钟数使用量的概览。
  • 运行时操作系统。了解每个操作系统的运行器如何使用 Actions 分钟数，以及工作流最常运行的操作系统类型。
  • 运行器类型。比较自托管运行器和 GitHub 托管运行器如何使用 Actions 分钟数以及每种类型的运行器的流水线运行量。

关于 GitHub Actions 性能指标

注意

GitHub Actions 性能指标目前处于公开预览阶段，如有更改，恕不另行通知。

GitHub Actions 性能指标使您可以分析工作流的效率和可靠性。您可以查看与以下内容相关的性能信息，例如平均运行时间、平均排队时间和失败率：

  • 工作流。查看组织中每个工作流的性能数据，包括平均运行时间和作业失败。使用此信息来识别效率低下的工作流和运行稳定性问题。
  • 作业。查看每个单独作业的性能数据，包括平均运行时间、平均排队时间和作业失败。使用此信息来识别效率低下的作业。
  • 代码库。获取组织中每个代码库及其平均性能指标的概览。
  • 运行时操作系统。了解每个操作系统的运行器性能。
  • 运行器类型。比较自托管运行器和 GitHub 托管运行器的性能，以便做出有关运行器类型的决策。

了解 GitHub Actions 指标聚合

时间段选择功能允许您查看预定义时间段内的 GitHub Actions 指标，如下表所述。这些指标包括跳过的运行和使用零分钟的运行。数据使用协调世界时 (UTC) 天数显示。

时间段描述
本周（周一至周日）从星期一到查看页面时的当天数据。
本月从本月第一天到查看页面时的当天数据。
上个月从上个月的第一天到最后一天的数据。
过去 30 天从过去 30 天到查看页面时的当天数据。
过去 90 天从过去 90 天到查看页面时的当天数据。
去年过去 12 个月的汇总数据。

查看组织的 GitHub Actions 指标

注意

由于识别唯一作业的方式不同，“工作流”选项卡的作业计数与“作业”选项卡的计数之间可能存在差异。但这不会影响计算的总分钟数。

  1. 在 GitHub 的右上角，选择您的个人资料照片，然后单击 您的组织.

  2. 单击您的组织名称。

  3. 在您的组织名称下，单击 Insights.

    Screenshot of the horizontal navigation bar for an organization. A tab, labeled with a graph icon and "Insights," is outlined in dark orange.

  4. 在“Insights”导航菜单中，单击Actions 使用情况指标或单击Actions 性能指标。

  5. 可选：要选择查看使用情况指标的时间段，请从页面右上角的时间段下拉菜单中选择一个选项。更多信息，请参见“了解 GitHub Actions 指标聚合”。

  6. 单击包含您想要查看的指标的选项卡。更多信息，请参见“关于 GitHub Actions 使用情况指标”或“关于 GitHub Actions 性能指标”。

  7. 可选：要过滤选项卡中显示的数据，请创建过滤器。

    1. 单击 过滤器按钮。
    2. 单击 添加过滤器。
    3. 选择您想要过滤结果的指标。
    4. 根据您选择的指标，填写“限定符”、“运算符”和“值”列中的信息。
    5. 可选：单击 添加过滤器以添加另一个过滤器。
    6. 单击应用。

  8. 可选：要将使用情况指标下载到 CSV 文件，请单击.

查看代码库的 GitHub Actions 指标

注意

GitHub Actions 的代码库级别指标处于公开预览阶段，如有更改，恕不另行通知。

注意

由于识别唯一作业的方式不同，“工作流”选项卡的作业计数与“作业”选项卡的计数之间可能存在差异。但这不会影响计算的总分钟数。

  1. 在 GitHub 上，导航到代码库的主页。
  2. 在您的代码库名称下，单击 Insights 选项卡。
  3. 在“Insights”导航菜单中，单击Actions 使用情况指标或单击Actions 性能指标。
  4. 可选：要选择查看使用情况指标的时间段，请从页面右上角的时间段下拉菜单中选择一个选项。更多信息，请参见“了解 GitHub Actions 指标聚合”。
  5. 单击包含您想要查看的指标的选项卡。更多信息，请参见“关于 GitHub Actions 使用情况指标”或“关于 GitHub Actions 性能指标”。
  6. 可选：要过滤选项卡中显示的数据，请创建过滤器。
    1. 单击 过滤器按钮。
    2. 单击 添加过滤器。
    3. 选择您想要过滤结果的指标。
    4. 根据您选择的指标，填写“限定符”、“运算符”和“值”列中的信息。
    5. 可选：单击 添加过滤器以添加另一个过滤器。
    6. 单击应用。
  7. 可选：要将使用情况指标下载到 CSV 文件，请单击.