GitHub Actions のメトリックをあなたの組織で表示する

GitHub Actions のメトリックは、organization が CI/CD パイプラインにリソースを使用している方法と場所に関する分析情報を提供します。

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

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

この記事で

GitHub Actions のメトリックについて

GitHub Actions のメトリックを見ると、ワークフローとジョブが organization とリポジトリのレベルでどのように実行されているかについての分析情報がわかります。 ワークフローのさまざまな側面を分析するのに役立つ 2 種類のメトリックがあります。

  • GitHub Actions 使用状況メトリック: 使用状況メトリックは、ワークフローとジョブが消費する分単位の時間を追跡するのに役立ちます。 このデータを使って、Actions の実行コストを把握し、プランの制限内に留まることを確認できます。 これは、使用率の高いワークフローまたはリポジトリを識別する場合に特に便利です。
  • GitHub Actions パフォーマンス メトリック: パフォーマンス メトリックは、ワークフローとジョブの効率と信頼性に注目します。 パフォーマンス メトリックを使うと、ジョブ実行時間、キュー時間、失敗率などの主要なインジケーターを監視して、ボトルネック、実行の遅いジョブ、または頻繁に失敗するワークフローを特定できます。

GitHub Actions メトリックへのアクセスの有効化

組織の所有者は、ユーザーが組織の GitHub Actions の使用状況メトリックを表示できるように、カスタム組織の役割を作成できます。 ユーザーにアクセス権を与えるには、カスタム組織ロールを作成するときに [View organization Actions metrics] ロールを選択します。 詳しくは、「カスタム組織ロールの権限」をご覧ください。

GitHub Actions の使用状況メトリックについて

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

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

GitHub Actions 使用状況メトリックは、表示されるメトリクスに分の乗数を適用しません。 Organization 内で Actions minutes (分単位の利用時間) がどのように、どこで使用されているかを把握できるようにするのが主な目的ですが、請求書の理解に役立つ_可能性_もあります。

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

GitHub Actions のパフォーマンス メトリックについて

GitHub Actions パフォーマンス メトリックを使うと、ワークフローの効率と信頼性を分析できます。 次のものに関係する平均実行時間、平均キュー時間、失敗率などのパフォーマンス情報を確認できます。

  • ワークフロー。 平均実行時間やジョブ失敗数など、organization 内の各ワークフローのパフォーマンス データを表示します。 この情報を使って、効率の悪いワークフローと実行の安定性を特定します。
  • ジョブ。 平均実行時間、平均キュー時間、ジョブ失敗数など、個々のジョブのパフォーマンス データを表示します。 この情報を使って、効率の悪いジョブを特定します。
  • リポジトリ。 Organization 内の各リポジトリの概要レベルのスナップショットとそれらの平均パフォーマンス メトリックを取得します。
  • ランタイム OS 各オペレーティング システムのランナーのパフォーマンスを把握します。
  • ランナーの種類。 セルフホステッド ランナーと GitHub がホストするランナーのパフォーマンスを比べて、ランナーの種類に関する決定を行います。

GitHub Actions メトリック集計の理解

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

Period説明
現在の週 (月曜日から日曜日)ページが表示される月曜日から現在の日までのデータ。
当月ページが表示される月の最初から現在の日までのデータ。
先月前月の最初の日から最後の日までのデータ。
過去 30 日間過去 30 日間からページが表示された時点までのデータ。
過去 90 日間過去 90 日間からページが表示された時点までのデータ。
去年過去 12 か月間に集計されたデータ。
Customカスタム日付範囲のデータ。 範囲は、開始日と終了日を含めて最大 100 日まで指定でき、1 年前まで遡ることができます。

あなたの組織におけるGitHub Actionsのメトリクスの表示

メモ

一意のジョブの識別方法が異なるため、Workflows タブのジョブ数と Jobs タブの数に不一致がある可能性があります。 これは、計算された合計分数には影響しません。

  1. GitHub の右上隅にあるプロフィール画像をクリックしてから、[ Your organizations] をクリックします。

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

  3. Organization 名の下にある [ Insights] をクリックします。

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

  4. [Insights] ナビゲーション メニューで、[Actions Usage Metrics] をクリックするか、[Actions Performance Metrics] をクリックします。

  5. 必要に応じて、使用状況メトリックを表示する期間を選択するには、ページの右上にある [期間] ドロップダウン メニューからオプションを選択します。 詳しくは、「GitHub Actions メトリックの表示」をご覧ください。

  6. 表示するメトリックが含まれているタブをクリックします。 詳しくは、「GitHub Actions のメトリックについて」をご覧ください。

  7. 必要に応じて、タブに表示されるデータをフィルター処理するには、フィルターを作成します。

    1. [Filter] ボタンをクリックします。
    2. [Add a filter] をクリックします。
    3. 結果をフィルター処理するメトリックを選択します。
    4. 選択したメトリックに応じて、[修飾子]、[演算子]、[値] の列に情報を入力します。
    5. 必要に応じて、 [Add a filter] をクリックして、別のフィルターを追加します。
    6. [適用] をクリックします。

  8. 必要に応じて、使用状況メトリックを CSV ファイルにダウンロードするには、 をクリックします。