使用状況レポートのリファレンス

使用状況レポートには、各 SKU の使用量や結果として生じた請求金額など、アカウントの GitHub の使用状況に関する詳細情報が表示されます。

使用状況レポートの生成方法については、GitHub Enterprise Cloud ドキュメントの「支出に関する分析情報の収集」を参照してください。

使用状況レポートの種類

2 種類のレポートがあります。

• 概要レポートは、最大 1 年の期間について要求できます。
• 詳細レポートは、最大 31 日の期間について要求できます。

概要レポート

概要使用状況レポートでは、date、sku、repository、cost_center_name の値の組み合わせに基づいて、quantity、gross_amount、discount_amount、net_amount フィールドが集計されます。 使用状況レポートが organization を含む Enterprise に関するものである場合、金額は organization の値によっても集計されます。

詳細レポート

詳細使用状況レポートには、概要レポートと同じフィールドに加えて、username と workflow_path が含まれます。

詳細使用状況レポートでは、date、sku、organization、repository、cost_center_name、username、workflow_path の値の組み合わせに基づいて、quantity、gross_amount、discount_amount、net_amount フィールドが集計されます。

使用状況レポートのフィールド

使用状況レポートには、次のフィールドがあります。

フィールド	説明
date	使用が発生した日。 すべての使用状況は UTC で記録されます。
product	使用された GitHub 製品。
sku	使用された具体的な GitHub 製品 SKU。
quantity	使用された SKU の量。
unit_type	製品 SKU の測定単位。
applied_cost_per_quantity	製品 SKU の単価。
gross_amount	使用された製品 SKU の量。
discount_amount	割引された使用量。 アカウントに含まれる使用量の一部として割引される使用量が、このフィールドに反映されます。 また、パブリック リポジトリ内の標準の GitHub ホステッド ランナーとセルフホステッド ランナーの GitHub Actions の使用量に関する割引も含まれます。
net_amount	discount_amount を適用した後の課金対象となる使用量。 これは、お使いのアカウントに請求される金額です。 gross_amount - discount_amount = net_amount.
username	使用状況に関連付けられているユーザー (該当する場合)。 詳細レポートでのみ使用できます。
organization	使用状況に関連付けられている organization (該当する場合)。
repository	使用状況に関連付けられているリポジトリ (該当する場合)。
workflow_path	使用状況を生成した GitHub Actions ワークフローのパス (該当する場合)。 詳細レポートでのみ使用できます。
cost_center_name	使用状況に関連付けられているコスト センター (該当する場合)。

レポート フィールドの廃止

GitHub は使用状況レポートの構造変更を最小限に抑えることを目指していますが、レポートの構造やフィールドが変更される場合があります。

終了	置換
usage_at	代わりに date を参照してください。
workflow_name	代わりに workflow_path を参照してください。

レポートの受信

使用状況レポートは、GitHub アカウントに関連付けられている既定のメール アドレスにメールで送信されます。 一度に依頼できる使用状況レポートは、アカウントごとに 1 つだけです。