Update usage report docs due to changes in premium request usage report generation (#57882)

Co-authored-by: Felicity Chapman <felicitymay@github.com>

Author: gmondello

content/billing/how-tos/products/view-productlicense-use.md

@@ -112,14 +112,11 @@ To show more detailed information for the top 100 users or organizations consumi
 
 ## Downloading usage reports
 
-Visit the "Metered Usage" page to access a metered billing report for all products, or navigate to the "Premium request analytics" page for a specialized report tailored for  Premium request activity tracking.
-
-### General usage reports
+Visit the "Metered Usage" page to access a metered billing report for all products, or navigate to the "Premium request analytics" page for a specialized report tailored for Premium request activity tracking.
 
 1. At the top of the page, click **Get usage report**.
-1. If prompted, specify the report details:
-   * Metered usage page: in the dialog displayed, define details of the report that you want to download and click **Email me the report**.
-   * Premium request analytics page: the report will contain usage for the last 45 days.
+1. Specify the report details.
+1. Click **Email me the report**.
 
 When the report is ready for you to download, you'll receive a message to your primary email account with a link to download the report. The link will expire after 24 hours.
 

content/billing/reference/billing-reports.md

@@ -17,39 +17,48 @@ redirect_from:
 contentType: reference
 ---
 
-The usage reports show detailed information about your account’s {% data variables.product.github %} usage, including how much of each SKU was used and the resulting billable amount.
+Usage reports show detailed information about your account’s {% data variables.product.github %} usage, including how much of each SKU was used and the resulting billable amount.
 
-To generate a usage report, see [AUTOTITLE](/billing/how-tos/products/view-productlicense-use).
+To generate a usage report, see [AUTOTITLE](/billing/how-tos/products/view-productlicense-use#downloading-usage-reports).
 
 ## Report types
 
-There are three different types of reports.
+The following report types are available.
 
 * Metered usage page:
-   * **Summarized metered usage reports**: A summary of usage for all paid products for a maximum period of one year.
-   * **Detailed metered usage reports**: A detailed usage report for all paid products for a maximum period of 31 days.
+   * **Summarized usage report**: A summary of usage for all paid products for a maximum period of one year.
+   * **Detailed usage report**: A detailed usage report for all paid products for a maximum period of 31 days.
 * Premium request analytics page:
-   * **Premium request analytics usage reports**: A detailed, user-based report on usage of premium requests for the last 45 days.
+   * **Premium requests usage report**: A detailed per-user breakdown of premium requests consumed for a maximum period of 31 days.
+   * **Legacy premium request usage report**: A detailed, user-based report of premium request usage for the last 45 days.
 
-### Summarized metered usage reports
+### Summarized usage report
 
 This report sums the `quantity`, `gross_amount`, `discount_amount`, and `net_amount` fields based on the combination of the following values: `date`, `sku`, `repository`, `cost_center_name`. If the usage report is for an enterprise with organizations, the amounts will be summarized by the organization value as well.
 
-### Detailed metered usage reports
+### Detailed usage report
 
 The detailed usage report includes the same fields as the summarized report and adds `username` and `workflow_path`.
 
 This report sums the `quantity`, `gross_amount`, `discount_amount`, and `net_amount` fields based on the combination of the following values:  `date`, `sku`, `organization`, `repository`, `cost_center_name`, `username`, `workflow_path`.
 
 {% data reusables.billing.usage-reports-api-limitation %}
 
-### Premium request analytics usage reports
+### Premium requests usage report
 
-This report includes each recorded use of a premium request and includes the following fields: `Timestamp`,`User`,`Model`,`Requests Used`,`Exceeds Monthly Quota`, and `Total Monthly Quota`.
+This report includes additional detail about premium request usage. The report sums the `quantity`, `gross_amount`, `discount_amount`, and `net_amount` fields based on the combination of the following values: `date`, `model`, `username`.
 
-## Metered usage report fields
+This report contains usage beginning October 01, 2025 00:00 UTC.
 
-The usage report contains the following fields.
+### Legacy premium request usage report
+
+This report includes each recorded use of a premium request and includes the following fields: `Timestamp`,`User`,`Model`,`Requests Used`,`Exceeds Monthly Quota`, and `Total Monthly Quota`. The time period of the report is the most recent 45 days.
+
+This report will be closing down on December 1, 2025, at which point all premium request usage activity will be available via the Premium requests usage report.
+
+## Usage report fields
+
+The usage reports contain the following fields.
 
 | Field                     | Description |
 |---------------------------|-------------|
@@ -61,37 +70,27 @@ The usage report contains the following fields.
 | `applied_cost_per_quantity` | The unit cost of the product SKU. |
 | `gross_amount`           | The amount of the product SKU that was used. |
 | `discount_amount`        | The amount of usage that was discounted. Usage that is discounted as part of your account’s included usage is reflected in this field. Also includes discounts for {% data variables.product.prodname_actions %} usage for standard {% data variables.product.github %}-hosted runners in public repositories and for self-hosted runners. |
-| `net_amount`             | The billable amount of usage after applying the `discount_amount`. This is the amount that your account will be billed. `gross_amount - discount_amount = net_amount`. |
-| `username`               | The user associated with the usage, if applicable. Only available in the detailed report. |
+| `net_amount`             | The billable amount of usage after applying the `discount_amount`. This is the amount that your account will be billed. `gross_amount - discount_amount = net_amount` |
+| `username`               | The user associated with the usage, if applicable. <br><br> Not included in the `Summarized usage report`. |
 | `organization`           | The organization associated with the usage, if applicable. |
 | `repository`             | The repository associated with the usage, if applicable. |
-| `workflow_path`          | The path of the {% data variables.product.prodname_actions %} workflow that generated the usage, if applicable. Only available in the detailed report. |
+| `workflow_path`          | The path of the {% data variables.product.prodname_actions %} workflow that generated the usage, if applicable. <br><br>Only available in the `Detailed usage report` |
 | `cost_center_name`       | The cost center associated with the usage, if applicable. |
+| `model`                  | The model used. This might be an LLM like `claude-sonnet-4`, or a product-specific model like `Code Review model`. <br><br>Only available in the `Premium request usage report` |
+| `exceeds_quota`          | Indicates whether the premium request exceeds the user's monthly quota:<br>- `FALSE`: The request is covered by the monthly quota included in the user's plan.<br>- `TRUE`: The request exceeds the monthly quota and will be billed <br><br>Only available in the `Premium request usage report` |
+| `total_monthly_quota`    | The number of requests included in the user's current plan. {% ifversion fpt or ghec %}See [AUTOTITLE](/copilot/concepts/billing/individual-plans) and [AUTOTITLE](/copilot/concepts/billing/organizations-and-enterprises).{% endif %} <br><br>Only available in the `Premium request usage report` |
+
+## Receiving the report
+
+Usage reports are sent via email to the default email address associated with your {% data variables.product.github %} account. You can only request one usage report per account at a time.
 
-### Metered usage report fields that are closing down
+## Metered usage report fields that have closed down
 
 {% data variables.product.github %} aims to minimize changes to the usage report structure, however at times the report structure or fields may change.
 
-| Closing down   | Replacement         |
+The following fields have been removed from the usage reports.
+
+| Field   | Replacement         |
 |--------------------|---------------------|
 | `usage_at`         | Refer to `date` instead. |
 | `workflow_name`    | Refer to `workflow_path` instead. |
-
-## Premium request analytics usage report fields
-
-{% data reusables.billing.premium-request-analytics-start %}
-
-The premium request analytics report contains the following fields.
-
-| Field                     | Description |
-|---------------------------|-------------|
-| Timestamp | The full UTC date and time in ISO 18601 format. |
-| User | The {% data variables.product.github %} handle of the user associated with the usage. |
-| Model | The model used. This might be an LLM like `claude-sonnet-4`, or a product-specific model like `Code Review model`.
-| Requests Used | The total number of requests used. |
-| Exceeds Monthly Quota | This field indicates whether the premium request will be billed separately:<br>- `FALSE`: The request is covered by the monthly quota included in the user's plan.<br>- `TRUE`: The request exceeds the monthly quota and will be billed |
-| Total Monthly Quota | This field records the total number of requests included in the user's current plan{% ifversion fpt or ghec %}, see [AUTOTITLE](/copilot/concepts/billing/individual-plans) and [AUTOTITLE](/copilot/concepts/billing/organizations-and-enterprises){% endif %}. |
-
-## Receiving the report
-
-Usage reports are sent via email to the default email address associated with your {% data variables.product.github %} account. You can only request one usage report per account at a time.

content/copilot/how-tos/manage-and-track-spending/monitor-premium-requests.md

@@ -30,9 +30,8 @@ There are multiple ways to view your premium request usage:
 * [View current usage directly within your IDE](#viewing-usage-in-your-ide)
 * [Viewing an overview in your Billing and licensing settings](#viewing-an-overview-in-your-billing-and-licensing-settings)
 * [View detailed analytics of your usage](#viewing-detailed-analytics-of-your-usage)
-* [Download a usage report for your personal account](#downloading-a-usage-report-for-your-personal-account)
 
-If you reach your limit for premium requests, you will be notified with a message in each of the {% data variables.product.prodname_copilot_short %} interfaces you use.
+If you reach your limit for premium requests, you will be notified with a message in each of the {% data variables.product.prodname_copilot_short %} interfaces you use. To download a usage report, see [Downloading usage reports](/billing/how-tos/products/view-productlicense-use#downloading-usage-reports).
 
 For information about viewing premium request usage for an organization or enterprise, see [AUTOTITLE](/billing/how-tos/products/view-productlicense-use).
 
@@ -67,15 +66,9 @@ You can view an overview of your premium request usage at any time in your "Bill
 
    ![Screenshot of the usage chart on the "Premium request analytics" page with "Chart options" open and outlined in dark orange.](/assets/images/help/billing/premium-request-analytics-chart-download.png)
 
-### Downloading a usage report for your personal account
+### Downloading a usage report
 
-Reports include all premium request usage, both within and beyond your allowance.
-
-{% data reusables.user-settings.access_billing_settings_url %}
-1. In the side bar, click **Premium request analytics** to show detailed analytics.
-1. At the top of the page, click **Get usage report** to generate a CSV report of your premium request use for the past 45 days.
-
-When the report is ready for you to download, you'll receive a message to your primary email account with a link to download the report. The link will expire after 24 hours. For details of the fields included in the reports, see [AUTOTITLE](/billing/reference/billing-reports#premium-request-analytics-usage-report-fields).
+For details on how to request a usage report, see [AUTOTITLE](/billing/how-tos/products/view-productlicense-use#downloading-usage-reports).
 
 ## Optimizing usage of premium requests