使用情况报告会显示你的帐户的 GitHub 使用情况的详细信息,包括每种 SKU 的使用情况及相应的可计费金额。
要生成使用情况报告,请参阅“查看按流量计费的产品和许可证的使用情况”。
报表类型
存在三种不同的报告类型。
- 按流量计费的使用情况页:
- 按流量计费的使用情况汇总报告:所有付费产品的使用情况汇总,最长时间范围为一年****。
- 按流量计费的使用情况详细报告:所有付费产品的详细使用情况报告,最长时间范围为 31 天****。
- 高级请求分析页:
- 高级请求分析使用情况报告:过去 45 天的高级请求使用情况的详细报告(基于用户)****。
按流量计费的使用情况汇总报告
该报告会根据以下数值组合,对 quantity
、gross_amount
、discount_amount
和 net_amount
字段进行求和:date
、sku
、repository
、cost_center_name
。 如果使用情况报告适用于具有组织的企业,则金额也将按组织价值进行汇总。
按流量计费的使用情况详细报告
详细使用情况报告包含与汇总报告相同的字段,并添加 username
和 workflow_path
。
该报告会根据以下数值组合,对 quantity
、gross_amount
、discount_amount
和 net_amount
字段进行求和:date
、sku
、organization
、repository
、cost_center_name
、username
、workflow_path
。
高级请求分析使用情况报告
该报告包括记录的每次高级请求使用,包括以下字段:Timestamp
、User
、Model
、Requests Used
、Exceeds Monthly Quota
和 Total Monthly Quota
。
按流量计费的使用情况报告字段
使用情况报告包含以下字段。
字段 | 说明 |
---|---|
date | 使用日期。 所有使用情况均以 UTC 格式记录。 |
product | 已使用的 GitHub 产品。 |
sku | 已使用的特定 GitHub 产品 SKU。 |
quantity | 已使用的 SKU 的数量。 |
unit_type | 产品 SKU 的度量单位。 |
applied_cost_per_quantity | 产品 SKU 的单位成本。 |
gross_amount | 已使用的产品 SKU 的数量。 |
discount_amount | 获得折扣的使用量。 作为帐户包含的使用情况的一部分而享受折扣的使用情况将显示在此字段中。 还包括 GitHub Actions 在公共仓库中使用标准 GitHub 托管运行器以及使用自托管运行器时所享受的折扣。 |
net_amount | 应用 discount_amount 后的可计费使用量。 这是你的帐户将被计费的金额。 gross_amount - discount_amount = net_amount 。 |
username | 与使用情况关联的用户(如适用)。 仅在详细报告中提供。 |
organization | 与使用情况关联的组织(如适用)。 |
repository | 与使用情况关联的仓库(如适用)。 |
workflow_path | 生成此使用情况的 GitHub Actions 工作流路径(如适用)。 仅在详细报告中提供。 |
cost_center_name | 与使用情况关联的成本中心(如适用)。 |
即将关闭的按流量计费的使用情况报告字段
GitHub 旨在最大程度地减少对使用情况报告结构的更改,但有时报告结构或字段可能会发生变化。
即将关闭 | 替代功能 |
---|---|
usage_at | 请改为参考 date 。 |
workflow_name | 请改为参考 workflow_path 。 |
高级请求分析使用情况报告字段
注意
高级请求分析数据自 2025 年 8 月 1 日起提供。
高级请求分析报告包含以下字段。
字段 | 说明 |
---|---|
Timestamp | 采用 ISO 18601 格式的完整 UTC 日期和时间。 |
用户 | 与使用情况相关联的用户的 GitHub 用户名。 |
型号 | 所使用的模型。 这可能是 LLM(如 claude-sonnet-4 )或特定于产品的模型(如 Code Review model )。 |
使用的请求 | 使用的请求总数。 |
超出每月配额 | 该字段指示高级请求是否单独计费: - FALSE :请求由用户计划中包含的每月配额涵盖。- TRUE :请求超出每月配额,并进行相应计费 |
每月总配额 | 此字段记录用户当前计划中包含的请求总数,请参阅“关于个人版 GitHub Copilot 计划和权益”和“关于组织和企业中 GitHub Copilot 的计费”。 |
接收报告
使用情况报告会通过电子邮件发送至与你的 GitHub 帐户关联的默认电子邮件地址。 每个帐户一次只能请求一份使用情况报告。