사용 현황 보고서에는 각 SKU의 사용량과 청구 금액을 포함하여 계정의 GitHub 사용량에 대한 자세한 정보가 표시됩니다.
사용 현황 보고서를 생성하려면 요금제 제품 및 라이선스 사용량 확인하기을(를) 참조하세요.
보고서 종류
보고서에는 다음과 같은 세 가지 유형이 있습니다.
- 요금제 사용량 페이지:
- 요약된 요금제 사용량 보고서: 최대 1년 동안의 모든 유료 제품 사용량 요약
- 자세한 요금제 사용량 보고서: 최대 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에서 호스팅된 실행기와 자체 호스팅 실행기용 GitHub Actions 사용량에 대한 할인을 포함합니다. |
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일부터 사용할 수 있습니다.
프리미엄 요청 분석 보고서에는 다음 필드가 포함되어 있습니다.
| 필드 | 설명 |
|---|---|
| 타임스탬프 | ISO 18601 형식의 전체 UTC 날짜 및 시간입니다. |
| 사용자 | 사용과 연결된 사용자의 GitHub 핸들입니다. |
| 모델 | 사용된 모델입니다. 예를 들면, claude-sonnet-4와 같은 LLM 또는 Code Review model과 같은 제품별 모델입니다. |
| 사용된 요청 | 사용된 총 요청 수입니다. |
| 월별 할당량 초과 | 이 필드는 프리미엄 요청이 별도로 청구되는지 여부를 나타냅니다. - FALSE: 요청이 사용자의 플랜에 포함된 월별 할당량으로 충당됩니다.- TRUE: 요청이 월별 할당량을 초과하여 청구됩니다. |
| 총 월별 할당량 | 이 필드는 사용자의 현재 플랜에 포함된 총 요청 수를 기록합니다. 개별 GitHub Copilot 플랜 및 혜택 정보 및 조직 및 엔터프라이즈의 GitHub Copilot에 대한 청구 정보을(를) 참조하세요. |
보고서 받기
사용 현황 보고서는 메일을 통해 GitHub 계정과 연결된 기본 메일 주소로 전송됩니다. 계정당 한 번에 하나의 사용 현황 보고서만 요청할 수 있습니다.