사용 현황 보고서에는 계정의 GitHub 사용량에 대한 자세한 정보가 표시됩니다. 여기에는 사용된 각 SKU의 양과 청구 가능한 금액이 포함됩니다.
사용 현황 보고서를 생성하려면 요금제 제품 및 라이선스 사용량 확인하기을 참조하세요.
보고서 형식
사용할 수 있는 보고서 유형은 다음과 같습니다.
- 계량 사용 페이지 * 요약된 사용량 보고서: 최대 1년 동안의 모든 유료 제품의 사용량 요약입니다. * 자세한 사용 현황 보고서: 최대 31일 동안의 모든 유료 제품에 대한 자세한 사용 현황 보고서입니다.
- 프리미엄 요청 분석 페이지: * 프리미엄 요청 사용 현황 보고서: 최대 31일 동안 사용된 프리미엄 요청의 자세한 사용자별 분석입니다.
요약된 사용 현황 보고서
이 보고서는 다음 값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.
참고 항목
자세한 사용 현황 보고서의 데이터는 GitHub 웹 인터페이스를 통해서만 사용할 수 있으며 REST API /usage 엔드포인트를 통해 가져올 수 없습니다. REST API는 요약된 청구 정보에 대한 액세스만 제공합니다.
프리미엄 요청 사용 현황 보고서
이 보고서에는 프리미엄 요청 사용량에 대한 추가 세부 정보가 포함되어 있습니다. 보고서는 다음 값quantity``gross_amount``discount_amount의 net_amount조합에 따라 , date, model및 username 필드의 합계를 계산합니다.
이 보고서에는 2025년 10월 1일 00:00 UTC부터 사용량이 포함됩니다.
사용 보고서 필드
사용 보고서에는 다음 필드가 포함됩니다.
| 분야 | Description |
|---|---|
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 | 해당하는 경우, 사용량과 연관된 사용자. 에 Summarized usage report포함되지 않습니다. |
organization | 해당하는 경우, 사용량과 연관된 조직. |
repository | 해당하는 경우, 사용량과 연관된 리포지토리. |
workflow_path | 해당되는 경우, 사용량을 발생시킨 GitHub Actions workflow의 경로 |
`Detailed usage report`에서만 사용할 수 있습니다. |
| cost_center_name | 해당하는 경우 사용량과 관련된 비용 센터입니다. |
| model | 사용된 모델입니다. 이는 LLM(claude-sonnet-4와 같은) 또는 Code Review model와 같은 제품별 모델일 수 있습니다.
Premium request usage report에서만 사용할 수 있습니다. |
| exceeds_quota | 프리미엄 요청이 사용자의 월별 할당량을 초과하는지 여부를 나타냅니다.
-
FALSE: 요청은 사용자의 계획에 포함된 월별 할당량에 포함됩니다.
-
TRUE: 요청이 월별 할당량을 초과하여 요금이 청구됩니다.
Premium request usage report에서만 사용할 수 있습니다. |
| total_monthly_quota | 사용자의 현재 계획에 포함된 요청 수입니다.
Premium request usage report에서만 사용할 수 있습니다. |
보고서 받기
사용 보고서는 GitHub 계정에 연결된 기본 Email 주소로 전송됩니다. 사용 보고서는 계정당 한 번에 하나만 요청할 수 있습니다.
종료된 계량 사용 보고서 필드.
GitHub는 사용량 보고서 구조의 변경을 최소화하는 것을 목표로 하지만 보고서 구조나 필드가 변경되는 경우가 있습니다.
사용 보고서에서 다음 필드가 제거되었습니다.
| 분야 | Replacement |
|---|---|
usage_at | 대신 date를 참조하세요. |
workflow_name | 대신 workflow_path를 참조하세요. |