Viewing GitHub Actions metrics for your organization

GitHub Actions metrics provide insights into how and where your organization is using resources for its CI/CD pipelines.

この機能を使用できるユーザーについて

Organization owners and users with the "View organization Actions metrics" permission.

この記事の内容

About GitHub Actions metrics

GitHub Actions metrics provide insights into how your workflows and jobs are performing at the organization and repository levels. There are two types of metrics to help you analyze different aspects of your workflows:

  • GitHub Actions usage metrics: Usage metrics help you track how many minutes your workflows and jobs consume. You can use this data to understand the cost of running Actions and ensure you're staying within your plan limits. This is especially useful for identifying high-usage workflows or repositories.
  • GitHub Actions performance metrics: Performance metrics focus on the efficiency and reliability of your workflows and jobs. With performance metrics, you can monitor key indicators like job run times, queue times, and failure rates to identify bottlenecks, slow-running jobs, or frequently failing workflows.

Enabling access to GitHub Actions metrics

Organization owners can create custom organization roles to allow people to view GitHub Actions usage metrics for their organization. To provide users with access, select the "View organization Actions metrics" role when creating a custom organization role. For more information, see "カスタム組織の役割の情報."

About GitHub Actions usage metrics

GitHub Actions 使用状況メトリックを使用すると、組織で Actions minutes をどのように使用しているかを分析できます。 以下に関連する使用状況情報を表示できます。

  • ワークフロー。 組織内の各ワークフローの使用状況データを表示し、この情報を使用して、ワークフローのリファクタリングや より大きなランナー の使用など、最適化の条件を特定します。
  • ジョブ。 リソースを最も多く消費しているジョブと、実行されている場所を確認します。
  • リポジトリ。 組織内の各リポジトリの大まかなスナップショットと、その Actions の使用量 (分) を取得します。
  • ランタイム OS 各オペレーティング システムのランナーが Actions minutes を使用する方法と、ワークフローが最も頻繁に実行されているオペレーティング システムの種類について説明します。
  • ランナーの種類。 セルフホステッド ランナーと GitHub ホステッド ランナーが Actions minutes を使用する方法と、ランナーの種類ごとにワークフロー実行のボリュームを比較します。

GitHub Actions 使用状況メトリックは、表示されるメトリクスに分の乗数を適用しません。 __ 使用状況メトリックは請求書を理解するのに役立ちますが、主な目的は、組織内で Actions minutes (分単位の利用時間) が何に使われているのかや、使われている場所を把握できるようにすることです。

分の乗数についての詳細は、「GitHub Actions の課金について」を参照してください。

About GitHub Actions performance metrics

Note

GitHub Actions performance metrics is currently in パブリック プレビュー and subject to change.

GitHub Actions performance metrics enables you to analyze the efficiency and reliability of your workflows. You can view performance information such as average run times, average queue times, and failure rates, related to:

  • Workflows. View performance data for each workflow in your organization, including average run time and job failures. Use this information to identify inefficient workflows and run stability.
  • Jobs. View performance data for each individual job to, including average run time, average queue time, and job failures. Use this information to identify inefficient jobs.
  • Repositories. Get a high-level snapshot of each repository in your organization and their average performance metrics.
  • Runtime OS. Understand how runners for each operating system are performing.
  • Runner type. Compare the performance of self-hosted runners and GitHub-hosted runners, to make decisions about runner types.

Understanding GitHub Actions metrics aggregation

期間の選択機能を使用すると、次の表で詳しく説明するように、定義済みの期間の GitHub Actions 使用状況メトリックを表示できます。 これらのメトリックには、スキップされた実行と、0 分を使用するものが含まれます。 データは協定世界時 (UTC) 日を使用して表示されます。

Period説明
現在の週 (月曜日から日曜日)ページが表示される月曜日から現在の日までのデータ。
当月ページが表示される月の最初から現在の日までのデータ。
先月前月の最初の日から最後の日までのデータ。
過去 30 日間過去 30 日間からページが表示された時点までのデータ。
過去 90 日間過去 90 日間からページが表示された時点までのデータ。
去年過去 12 か月間に集計されたデータ。

Viewing GitHub Actions metrics for your organization

Note

There may be a discrepancy between the Workflows tab's job count and the Jobs tab's count due to differences in how unique jobs are identified. This does not affect the total minutes calculated.

  1. GitHub の右上隅で、プロフィール写真を選択し、 あなたの組織をクリックします。

  2. Organizationの名前をクリックしてください。

  3. 組織名の下にある [分析情報] をクリックします。

    組織の水平ナビゲーション バーのスクリーンショット。 グラフ アイコンと [分析情報] というラベルのタブが、濃いオレンジ色の枠線で強調されています。

  4. In the "Insights" navigation menu, click Actions Usage Metrics or click Actions Performance Metrics.

  5. Optionally, to select a time period to view usage metrics for, choose an option from the Period drop down menu at the top right of the page. For more information, see "Understanding GitHub Actions metrics aggregation."

  6. Click on the tab that contains the metrics you would like to view. For more information, see "About GitHub Actions usage metrics or "About GitHub Actions performance metrics."

  7. Optionally, to filter the data displayed in a tab, create a filter.

    1. Click on the Filter button.
    2. Click Add a filter.
    3. Choose a metric you would like to filter results by.
    4. Depending on the metric you chose, fill out information in the "Qualifier," "Operator," and "Value" columns.
    5. Optionally, click Add a filter to add another filter.
    6. Click Apply.

  8. Optionally, to download usage metrics to a CSV file, click .