This document teaches you how to access Cloud Billing Reports in the Google Cloud console and how to configure reports, providing details on how to use the various report settings, filters, and report features to track and understand your Google Cloud usage costs.
View your billing reports and cost trends
Use the Reports page to view and analyze your Google Cloud usage cost and cost trends using a variety of configurable settings and filters. The Reports page displays a chart that plots usage costs for a Cloud Billing account, including costs in all projects linked to the billing account. To help you view the cost trends that are important to you, you can select a data range, specify a time range, configure the chart filters, and group your data by a variety of options, such as by project, service, SKU, or location. See common report configuration scenarios .
Cloud Billing reports can help you answer questions like these:
- How is my current month's Google Cloud spending trending?
- Which Google Cloud project cost the most last month?
- Which Google Cloud service (for example, Compute Engine or Cloud Storage) cost me the most?
- How do my daily costs per Google Cloud service compare over time?
- What are my forecasted future costs based on historical trends?
- How much am I spending by region?
- What was the cost of resources with label X ?
Permissions required to access reports
Depending on your level of Cloud Billing access, you can view cost reports for a Cloud Billing account (including viewing the costs for all of the projects linked to the billing account), or you can view cost reports limited to the Google Cloud projects for which you have cost view access.
Full billing account permissions
To view all costs for a Cloud Billing account, you need permissions on the Cloud Billing account .
Cloud Billing account permissions are granted using roles on the billing account. To view the cost reports for your Cloud Billing account, including viewing the cost information for all of the Google Cloud projects that are linked to the billing account, you need a role on your Cloud Billing account that includes the following permissions :
-
billing.accounts.get -
billing.accounts.getIamPolicy -
billing.accounts.getSpendingInformation
To gain these permissions using a predefined role , ask your administrator to grant you one of the following Cloud Billing IAM roles on your Cloud Billing account:
- Billing Account Viewer
- Billing Account Costs Manager
- Billing Account Administrator
Project-scoped billing permissions
Depending on your level of Cloud Billing access for project costs, you can access the tools in Cloud Billing to view aggregated costs and other billing data for multiple projects linked to a Cloud Billing account, or you can view billing information for individual projects, one project at a time.
For more information about project-limited permissions for viewing costs in Cloud Billing accounts, see project-scoped access to Cloud Billing accounts .
To view aggregated billing data for all of your authorized Google Cloud projects, you need a combination of project and billing account permissions:
- Projects
: you need billing-specific cost view permissions on each Google Cloud project
. Project permissions are granted with
roles on the Google Cloud project or folder
.
At a minimum, you need the following permissions on each project:
-
billing.resourceCosts.get -
resourcemanager.projects.get
-
- Cloud Billing account
: you need project-scoped billing
permissions on the Cloud Billing account
that is linked to your authorized projects
.
Billing account permissions are granted
using roles on the Cloud Billing account
.
For multi-project-scoped access to the billing account, you need the following role on the Cloud Billing account :
Learn more about the permissions required for multi-project-scoped access to Cloud Billing accounts .
To access Cloud Billing to view costs for an individual Google Cloud project, one project at a time, you only need billing-specific permissions on the Google Cloud project .
- Projects
: you need billing-specific cost view permissions on each Google Cloud project
you want to view. Project permissions
are granted with roles on the Google Cloud project or folder
.
At a minimum, you need the following permissions on each project:
-
billing.resourceCosts.get -
resourcemanager.projects.get
-
- Cloud Billing account permissions aren't required : If you are viewing billing information for one project at a time, you don't need permissions on the Cloud Billing account that is linked to your authorized Google Cloud project .
Learn more about the project permissions required for single-project-scoped access to Cloud Billing accounts .
For more information about Cloud Billing permissions , see:
For more information about Google Cloud project permissions , see:
Access the reports page
To view the cost reports for your Cloud Billing account or projects, follow the procedure that fits your level of access to Cloud Billing accounts . Cost reports for a Cloud Billing account are accessible in the Billing section of the Google Cloud console.
Full billing account permissions
If you have full Cloud Billing account permissions, you can select from a list of billing accounts that you have permissions to access.
-
In the Google Cloud console, go to your Cloud Billing account.
Go to your Cloud Billing account - At the prompt, choose the Cloud Billing account
for which you'd like to view cost reports.
The Billing Reports page opens for the selected billing account using default settings , displaying all costs for the current month, grouped by service.
When you access reports with full billing-account-level permissions , you can see costs for all of the projects that are linked to the Cloud Billing account.
If you enabled Gemini Cloud Assist , you can use the Gemini Cloud Assist in Cloud Billing features on the Report.
Project-scoped cost view permissions
Depending on your level of Cloud Billing access for project costs, you can access the tools in Cloud Billing to view aggregated costs and other billing data for multiple projects linked to a Cloud Billing account, or you can view billing information for individual projects, one project at a time.
When you are granted cost view permissions on each Google Cloud project , and have the Project Billing Costs Manager role on the Cloud Billing account that is linked to your projects, you can view aggregated billing data for all of your authorized projects.
-
In the Google Cloud console, go to your Cloud Billing account.
Go to your Cloud Billing account - At the prompt, choose the Cloud Billing account
for which you'd like to view cost reports.
The Billing Reports page opens for the selected billing account using default settings , displaying costs for all of your authorized projects, for the current month, grouped by service.
When you have multi-project-scoped access to billing reports, you can configure the Projects filter to view costs for one or many projects.
If you enabled Gemini Cloud Assist on your authorized projects, you can use the Gemini Cloud Assist in Cloud Billing features on the Report.
Important : If you only have project permissions, but don't have any permissions on your project's Cloud Billing account, you'll need to select your project before you navigate to the Billing section.
-
Sign in to the Google Cloud console dashboard and select a project.
Open Google Cloud console - Select a project for which you'd like to view cost reports.
- Next, navigate to Billing
: Open the Google Cloud console Navigation
menu
, and
then select Billing
.
If you're prompted to choose which billing account you want to view and manage, click Go to linked billing account to view the billing account that's linked to your selected project.
The Billing Reports page opens for the selected billing account.
As a project user accessing the Cloud Billing account using project-level permissions only , you can see costs for a single project – the project that you selected in the Google Cloud console before you accessed the Billing section.
If you enabled the Gemini Cloud Assist API in the selected project , and you're granted the Gemini-specific IAM roles on the selected project , then you can use the Gemini Cloud Assist in Cloud Billing features on the Report.
About the default Cloud Billing report
Based on your report filters and other settings, the report chart displays a stacked bar chart where each bar plots costs over time. The Group bysetting determines what each stack in the bar represents — each grouping gets its own stack in the bar chart and row in the table.
By default, the report uses the Services — this monthpreset report view , which returns a report showing the current calendar month's daily cost for all services and SKUs, grouped by Service.
If you have enabled Gemini Cloud Assist in Cloud Billing , the Gemini Cloud Assist features are available above the report header. Gemini features include saved reports , Gemini-assisted reports creation , and report summaries .
The following information explains how to interpret the different sections of the report when using the default report view:
-
For a quick view of your actual cost totals compared to forecasted costs, use the report headerabove the report chart. The report headerincludes the following information:
- Actual cost-to-date for the current month, including total savings, and a percent change indicator to show you if your overall costs are trending up or down compared to the previous time period.
- Total forecasted cost for the entire current month, including forecasted savings, and a percent change indicator to show you how your forecasted costs are trending compared to the previous time period.
-
For a daily summary and breakdown of costs by service, view the report chart. The chart displays the current month's daily usage-specific costs grouped by service (for all Google Cloud projects), including any usage-specific savings applied.
-
The chart also includes forecasted costs, indicated in the chart in light gray, helping you visualize how your forecasted costs are trending.
-
Each stacked bar in the chart (and row in the table) corresponds to the service, ranked largest to smallest by subtotal.
-
-
For cost totals by service, view the report table. The table shows a row for each service that incurred usage-specific costs and savings for the month, sorted by the Subtotalcolumn in descending order.
-
For a quick view of your actual, usage-specific cost totals, look at the report footer, below the table.
The values that display in the footer depend on the report's time range settings, filters, and your permission level for viewing costs in the Cloud Billing account. When viewing the report using an Invoice month time range, the footer totals can include invoice-level costs and credits such as taxes and adjustments. If your permissions limit your billing report access to viewing costs for a single project, you won't see invoice-level charges.
Note that the report's default settings are different if you access the report from the Budget and alerts page—the report's timeframe and filters are configured using the budget's scope settings. For details, see Viewing a budget in your report .
Manage report settings and filters
Use the various report settings and filters to customize the report view.
You can select a preset report or saved report , and you can further refine the data displayed in the report by adjusting the Time range , Group by , and the various report Filters .
If Gemini Cloud Assist in Cloud Billing is enabled, you can ask Gemini Cloud Assist to create a report.
Ask Gemini Cloud Assist to find or create a report
If you enabled Gemini Cloud Assist in Cloud Billing , you can ask Gemini Cloud Assist to create a report . When prompted, Gemini interprets your request and automatically configures the report settings and filters to create the report for you.
Use preset reports for quick configuration
Cloud Billing provides several recommended reports with preconfigured settings that you can select for efficient access to your usage and cost data.
- Select See all reportsto open a comprehensive list of reports, including your custom saved reports and the Google Cloud-created, recommended preset reports.
- Also, for customers who have enabled Gemini Cloud Assist in Cloud Billing , the preset reports and your custom saved reports are accessible in a carousel that displays below the Ask Gemini Cloud Assist prompt field. The most frequently viewed reports (from both your custom saved reports and the preset reports) appear in the carousel. You can scroll the reports carousel left and right to select a report.
The following Google Cloud-created, preconfigured report views are available:
Description : The current calendar month's daily cost for all services and SKUs, grouped by Service (for example, Compute Engine or Cloud Storage), including any usage-specific savings applied, but not including invoice-level charges or credits such as taxes and adjustments.
Description : The current calendar month's daily cost for all services and SKUs, grouped by Project , including any usage-specific savings applied, but not including invoice-level charges and credits such as taxes and adjustments.
Description : The current calendar month's daily cost for all services and SKUs, grouped by SKU , including any usage-specific savings applied, but not including invoice-level charges and credits such as taxes and adjustments.
Description : The current calendar month's daily cost for all services and SKUs, grouped by Date > Service , including any usage-specific savings applied. In the report table, expand the row for a day to see your daily costs summarized per service. This view doesn't include invoice-level charges and credits such as taxes and adjustments.
Description : The current calendar month's daily cost for all services and SKUs, grouped by Date > Project , including any usage-specific savings applied. In the report table, expand the row for a day to see your daily costs summarized per project. This view doesn't include invoice-level charges and credits such as taxes and adjustments.
Description : The current calendar month's daily cost for all services and SKUs, grouped by Date > SKU , including any usage-specific savings applied. In the report table, expand the row for a day to see your daily costs summarized per SKU. This view doesn't include invoice-level charges and credits such as taxes and adjustments.
Description : The daily costs for the last seven days (L7D) for all services and SKUs, grouped by Date > Service , including any usage-specific savings applied. In the report table, expand the row for a day to see your daily costs summarized per service. This view doesn't include invoice-level charges and credits such as taxes and adjustments.
The most recent, complete invoice month's daily cost for all services and SKUs, grouped by Service; including savings and invoice-level charges , such as tax; aggregated by total invoice costs for the invoice month, not by individual invoices*.
If your permissions limit your billing report access to viewing costs for a single project, you won't see invoice-level charges.
The most recent, complete invoice month's daily cost for all services and SKUs, grouped by Project; including savings and invoice-level charges , such as tax; aggregated by total invoice costs for the invoice month, not by individual invoices*.
If your permissions limit your billing report access to viewing costs for a single project, you won't see invoice-level charges.
The most recent, complete invoice month's daily cost for all services and SKUs, grouped by SKU; including savings and invoice-level charges , such as tax; aggregated by total invoice costs for the invoice month, not by individual invoices*.
If your permissions limit your billing report access to viewing costs for a single project, you won't see invoice-level charges.
Set the Time rangefor the report data
The type of Time rangethat you select, and the time period that you configure, affects your ability to view certain types of costs on the report (such as forecasted costs or invoice-level charges ).
You can select between Usage dateor Invoice monthtime range types, then set a date or month range to view the Google Cloud costs incurred during the specified time period.
When you select Usage date, you can choose a preset or custom time range for charting cost data (available back to January 2017). If you select Invoice month, you can set a time range based on complete months (available back to May 2019).
A 24-hour time period in the Cloud Billing report starts at midnight US and Canadian Pacific Time (UTC-8), and observes daylight saving time shifts in the United States.
By Usage date
- Returns actual usage and cost data incurred during the date range you specify (available back to January 2017).
- Forecasted costs: The report chart includes forecasted costs if the date range ends on a future date.
- Taxes and adjustments: Invoice-level charges such as taxes and adjustments are not included in the report when viewing costs for a Usage date time range.
- Negotiated savings: When you set the report time range by Usage date , the Cost column displays your costs calculated using the prices that are applicable to your Cloud Billing account. If your Cloud Billing account is associated with a custom pricing contract , the negotiated savings are included in the Cost calculations.
By Invoice month
- Returns usage costs and invoice-level charges on the invoices issued for the months selected (available back to May 2019).
- Invoice-level charges include taxes, contractual credits, adjustments, or surcharges, and are calculated when an invoice is issued. You can view invoice-level charges in the report footer when you use an Invoice month time range, and all of the other report Filters are set to show ALL options (such as all Projects, Services, SKUs, and Savings). If your permissions limit your billing report access to viewing costs for a single project, you won't see invoice-level charges.
- Negotiated savings: When you set the report time range by Invoice month , starting with the May 2021 invoice, Cloud Billing accounts associated with a custom pricing contract display Negotiated savings as a savings column, separate from the List cost column. List costs are your costs calculated using the list price , prior to applying your negotiated savings or any other discounts.
- Note that Billing Reports aggregates all invoice costs for the invoice month , and not by individual invoice. If you receive more than one invoice in a month, your invoice month totals might not map to the totals of an individual invoice issued in the same month. If you want to view detailed costs per individual invoice , see the Cost table report.
Use Group byto summarize costs
Costs in the report are summarized by the Group byoption that you select.
- The Group byoption that you select determines the columns and rows that appear in the report table, and affects how the data is presented in the report chart.
- When using a single-dimension Group byoption, you can change the sort order of the rows in the report tableby clicking on a column header. When using a multiple-dimension Group byoption (such as Date > Project), the sort order of the rows in the report tableis fixed and you can't change the order.
- Depending on the Time range set on the report, when you choose a single-dimension Group byoption, the data that is displayed in the report chartis first grouped by date or month, and then by the single-dimension Group by(such as service, project, or SKU). In the report table, when using a single-dimension Group byoption, each row summarizes the costs for the selected option (such as service, project, or SKU).
- Each grouping gets its own bar (or line) in the chart and row in the table.
- The Group byoption also affects the report data that you can download to a CSV file .
The Group byoptions include the following:
| Single dimension | Multiple dimension by date | Multiple dimension by month |
|---|---|---|
|
Subaccount
Project Project Hierarchy Product Service Originating Service > Service SKU Application Location: Region or multi-region* Label keys No grouping (show total cost only) |
Date > Subaccount Date > Project Date > Project Hierarchy Date > Product Date > Service Date > Originating Service > Service Date > SKU Date > Application Date > Location: Region or multi-region* |
Month > Subaccount Month > Project Month > Project Hierarchy Month > Product Month > Service Month > Originating Service > Service Month > SKU Month > Application Month > Location: Region or multi-region* |
Single-dimension Group by options
- The report table summarizes costs per the selected Group by option, creating one row for each.
- The report chart shows costs grouped by time, and the selected Group by option. If the report's time range is set for 62 days or less, the report chart automatically shows costs by day. If your time range covers more than 62 days, the report chart automatically shows costs by month. Use one of the multiple-dimension date-based or month-based Group by options to control the display of data in the report chart .
| Subaccount | If you're viewing a primary billing account with subaccounts , you can select this Group by option to summarize your costs by subaccount. |
| Project | When grouped by Project, the report table includes columns for Project (this is the project name), Project ID , and Project number . When grouping by Project , costs that don't belong to a project display as [Charges not specific to a project] . The Project number is a Google-assigned, anonymized number that's automatically generated for each project you create. In your support cases and other customer communication, Google refers to your projects by the project number. The project number persists after you delete a project, and any costs associated with deleted projects are identified with the project number. Learn more about identifying projects . |
| Project hierarchy | Project hierarchy is the project's ancestry, the resource hierarchy mapping of a project (Organization > Folder > Project). When grouped by Project hierarchy , the report table returns a row for each unique combination of Organization > Folder > Project , and the table includes columns for Project , Project ID , Project number , and Project hierarchy . The values listed in the Project hierarchy column show Organization name > Folder name . Projects can stand alone or be the child of an organization or folder. When grouping by Project hierarchy , projects that stand alone display as [Project not associated with any folders or organizations] . The project hierarchy Group by option is selectable when the report's Time range is set to start on or after January 1, 2022 . Learn more about analyzing costs by project hierarchy . |
| Product | A Product represents a group of SKUs (possibly from more than one Google Cloud service ) that work together and are sold as a single service, sometimes referred to as a logical product family or a subscription service. Examples include Gemini Enterprise and Firebase App Hosting. When grouped by Product , the report table shows your costs in the report chart summarized by date (or month) and product, and each row in the report table shows your actual costs and savings summarized by product. |
| Service | The default Group by setting is Service , which shows your costs in the report chart summarized by date (or month) and service, and each row in the report table shows your actual costs and savings summarized by service, such as Compute Engine and BigQuery. |
| Originating service > Service | Originating services are Google Cloud services that cause usage in another service. When grouped by Originating service > Service , the report table shows your costs in the report chart summarized by date (or month) and Originating service , and each row in the report table shows your actual costs and savings summarized by Originating service . In the report table , you can expand each row for an Originating service to see your costs summarized by each Service that is associated with the Originating service . For example, Google Kubernetes Engine (GKE) can cause usage in Compute Engine. If you expand the GKE originating service row, you can view the costs for the Compute Engine service, and any other services where the costs were triggered by the use of GKE. |
| SKU | To analyze the granular details of your costs and savings, group your costs by SKU. When grouped by SKU, the report table includes columns for SKU , Service , SKU ID , and Usage . Costs and savings are calculated per SKU and SKU pricing tiers . |
| Application | When grouped by Application , your costs and savings in the report table are summarized by App Hub applications. App Hub applications might incur usage and costs in more than one billing account and associated projects. Cost data by application might be based on partial data, limited to projects and costs for the Cloud Billing account that you're actively viewing. When grouping by Application, costs that don't belong to an App Hub application display as [Charges not specific to an application] . |
| Location: Region or multi-region* | When grouped by Location , your costs and savings in the report table are summarized by the Regions where your applications are located. When grouping by Location , costs that don't belong to a region or multi-region display as [Charges not specific to a location] . Multi-region listings are marked with an asterisk (for example, us*). |
| Label keys | Grouping by Label keys summarizes costs by each label value that's paired with the selected label key (for example, key1:value-A, key1:value-B, key1:value-C). Costs that aren't tagged with the selected Label key are summarized as [Charges for other usage] . Learn more about creating and managing resource labels . The Cloud Billing report shows you the cost data for a specific
label only after the label was added to a resource. For example, if you add
the label When grouping by label keys, you don't see labels that are applied to a project . You see other user-created labels that you set up and applied to Google Cloud services . For more information, see common uses of labels and best practices for using labels . |
| No grouping (show total cost only) | Summarizes the total cost for the specified time range and selected filters. |
Multiple-dimension Group by options
- The report table summarizes costs grouped by date or month, creating one row for each, in descending order, listing the most recent costs first. You can expand a row to view the cost breakdown by the additional Group by dimension (such as the daily cost breakdown by service).
- The report chart shows costs grouped by date or month plus the additional Group by dimension. The sort order in the chart shows the time range in ascending order, from earliest to latest dates or months, when the chart is read from left to right.
| Date-based Group by
options
Date > Subaccount Date > Project Date > Project Hierarchy Date > Product Date > Service Date > Originating Service > Service Date > SKU Date > Application Date > Location: Region or multi-region* |
When you choose a date-based Group by option, (such as Date > Service ) the report chart shows the actual and forecasted costs for each day, and each row in the report table shows the actual cost for each day. In the report table , you can expand each row for a day to see your daily costs summarized by the additional dimension (such as the daily cost breakdown by service). For example, if you choose Date > Project , you can see each day's costs broken down by project. If your time range is set to span more than 366 days, the date-based Group by options aren't selectable. You can use the month-based Group by options. |
| Month-based Group by
options
Month > Subaccount Month > Project Month > Project Hierarchy Month > Product Month > Service Month > Originating Service > Service Month > SKU Month > Application Month > Location: Region or multi-region* |
When you set a time range that spans more than one month, you can choose month-based Group by options (such as Month > Service ). When you choose a month-based Group by option, the report chart shows the actual and forecasted costs for each month, and each row in the report table shows the actual cost for each month. In the report table , you can expand each row for a month to see your monthly costs summarized by the additional dimension (such as the monthly cost breakdown by service). For example, if you choose Month > Project , you can see each month's costs broken down by project. |
Use Filtersto refine report data
Filtersrefine the data that is returned to your report.
- The filter tilesare displayed horizontally above the report.
- Configured filters are displayed with a light blue background. Filters that use the default settings for that filter are displayed with a white background.
- In each filter tile, after you open the filter and change the settings, you must click Applyto update your report with the filter selections.
- If your Report page is long, as you scroll the page, the filter tilesremain visible at the top of the page.
- To undo any filter updates and return the filters to their default state, above the filter tilesclick Reset filters.
- Some filters are only present when applicable to your Google Cloud configuration or your billing account cost data. For example, if you don't have any type of Savings applied to your Google Cloud costs, you won't see the Savings filter.
Subaccounts
Folders & Organizations
Folders and organizations are part of a project hierarchy , the resource hierarchy mapping of a project. If you configure the Time range filter to start on or after January 1, 2022 , you can select all folders or organizations (default) that are associated with the projects that are linked to the Cloud Billing account , or select a subset of folders or organizations.
The values in the selector are listed in alphabetical order by resource name. To determine if a value is an organization or a folder, look at the ID number displayed under each name . ID numbers are prefaced with folders/ or organizations/ to indicate the type of resource.
For the Cloud Billing account you're viewing, if none of
the linked projects
are associated with any folders or organizations, then this filter
option isn't displayed. You can still group by Project hierarchy
.
For projects that don't have any ancestors, the Project hierarchy
column
displays [Project not associated with any folders or organizations]
.
Products
Google Cloud products consist of a group of SKUs (potentially from more than one Google Cloud service ) that work together and are sold as a single service, sometimes referred to as a logical product family or a subscription service. Examples include Gemini Enterprise and Firebase App Hosting.
You can select all products or select a subset of products by clicking them in the list.
Services
Google Cloud services are infrastructure-as-a-service components that consist of a group of related SKUs. Many services, including Compute Engine and BigQuery, appear in the top-level navigation in the Google Cloud console.
You can select all services (default) or select a subset of services by clicking them in the list. In the list, you can identify the services by Service name and Service ID, with the ID number displayed under each Service name .
Originating services
Originating services are Google Cloud services that cause usage in another service. For example, Google Kubernetes Engine (GKE) can cause usage in Compute Engine. In this use case, when you are viewing the Compute Engine usage and costs, GKE is an originating service when it causes usage in Compute Engine.
You can select all originating services or select a subset of originating services by clicking them in the list. In the list, you can identify the originating service by Service name and Service ID, with the ID number displayed under each Service name.
Projects
You can select all Google Cloud projects linked to the Cloud Billing account (default) or select a subset of projects by clicking them in the list. In the list, you can find Projects by Project name and by Project ID, with the Project IDs displayed under each Project name . If a project is shut down or deleted , the project is listed only by project number .
Some costs, such as Support costs, aren't related to a project, and
are shown as [Charges not specific to a project]
.
If you are viewing the report using multi-project-scoped permissions , you can select to view costs for one or more of your authorized projects.
If you're viewing the report using project permissions only , the Projects filter is limited to a single project — the project that you selected in the Google Cloud console before you accessed the Billing section. You can't select a different project. If you want to view the Billing Report for a different project, then you must exit the Billing section, select a different project using the Google Cloud console project selector, and then access the Billing section again.
SKUs
To learn more about SKUs, see the pricing table report .
Applications
You can select all App Hub Applications (default) or select a subset of Applications by clicking them in the list.
App Hub applications might incur usage and costs in more than one billing account and associated projects. Cost data filtered by application might be based on partial data, limited to projects and costs for the Cloud Billing account that you're actively viewing.
To filter on costs that aren't part of an App Hub application, select [Charges not specific to an application] .
Locations
By default, all locations are enabled. Click the location tiles to filter on a subset of locations by geography (such as Americas , Asia-Pacific , or Europe ), multi-regions (such as Global* ), or regions (such as us-east1 ). Specifically, the report costs are filtered by the regions and multi-regions you select.
Use the geography
tiles to quickly select (or deselect) all
regions and multi-regions in that geography. Multi-regions tiles are
marked with an asterisk (for example, us*
).
Learn more about geography and regions .
Labels
Labels are key-value pairs you attach to resource usage (for example, Compute Engine, Cloud Storage, or Google Kubernetes Engine).
To filter usage costs by label, follow these steps:
- Expand the Labels filter.
- Select a label Key .
- Select the Values under the key that you're filtering on (the default is all values under the selected key).
To add another label with a different key, click + Add label , and then select the key and values for the label filter.
To remove a label filter, to the right of the label fields click Remove or the delete icon ( ).
When filtering by label keys, you can't select labels applied to a project. You can select other user-created labels that you set up and applied to Google Cloud services. For more information about labels, see common uses of labels and best practices for using labels .
goog-fleet-project
goog-k8s-cluster-location
goog-k8s-cluster-name
goog-k8s-node-pool-name
k8s-namespace
k8s-namespace-labels
Savings
You can select all applicable Savings options (default) to include in the cost calculations, or you can clear some or all of the Savings options to exclude credits, discounts, and other savings from the cost calculations.
The Savings filter displays only the specific types of savings that you incurred in your Google Cloud costs. If a particular type of credit or discount doesn't apply to your Cloud Billing account, you won't see that Savings option in the list.
Learn more about viewing your Savings .
Invoice level charges
If you configure the Time range filter to use the Invoice month type, you can select all invoice-level charges (default) to include in the cost calculation totals, or you can clear some or all of the invoice-level options. Invoice-level charges display in the report header above the chart and in the report footer below the table. Learn more about viewing your charges by invoice .
Adjust chart settings
The chart settings affect the display of report data in the online view of the report chart. The chart settings don't change the data that is downloaded to CSV.
Costs aggregated over time
Time aggregation affects the display of data in the report chart. The report chart is designed to always display cost data summarized by a time variable and a secondary Group bydimension. Based on the time range setting you select, the report chart shows cost totals aggregated by day or month. You can also specify a preferred time aggregation using the date-based and month-based Group by options.
In the chart, the sort order by time shows the time range in ascending order, from earliest to latest dates or months, when the chart is read from left to right.
To change the chart view to visualize how the costs are accumulating over time, select the Show cumulativeoption for the chart.
A Daily time period in the Cloud Billing report starts at midnight US and Canadian Pacific Time (UTC-8), and observes daylight saving time shifts in the United States.
Chart style
You can specify a different chart display style using the Line Chart/ Bar Chartselector above the chart.
- The line chartoption creates a stacked area chart, with lines plotted over time for each Group byoption.
- The bar chartoption creates a stacked bar chart, with bars plotted over time. Each bar in the chart is divided into a number of stacked sub-bars, each one corresponding to a Group byoption.
Data order
The data order in the report chartand the report tabledepends on the type of Group byoption that you choose to use in the report settings.
-
Single-dimension Group by options : When using a single-dimension Group byoption (for example, Service, Project, or SKU), the order of the data displayed in the stacked line or bar chart is controlled by the data category you're sorting by in the report table– indicated by an arrow in the table's column headers. The default sort order is set on the Subtotalcolumn, sorting rows in descending order, from largest to smallest costs.
You can change the sort order of the data by clicking on a different column header. The direction of the arrow indicates if you're sorting in descending order – largest to smallest (down arrow ), or ascending order – smallest to largest (up arrow ). To reverse the sort order on the selected column, click the column header again.
-
Multiple-dimension Group by options : When using a multiple-dimension Group byoption (for example, Date > Service or Month > Project ), the sort order of rows in the report tableis set in descending order, by newest to oldest date or month . If you expand a row to view the costs summarized by the additional dimension, the cost breakdown is sorted on the subtotalcolumn in descending order, from largest to smallest costs.
You can't change the sort order of the report data when you're using a multiple-dimension Group byoption.
Generate and run a SQL query against your exported billing data
On the Reports page, you use the report settings and filters to refine the data returned to your report. If you enabled Cloud Billing data export to BigQuery , you can generate a SQL query in BigQuery that's configured to use the equivalent Billing Report settings and filters to query your exported billing data. When run against your exported billing data , the generated query returns the equivalent results in BigQuery as the results in the Billing Report.
Prerequisites to generate and run a query
To generate a query from a Cloud Billing Report, ensure you and your Cloud Billing account meet the following requirements:
-
On your Cloud Billing account, Cloud Billing data export to BigQuery must be enabled, for either the standard usage cost data or detailed usage cost data .
-
You must have permissions to view costs for your Cloud Billing account . If you're viewing the report using project-level permissions that limit you to accessing costs for a single project, you can't generate a query.
To run the query in BigQuery, you need the following permission:
-
You need the BigQuery Userrole for the Google Cloud project that contains the BigQuery dataset being used to store the Cloud Billing data.
-
If using custom roles to grant permissions to the billing export project, your custom role must include the
bigquery.jobs.createpermission.
You generate a SQL query from a Cloud Billing report. The query is generated to and run in BigQuery. You might have permissions on your Cloud Billing account that allow you to configure a report and generate a query, without you having the BigQuery permissions that are required to run the query.
Cost of use to generate and run queries
- In Billing Reports, when you Generatea SQL query from a billing report, you're not chargedfor this action.
- However, in BigQuery Studio, when you Runthe query to produce results, you are chargedfor that action. The cost depends on the amount of data you query.
For more information about the cost of using BigQuery to store and analyze your Cloud Billing data, see Cost of use .
Generate a query
To create a SQL query to run against your billing data exported to BigQuery, that returns results equivalent to the console report, do the following:
- Go to the Cloud Billing Reports in the Google Cloud console.
- Set your preferred report Time range, Group by, and other Filters to create a report.
-
Click Generate query.
A new browser window opens for BigQuery Studio, and a SQL query is generated, configured to query your exported billing data with the equivalent parameters in use on your Billing Report. In BigQuery Studio, the project selected is the same project set up in your Billing export configuration .
About the generated query
The generated SQL query consists of five clauses, creating a query that returns the equivalent results of the source Billing Report.
- SELECT- Defines the columns that the query will return, including expressions to calculate the values in each column.
- FROM- The full path to the data table that contains the Cloud Billing data exported to BigQuery
,
specified using three values separated by dots:
project-ID.BQ_dataset_name.BQ_table_name - WHERE- Equivalent to the Report's Time range setting and includes any specific, non-default filter settings you selected on the report.
- GROUP BY- Equivalent to the Report's Group by setting .
- ORDER BY- Equivalent to the default data order setting for the report (which is based on the selected Group byoption).
Run the query
After you generate a query from a Billing Report, you must run the query to view its results in BigQuery Studio.
- Follow the Generate a query procedure to create a SQL query in BigQuery Studio.
-
In BigQuery Studio, click Runto run the query and view the query results.
-
After you run the query, you can save the query results using a variety of options, such as CSV, JSON, a BigQuery table, or Google Sheets. Select Save resultsto see the available save options.
You can also explore the data with tools such as Sheets, Looker, or Python. Select Explore datato see the available explore options.
Learn more about BigQuery
- Introduction to SQL in BigQuery
- Overview of BigQuery analytics
- Explore using BigQuery in the Google Cloud console
- About BigQuery IAM roles and permissions
- Control access to BigQuery resources with IAM
- Estimating BigQuery storage and query costs
Save and share report views
You can set many options to customize your online reports. After configuring your report settings to create a customized view, you might want to save your settings to be reused later by you or someone else in your organization who has the required level of permissions to view reports for the Cloud Billing account. You can use these options to save and share your customized report views:
-
Saved reports: You can select Save as newto save the chart settings and the Group byand filtersettings you selected when configuring your report. Saved reportsare saved to the All reportspage and are available for viewing by users in your organization with Cloud Billing account-level access, who can view reports for all costs and projects for the Cloud Billing account.
- Select See all reportsto open a comprehensive list of reports, including your custom saved reports and the Google Cloud-created, recommended preset reports .
- Also, for customers who have enabled Gemini Cloud Assist in Cloud Billing , your custom saved reports and the preset reports are accessible in a carousel that displays below the Ask Gemini Cloud Assist prompt field. The most frequently viewed reports (from both your custom saved reports and the preset reports) appear in the carousel. You can scroll the reports carousel left and right to select a report.
-
Share: Optionally, you can share the URL of a customized report using the Sharebutton. Shareis a quick option to send the URL of a customized report to a recipient of your choice, outside of the Reports UI. As you configure your report by setting filters and groupings, your browser URL updates to include your selections. You can share the report by copying the URL. The Sharefeature is available to customers with Cloud Billing account-level access, as well as to Project Owners, Project Editors, and Project Viewers who can view Cloud Billing reports for their specific Google Cloud projects.
Permissions required to create or access a saved report
The Saved reports feature is available in the Reports page to customers who have the correct level of permissions on the Cloud Billing account. To interact with the Saved reports feature, you must have permissions with Cloud Billing account-level access. The roles with the necessary permissions are Billing Account Administrator , Billing Account Costs Manager or Billing Account Viewer on your Cloud Billing account.
- Billing Account Administrators and Billing Account Costs Managers have full access to the Saved reports feature, and can create a new, custom saved report , open any saved report , and update , rename , and delete custom saved reports.
- Billing Account Viewers have access to open a previously created saved report , but can't create new saved reports, or update, rename, or delete any saved reports.
- If you are a Project Owner, Project Editor, or Project Viewer, you can view Cloud Billing reports for your specific Google Cloud projects, including using Google Cloud-provided preset reports . However, because this level of billing access doesn't allow you to view all costs for all projects linked to the Cloud Billing account, you can't create or access custom saved reports in the All reports page. Instead, you can use the Share feature to copy and share the URL of a report you have customized.
For more information about Cloud Billing permissions, see Overview of Cloud Billing access control .
Save a new report view
- Go to the Cloud Billing Reports in the Google Cloud console.
- Set your preferred chart settings and report Group by and other Filters .
- Next to the report name, click Save as new.
- Enter a namefor your saved report (required). By default, a name is autofilled based on the selected filters.
- Click Save as new.
Open a saved report
- Go to the Cloud Billing Reports in the Google Cloud console.
- Click See all reportsin the Reports toolbar.
- Your custom, saved reports are categorized in the Your reportslist. You can choose one of your reports, or one of the Google Cloud-provided preset reports .
- Click a saved reportto open the report with the saved settings and filters. If you have many saved reports, you can Filter for a report by report name to narrow down the list of reports to choose from.
Alternatively, if your custom saved report is one that you frequently view, then that report might appear in the reports carousel. Note that to use the reports carousel, you must enable Gemini Cloud Assist in Cloud Billing . Your frequently accessed custom saved reports and the Google Cloud-provided preset reports are accessible in the carousel that displays below the Ask Gemini Cloud Assist prompt field.
Update a custom saved report to use different report settings
- Go to the Cloud Billing Reports in the Google Cloud console.
- Click See all reportsin the Reports toolbar.
- Click one of your saved reportsto open your report with the saved settings and filters.
- Update the chart settings and report Group by and other Filters to produce a different report view.
- Next to the report name, click Save.
-
Select Save changesto save the report with the updated settings.
Your updated filter settings are now saved to your existing saved report using the original name of the saved report. If you want to rename your saved report to reflect the updated setting and filters, follow the steps to rename your saved report .
Create a new saved report based on an existing saved report
- Go to the Cloud Billing Reports in the Google Cloud console.
- Click See all reportsin the Reports toolbar.
- Click one of your saved reportsto open your report with the saved settings and filters.
- Update the chart settings and report Group by and other Filters to produce a different report view.
- Next to the report name, click Save, then select Save as new.
- Enter a namefor your saved Report (required). By default, a name is autofilled based on the previous report name.
- Click Save as new.
Rename a saved report
- Go to the Cloud Billing Reports in the Google Cloud console.
- Click See all reportsin the Reports toolbar.
- Click one of your reportsto open the saved report that you want to rename. Note that you can't rename any of the Google Cloud-provided preset reports .
- To the right of the report name, select the actionsmenu ( ).
- Select Edit report name.
- Update the name of your report, and then click Save.
Delete a saved report
- Go to the Cloud Billing Reports in the Google Cloud console.
- Click See all reportsin the Reports toolbar.
- Click one of your reportsto open the saved report that you want to delete. Note that you can't delete any of the Google Cloud-provided preset reports .
- To the right of the report name, select the actionsmenu ( ).
- Select Delete report.
- Select Deleteto permanently delete the saved report. This action can't be undone.
Share or bookmark the URL of a customized report
In addition to using the Saved views feature, you can bookmark or share the URL of a report you have customized. As you configure your report by setting Filtersand the Group byoption, your report page URL updates to include your selections.
- You can share the report by copying the URL. Click Shareto copy the URL to your clipboard.
- Optionally, in your browser, you can bookmark the URL to save the URL with your report settings.
Download filtered report data to a CSV file
You can download the report data to a comma-separated values (CSV) file using the Download CSVselector located above the summary table. The data that downloads is limited by any filters that you have set and includes all of the rows and columns in the report table, plus additional columns , depending on the Group bysetting you select.
CSV filename
For the Reports data, the filename follows this pattern:
[Billing Account name]_Reports, [YYYY-MM-DD] - [YYYY-MM-DD].csv
For example, a CSV file of the Reports data downloaded for a Cloud Billing account named My Billing Account , for a date range of October 1 to December 31, 2022 , is named:
My Billing Account_Reports, 2022-10-01 - 2022-12-31.csv
Duplicate report names
If you download a report with the same date range multiple times, then the default report name will be the same. If you configured your report with a specific set of parameters, you might want to rename the CSV file to something that will help you differentiate between reports run using the same date range but using different report settings or filters.
Columns in the CSV file download
The columns of data in a CSV file depend on the Group bysetting . Every CSV file includes data for the following charges and savingscolumns, with amounts aggregated by the selected Group byoption:
- Costor List cost: This is the cost of usage at the on-demand rate (list price) before any savings are applied. Cost or List cost is equivalent to the Usage cost column that appears in the report table. If your Cloud Billing account is associated with a custom pricing contract and your report settings result in the display of the Negotiated savings column, you will see a List cost column in your CSV download . Otherwise, if your report doesn't include a Negotiated savings column, you see a Cost column in your CSV download .
- Negotiated savings : If your Cloud Billing account is associated with a custom pricing contract, you'll see the Negotiated savings column.
- Savings programs : Includes credits and discounts for your committed use discounts.
- Other savings : Includes promotional credits, sustained use discounts (SUDs), and other savings.
- Unrounded subtotal: The calculated cost of the usage to a precision of up to six decimal places, which can be helpful when analyzing your cost details and understanding the source of any discrepancies due to rounding.
- Subtotal: The calculated cost of the usage rounded to two decimal places.
- Percent change in subtotal compared to previous period: If your report table displays this column, then the percent change values are included in the CSV download. This column isn't included in the CSV download for reports using a multiple-dimension Group byoption, such as Date > Serviceor Month > Project.
Each currency-column label includes a symbol for the currency of the Cloud Billing account (for example, $ for USD or £ for GBP).
Group bysetting
In addition to the charges and savings columns, the Group byoption and the Time rangesettings affect which columns of data are downloaded, and the Group byoption affects the granularity of the report. The more granular the report, the more rows are returned.
| Group by setting | Rows in report | Additional columns included in CSV download |
|---|---|---|
|
Date-based Group by
(for example, Date > Service
)
|
One row for each dimension, broken down by date. For example, if you choose Date > Project , the CSV has one row for the daily costs of each project. When you select a date-based option, the CSV file doesn't include the Percent change column. | Date |
|
Month-based Group by
(for example, Month > Service
)
|
One row for each dimension, broken down by month. For example, if you choose Month > Project , the CSV has one row for the monthly costs of each project. When you select a month-based option, the CSV doesn't include the Percent change column. | Month |
|
Project
|
One row with costs summed per each project , with an additional row for costs not specific to a project. | Project name, Project ID, Project number |
|
Project Hierarchy
|
One row with costs summed per each project hierarchy , with an additional row for costs not specific to a project, and a row for costs not included in a project hierarchy. | Project name, Project ID, Project number, Project hierarchy |
|
Service
|
One row with costs summed per each service (such as Compute Engine, Cloud Run, App Engine). | Service description, Service ID |
|
SKU
|
One row with usage and cost details for each SKU. This Group by setting returns the most granular details in the cost reports. | Service description, Service ID, SKU description, SKU ID, Usage amount, Usage unit |
|
Subaccount
|
One row with costs summed per each billing account, including the parent account and its subaccounts. | Billing account name, Billing account ID |
|
Location: Region or multiregion
|
One row with costs summed per each unique region where usage occurred, including a row for charges not specific to a location. | Region |
|
Label keys
|
When grouping by label, you can select one label key
at a time.
The report returns one row for each unique label key:value pair
for the selected label key, and a row for charges for other
usage. |
Label |
Additional notes about the CSV
-
The filters you set customize the rows that are displayed in the table, and the data that is downloaded to CSV.
-
The costs and savings data in the report table is aggregated for the specified time range .
-
The report CSV has header information that includes the Cloud Billing account name and the date range set on the report.
-
The report CSV includes the footer details that appear below the report table. The footer details might include invoice-level costs such as Tax and Adjustments if you configured your report to show the invoice details .
Data availability
The data availability information in this section applies to customers who are accessing a Cloud Billing account using billing-account-level permissions . If your access to a billing account is limited to project-level permissions, you might not be able to view all available cost data or report configuration options for a Cloud Billing account.
- In Cloud Billing reports, usage cost data is available back to January 2017 at the SKU level.
- Cost data viewed by invoice monthis available back to May 2019 at the SKU level.
- Data at the sub-SKU level (for example, by resource ID) isn't available.
As of January 2017, the following data is included in Cloud Billing reports:
-
SKU usage: This is reported in the pricing units shown on the pricing table report , for example, gibibyte month .
-
SKU cost: The SKU cost is based on the list price or custom contract price for that usage, whichever price is applicable to your Cloud Billing account. The cost is reported in the currency that your Cloud Billing account is charged in.
-
Usage-specific savings: This includes any credits or discounts that were applied directly to the SKU usage, such as sustained use discounts,committed use discounts, or free trial and other promotional credits that were applied.
-
Location data: This includes costs incurred by region or multi-region .
As of May 2019, the following data is available in the Cloud Billing reports:
-
Taxes: Taxes that were applied to your invoices are reported by Invoice monthselected.
-
Account-level billing modifications: Sum of credits or surcharges applied at the account level due to Cloud Billing corrections or contractual requirements. Reported as Adjustmentswhen viewing reports by Invoice month. The month that an adjustment is issued might differ from the month when the adjustment is applied. For guidance on how to analyze adjustments, see Understand memos and adjustments .
-
Invoice details: You can graph or group usage by Invoice month. We don't display the invoice number in this report view.
When viewing costs by Invoice month, the following data is available in the Cloud Billing reports:
Invoices generally include all costs incurred during a given calendar month, but the cost for some services' usage at the very end of a calendar month might roll over to the next month's invoice. As a result, your invoice might include costs for more than one calendar month. Usage is reported by actual usage date when viewing your invoice details and online reports .
Other data specific to an invoice includes the totals of any taxes and adjustments.
- For a detailed breakdown of the taxes on an invoice, view the cost table report , or view the details of your invoice .
- For guidance on understanding and analyzing any adjustments, see Understand memos and adjustments .
As of May 2021, the following data is available in the Cloud Billing reports:
-
Negotiated savings: Viewable for Cloud Billing accounts that are associated with a custom pricing contract, Negotiated savingsshows the difference in cost between your contract price compared to the current list price. The Negotiated savingscolumn is displayed when viewing your report for a Time rangethat starts after May 1, 2021.
Prior to May 1, 2021, your costs are calculated using your custom contract price, resulting in a single Usage costcolumn that includes your negotiated savings in the cost calculations.
As of January 1, 2022, the following data is available in the Cloud Billing reports:
- Project hierarchy: Project hierarchy is the project's ancestry, the resource hierarchy mapping of a project (Organization > Folder > Project). When viewing your report with a starting time range of January 1, 2022, you can group your data by project hierarchy.
- Folders & Organizations: Folders and organizations are components of a project hierarchy. When viewing your report with a starting time range of January 1, 2022, you can filter your data by folders and organizations.
FAQs
How do I get access to the granular data behind Cloud Billing reports?
You can configure your Cloud Billing account to export data to BigQuery and then use BigQuery or your own tools to analyze the exported cost line items. For example, from your BigQuery tables, you can choose to export your BigQuery data as CSV (or other formats) to a Cloud Storage bucket . The Cloud Billing data exported to BigQuery is the same data that your Cloud Billing reports use.
Can I save or share my Cloud Billing report view?
Multiple options are available.
- Save a report view: You can save customized report views using the Saved reports feature. Saved reports are available in the All reportspage to anyone who has Cloud Billing account-level access to view billing reports.
- Share a report: You can Share a report by copying and sharing the URL of your customized Cloud Billing report.
-
Bookmark a report: You can save a customized Cloud Billing report view to be accessible in your browser by bookmarking the report URL. The URL includes the report settings you selected.
-
Print a report: You can Printthe Cloud Billing report.
-
Download report CSV: You can download the report data to a CSV file using the Download CSV selector at the top right of the summary table.
-
Create a custom report: You can recreate the report using queries of your exported Cloud Billing data .
How do I filter or group costs by zone, region, or multi-region?
You can group your costs by region or multi-region, and you can filter on locations (regions and multi-regions). The Cloud Billing reports don't support filtering or grouping by zone .
Why are my usage date costs different than my invoice month costs?
Google Cloud and billing-eligible products such as Google Maps Platform, Google AI Studio, and Firebase report usage data to Cloud Billing at varying intervals. Due to the complexity of our billing and processing systems, you might see a delay between your use of services, the usage charges being applied to your Google payments accounts, and the usage and costs being available to view in the various cost reports and dashboards.
- Typically, your cost details are available within a day, but can sometimes take more than 24 hours.
- For self-serve, online accounts, it's possible that charges for some usage might occur rapidly, such as 5 to 15 minutes after usage.
- Because of this difference in timing, you might notice charges on your Postpay or Prepay payments accounts occur before you can view the details of those charges in a cost report or billing dashboard. These system delays also impact budget alerts, anomaly detection, and billing data exported to BigQuery.
At the end of a calendar month, late-reported usage might not be included on that month's invoice and instead might roll over to the next month's invoice.
When you view your online reports, usage is shown by the actual usage date, which might be different from the invoice month.
Common report configuration scenarios
The following table lists common report configuration scenarios and provides links to instructions for each task.
