Os relatórios de uso mostram informações detalhadas sobre o uso da GitHub sua conta, incluindo quanto de 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
Os tipos de relatório a seguir estão disponíveis.
- Página de uso medido
- Relatório de uso resumido: um resumo do uso de todos os produtos pagos por um período máximo de um ano.
- Relatório de uso detalhado: um relatório de uso detalhado para todos os produtos pagos por um período máximo de 31 dias.
- Página de uso de IA:
- Relatório de uso de IA: uma análise detalhada por usuário do AI credits consumo por um período máximo de 31 dias.
Relatório de uso resumido
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ório de uso detalhado
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.
Observação
Os dados do relatório de uso detalhado só estão disponíveis por meio da interface web GitHub e não podem ser obtidos por meio do ponto de extremidade da API /usage REST. A API REST fornece acesso apenas a informações de cobrança resumidas.
Relatório de uso de IA
Este relatório inclui mais detalhes sobre o consumo de AI credits O relatório soma os campos quantity, gross_amount, discount_amount e net_amount com base na combinação dos seguintes valores: date, model e username.
Campos do relatório de uso
Os relatórios 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 GitHub produto que foi utilizado. |
sku | O SKU de produto específico GitHub 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 quantia de utilização que foi descontada. O uso com desconto como parte do uso incluído da sua conta é mostrado nesse campo. Também inclui descontos para GitHub Actions uso para corredores hospedados padrão GitHubem repositórios públicos e para corredores auto-hospedados. |
net_amount | A quantidade faturável de uso após a aplicação do discount_amount. Esse é o valor que será cobrado em sua conta. gross_amount - discount_amount = net_amount |
username | O usuário associado ao uso, se aplicável. Não incluído no Summarized usage report. |
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 GitHub Actions fluxo de trabalho que gerou o uso, se aplicável. Disponível somente no Detailed usage report |
cost_center_name | O centro de custo associado ao uso, se aplicável. |
model | O modelo usado, por exemplo claude-sonnet-4. Disponível somente no AI usage report |
Recebendo o relatório
Os relatórios de uso são enviados por email para o endereço de email padrão associado à sua GitHub conta. Você só pode solicitar um relatório de uso por conta por vez.
Campos de relatório de uso medido que foram encerrados
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.
Os campos a seguir foram removidos dos relatórios de uso.
| Campo | Substituição |
|---|---|
usage_at | Consulte date em vez disso. |
workflow_name | Consulte workflow_path em vez disso. |