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

組織とリポジトリで使用できる GitHub Actions メトリックについて説明します。

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

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

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

## GitHub Actions メトリックへのアクセスを有効にする

組織の所有者は、ユーザーが自分の組織の使用状況メトリック GitHub Actions 表示できるようにするカスタム組織ロールを作成できます。 ユーザーにアクセス権を与えるには、カスタム組織ロールを作成するときに \[View organization Actions metrics] ロールを選択します。 詳しくは、「[カスタム組織ロールの権限](/ja/enterprise-cloud@latest/organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles)」をご覧ください。

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

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

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

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

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

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

## 次のステップ

Organization またはリポジトリのメトリックを確認する方法については、「[GitHub Actions メトリックの表示](/ja/enterprise-cloud@latest/actions/how-tos/administer/view-metrics)」を参照してください。