Os relatórios de uso mostram informações detalhadas sobre o uso do GitHub de sua conta, incluindo quanto cada SKU foi usada e o valor faturável resultante.
Para gerar um relatório de uso, consulte Como exibir o uso de licenças e produtos mensuráveis.
Tipos de relatório
Há três tipos diferentes de relatórios.
- Página de uso limitado:
- Relatórios de uso limitado resumidos: um resumo do uso de todos os produtos pagos por um período máximo de um ano.
- Relatórios de uso limitado detalhados: um relatório de uso detalhado de todos os produtos pagos por um período máximo de 31 dias.
- Página de análise de solicitações premium:
- Relatórios de uso da análise de solicitações premium: um relatório detalhado, baseado no usuário, sobre o uso de solicitações premium nos últimos 45 dias.
Relatórios de uso limitado resumidos
Este relatório soma os campos quantity, gross_amount, discount_amount e net_amount com base na combinação dos seguintes valores: date, sku, repository, cost_center_name. Se o relatório de uso for para uma empresa com organizações, os valores também serão resumidos segundo a organização.
Relatórios de uso limitado detalhados
O relatório de uso detalhado inclui os mesmos campos do relatório resumido e adiciona username e workflow_path.
O relatório soma os campos quantity, gross_amount, discount_amount e net_amount com base na combinação dos seguintes valores: date, sku, organization, repository, cost_center_name, username, workflow_path.
Relatórios de uso de análise de solicitações premium
Este relatório inclui cada uso registrado de uma solicitação premium e inclui os seguintes campos: Timestamp,User,Model,Requests Used,Exceeds Monthly Quota e Total Monthly Quota.
Campos do relatório de uso limitado
O relatório de uso contém os campos a seguir.
| Campo | Descrição |
|---|---|
date | O dia em que o uso ocorreu. Todo o uso é registrado em UTC. |
product | O produto do GitHub usado. |
sku | A SKU do produto do GitHub específico que foi usado. |
quantity | A quantidade da SKU que foi usada. |
unit_type | A unidade de medida da SKU do produto. |
applied_cost_per_quantity | O custo unitário da SKU do produto. |
gross_amount | A quantidade da SKU do produto que foi usada. |
discount_amount | A quantidade de uso que foi descontada. O uso com desconto como parte do uso incluído de sua conta é mostrado nesse campo. Também inclui descontos referentes ao uso do GitHub Actions para executores padrão hospedados no GitHub em repositórios públicos e para executores auto-hospedados. |
net_amount | A quantidade faturável de uso após a aplicação do discount_amount. Esse é o valor que sua conta será cobrada. gross_amount - discount_amount = net_amount. |
username | O usuário associado ao uso, se aplicável. Disponível apenas no relatório detalhado. |
organization | A organização associada ao uso, se aplicável. |
repository | O repositório associado ao uso, se aplicável. |
workflow_path | O caminho do fluxo de trabalho do GitHub Actions que gerou o uso, se aplicável. Disponível apenas no relatório detalhado. |
cost_center_name | O centro de custo associado ao uso, se aplicável. |
Campos do relatório de uso limitado que estão sendo encerrados
O GitHub tem como objetivo minimizar as alterações na estrutura do relatório de uso; no entanto, às vezes, a estrutura ou os campos do relatório podem ser alterados.
| Desativação | Substituição |
|---|---|
usage_at | Consulte date em vez disso. |
workflow_name | Consulte workflow_path em vez disso. |
Campos do relatório de uso de análise de solicitações premium
Observação
Os dados de análise de solicitações premium estão disponíveis a partir de 1º de agosto de 2025.
O relatório de análise de solicitações premium contém os campos a seguir.
| Campo | Descrição |
|---|---|
| Timestamp | A data e hora UTC completas no formato ISO 18601. |
| Usuário | O identificador do GitHub do usuário associado ao uso. |
| Modelar | O modelo utilizado. Pode ser um LLM como claude-sonnet-4 ou um modelo específico do produto, como Code Review model. |
| Solicitações usadas | O número total de solicitações usadas. |
| Excede a cota mensal | Este campo indica se a solicitação premium será cobrada separadamente: - FALSE: a solicitação é coberta pela cota mensal incluída no plano do usuário.- TRUE: a solicitação excede a cota mensal e será cobrada |
| Cota mensal total | Este campo registra o número total de solicitações incluídas no plano atual do usuário, consulte Sobre planos e benefícios individuais do GitHub Copilot e Sobre a cobrança do GitHub Copilot em organizações e empresas. |
Recebendo o relatório
Os relatórios de uso são enviados por email para o endereço de email padrão associado à sua conta do GitHub. Você só pode solicitar um relatório de uso por conta por vez.