Skip to content

Commit a41a19b

Browse files
carogalvinCopilotmchammer01saritai
authored
Document Code Quality license CSV downloads (#63781)
Co-authored-by: carogalvin <223556219+Copilot@users.noreply.github.com> Co-authored-by: mc <42146119+mchammer01@users.noreply.github.com> Co-authored-by: Sarita Iyer <66540150+saritai@users.noreply.github.com> Copilot-Session: 637b33e5-5817-4081-9e97-72be4fe5b891
1 parent da942a0 commit a41a19b

4 files changed

Lines changed: 28 additions & 6 deletions

File tree

‎content/billing/concepts/product-billing/github-code-quality.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,8 @@ To understand your license usage, and which licenses you can free up, it helps t
4646

4747
Users can contribute to multiple repositories or organizations. Usage is measured across the whole organization or enterprise to ensure that each member uses one license regardless of how many repositories or organizations the user contributes to.
4848

49+
To see which committers and repositories contribute to your license usage, download the {% data variables.product.prodname_code_quality_short %} CSV report from the **Licensing** page. See [AUTOTITLE](/billing/how-tos/products/download-license-use).
50+
4951
## Further reading
5052

5153
* [AUTOTITLE](/code-security/tutorials/improve-code-quality/catch-issues-before-merge)

‎content/billing/how-tos/products/download-license-use.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Downloading license use for your enterprise or organization
3-
intro: Get data on consumption of {% data variables.product.github %}, {% data variables.product.prodname_copilot_short %}, and {% data variables.product.prodname_AS %} licenses.
3+
intro: Get data on consumption of {% data variables.product.github %}, {% data variables.product.prodname_copilot_short %}{% ifversion code-quality %}, {% data variables.product.prodname_code_quality_short %}{% endif %}, and {% data variables.product.prodname_AS %} licenses.
44
permissions: '{% data reusables.permissions.enhanced-billing-enterprise %}'
55
versions:
66
fpt: '*'
@@ -15,7 +15,7 @@ category:
1515
- Manage your plan and licenses
1616
---
1717

18-
You can download CSV files with details of paid license use through the {% data variables.product.github %} user interface or the REST API.
18+
You can download CSV files with details of paid license use through the {% data variables.product.github %} user interface. For supported products, you can also retrieve license usage information through the REST API.
1919

2020
For more detailed reports on usage of all paid products, see [AUTOTITLE](/billing/how-tos/products/view-productlicense-use).
2121

@@ -26,7 +26,7 @@ For more detailed reports on usage of all paid products, see [AUTOTITLE](/billin
2626

2727
1. In the license area of interest, click **Download CSV report**. If offered a choice, choose your preferred report.
2828

29-
The report will be emailed to the default email address associated with your {% data variables.product.github %} account. For information about the fields, see [AUTOTITLE](/billing/reference/license-reports).
29+
The report will be emailed to the default email address associated with your {% data variables.product.github %} account.{% ifversion code-quality %} The exception is {% data variables.product.prodname_code_quality_short %} reports, which download directly to your browser instead.{% endif %} For information about the fields, see [AUTOTITLE](/billing/reference/license-reports).
3030

3131
## On {% data variables.product.prodname_ghe_server %}
3232

‎content/billing/reference/license-reports.md‎

Lines changed: 22 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -12,13 +12,13 @@ category:
1212
- Track spending and control costs
1313
---
1414

15-
Each license report shows information about license users in your enterprise account, for {% data variables.product.prodname_copilot_short %}, or for {% data variables.product.prodname_AS %}.
15+
Each license report shows information about license users in your enterprise account, for {% data variables.product.prodname_copilot_short %}{% ifversion code-quality %}, for {% data variables.product.prodname_code_quality_short %}{% endif %}, or for {% data variables.product.prodname_AS %}.
1616

17-
**Cloud users** can download license reports from the {% octicon "law" aria-hidden="true" aria-label="law" %} **Licensing** page under {% octicon "credit-card" aria-hidden="true" aria-label="credit-card" %} **Billing & licensing** or using the REST API.
17+
**Cloud users** can download license reports from the {% octicon "law" aria-hidden="true" aria-label="law" %} **Licensing** page under {% octicon "credit-card" aria-hidden="true" aria-label="credit-card" %} **Billing & licensing** or, for supported products, using the REST API.
1818

1919
{% ifversion fpt or ghec %}
2020

21-
* Enterprise and {% data variables.product.prodname_AS %} license users, see [AUTOTITLE](/billing/how-tos/products/download-license-use)
21+
* Enterprise{% ifversion code-quality %}, {% data variables.product.prodname_code_quality_short %},{% endif %} and {% data variables.product.prodname_AS %} license users, see [AUTOTITLE](/billing/how-tos/products/download-license-use)
2222
* {% data variables.product.prodname_copilot %} license users, see [AUTOTITLE](/copilot/how-tos/administer-copilot/download-activity-report)
2323
* Report using the REST API, see [AUTOTITLE](/billing/tutorials/automate-usage-reporting)
2424

@@ -28,6 +28,25 @@ If you want to generate a more detailed usage report, see [AUTOTITLE](/billing/t
2828

2929
**{% data variables.product.prodname_ghe_server %} users** can download license reports for {% data variables.product.prodname_AS %} from the **License** page under enterprise settings, see [AUTOTITLE](/billing/how-tos/products/download-license-use).
3030

31+
{% ifversion code-quality %}
32+
33+
## {% data variables.product.prodname_code_quality_short %} license report
34+
35+
The CSV file lists active committers consuming {% data variables.product.prodname_code_quality_short %} licenses and the repositories contributing to that usage.
36+
37+
| Field | Description |
38+
|-------|-------------|
39+
| User login | The {% data variables.product.github %} username of the user. |
40+
| Organization / repository | The owner and name of a repository contributing to the user's {% data variables.product.prodname_code_quality_short %} license usage. |
41+
| Last pushed date | The push date recorded for the user's license usage in the repository, in `YYYY-MM-DD` format. A hyphen (`-`) indicates that the date is unknown. |
42+
| Last pushed email | The user's Git author email address. |
43+
44+
A user can appear in multiple rows if they contributed to multiple repositories. Each user consumes one {% data variables.product.prodname_code_quality_short %} license across the organization or enterprise, regardless of how many repositories they contribute to. Do not use the number of rows as the license count.
45+
46+
The report shows current active committers, not all licenses billed during a billing period. For details of how license usage affects your bill, see [AUTOTITLE](/billing/concepts/product-billing/github-code-quality).
47+
48+
{% endif %}
49+
3150
## {% data variables.product.prodname_AS %} license report
3251

3352
The CSV file contains information about each user who is currently consuming a license. The most recent commit by each of these users to repositories with paid security features enabled is reported.

‎content/code-security/how-tos/maintain-quality-code/view-and-manage-cost.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,7 @@ It's important to understand how {% data variables.product.prodname_code_quality
3636

3737
{% data variables.product.prodname_code_quality_short %} usage appears in the **same billing and usage views as your other products**, not in a separate {% data variables.product.prodname_code_quality_short %} meter. Where you look depends on how granular a breakdown you need:
3838

39+
* **Committers consuming licenses**: Download the {% data variables.product.prodname_code_quality_short %} license report from the **Licensing** page under **Billing & licensing**. The CSV lists active committers and the repositories contributing to their license usage. See [AUTOTITLE](/billing/how-tos/products/download-license-use).
3940
* **For a repository- or organization-level breakdown, download the billing usage report** from the "Billing and licensing" tab. This is the only place you can attribute {% data variables.product.prodname_code_quality_short %} spend, including {% data variables.product.prodname_actions %} minutes, down to a specific repository or organization. There's no equivalent view in the UI. See [AUTOTITLE](/billing/how-tos/products/view-productlicense-use).
4041
* **For {% data variables.product.prodname_code_quality_short %}'s {% data variables.product.prodname_ai_credits_short %} usage over time, use the AI usage page** and group it by **Product** using the dropdown at the top right. This separates {% data variables.product.prodname_code_quality_short %} from your other AI products, like {% data variables.product.prodname_copilot_short %}, so you can track its share of the pool. To monitor the pool as a whole instead, see [AUTOTITLE](/copilot/concepts/billing-and-usage/organizations-and-enterprises/billing).
4142

0 commit comments

Comments
 (0)