Les rapports d’utilisation affichent des informations détaillées sur l’utilisation de GitHub, y compris la quantité de chaque référence SKU utilisée et le montant facturable résultant.
Pour générer un rapport d’utilisation, consultez Consulter votre utilisation des produits et licences facturés à l’usage.
Types de rapports
Les types de rapports suivants sont disponibles.
- Page d’utilisation facturée à l’usage : * Rapport d’utilisation résumé : résumé de l’utilisation pour tous les produits payants pendant une période maximale d’un an. * Rapport d’utilisation détaillé : rapport d’utilisation détaillé pour tous les produits payants pendant une période maximale de 31 jours.
- Page d’analyses des demandes premium : * Rapport d’utilisation des demandes Premium : répartition détaillée des demandes Premium consommées pendant une période maximale de 31 jours.
Rapport d’utilisation résumé
Ce rapport cumule les champs quantity, gross_amount, discount_amount et net_amount en fonction de la combinaison des valeurs suivantes : date, sku, repository, cost_center_name. Si le rapport d’utilisation concerne une entreprise avec plusieurs organisations, les montants seront également regroupés par organisation.
Rapport d’utilisation détaillé
Le rapport d’utilisation détaillé comprend les mêmes champs que le rapport résumé, auxquels s’ajoutent username et workflow_path.
Ce rapport cumule les champs quantity, gross_amount, discount_amount et net_amount en fonction de la combinaison des valeurs suivantes : date, sku, organization, repository, cost_center_name, username, workflow_path.
Remarque
Les données du rapport d’utilisation détaillé sont disponibles uniquement via l’interface web GitHub et ne peuvent pas être obtenues via le point de terminaison de l’API /usage REST. L’API REST fournit uniquement l’accès aux informations de facturation résumées.
Rapport d’utilisation des demandes Premium
Ce rapport inclut des détails supplémentaires sur l’utilisation des demandes Premium. Le rapport additionne les champs quantity, gross_amount, discount_amount et net_amount en fonction de la combinaison des valeurs suivantes : date, model et username.
Ce rapport contient l’utilisation à compter du 1er octobre 2025 00:00 UTC.
Champs du rapport d’utilisation
Les rapports d’utilisation contiennent les champs suivants.
| Champ | Description |
|---|---|
date | Le jour où l’utilisation a eu lieu. Toutes les utilisations sont enregistrées en UTC. |
product | Le produit GitHub utilisé. |
sku | La référence SKU du produit spécifique GitHub utilisée. |
quantity | La quantité de référence SKU utilisée. |
unit_type | L’unité de mesure pour la référence SKU du produit. |
applied_cost_per_quantity | Le coût unitaire de la référence SKU du produit. |
gross_amount | La quantité de référence SKU du produit utilisée. |
discount_amount | La quantité d’utilisation ayant fait l’objet d’une remise. Ce champ reflète les remises appliquées dans le cadre du quota d’utilisation inclus dans votre compte. Il inclut également les remises pour l’utilisation de GitHub Actions avec des exécuteurs standard hébergés par GitHub dans des référentiels publics, ainsi que pour les exécuteurs auto-hébergés. |
net_amount | Le montant facturable après application du discount_amount. Il s’agit du montant qui sera facturé à votre compte. gross_amount - discount_amount = net_amount |
username | L’utilisateur associé à l’utilisation, le cas échéant. Non inclus dans le Summarized usage report. |
organization | L’organisation associée à l’utilisation, le cas échéant. |
repository | Le référentiel associé à l’utilisation, le cas échéant. |
workflow_path | Le chemin du flux de travail GitHub Actions qui a généré l’utilisation, le cas échéant. Disponible uniquement dans le Detailed usage report |
cost_center_name | Le centre de coûts associé à l’utilisation, le cas échéant. |
model | Modèle utilisé. Il peut s’agir d’un LLM comme claude-sonnet-4 ou d’un modèle spécifique au produit comme Code Review model. Disponible uniquement dans le Premium request usage report |
exceeds_quota | Indique si la demande Premium dépasse le quota mensuel de l’utilisateur : |
-
`FALSE` : la demande est couverte par le quota mensuel inclus dans le plan de l’utilisateur.<br>
-
`TRUE` : la demande dépasse le quota mensuel et sera facturée <br><br>Disponible uniquement dans le `Premium request usage report` |
| total_monthly_quota | Nombre de demandes incluses dans le plan actuel de l’utilisateur.
Disponible uniquement dans le Premium request usage report |
Réception du rapport
Les rapports d’utilisation sont envoyés par e-mail à l’adresse électronique par défaut associée à votre compte GitHub. Vous ne pouvez demander qu’un seul rapport d’utilisation par compte à la fois.
Champs du rapport d’utilisation mesurés qui ont été fermés
GitHub vise à minimiser les modifications apportées à la structure du rapport d’utilisation, mais il peut arriver que la structure ou les champs du rapport changent.
Les champs suivants ont été supprimés des rapports d’utilisation.
| Champ | Remplacement |
|---|---|
usage_at | Reportez-vous à date à la place. |
workflow_name | Reportez-vous à workflow_path à la place. |