The Cloud Billing Reports page lets you view your Google Cloud Platform (GCP) usage costs at a glance and discover and analyze trends. The Reports page displays a chart that plots usage costs for all projects linked to a 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 by project, product, SKU, or location.
Billing reports can help you answer questions like these:
- How is my current month's GCP spending trending?
- What project cost the most last month?
- What GCP product (for example, Compute Engine or Cloud Storage) cost me the most?
- What are my forecasted future costs based on historical trends?
- How much am I spending by region?
Required permissions to access reports
- To view the billing reports for a your billing account, including cost
information for all projects that are linked to the account,
you need to be a Billing Account Administrator or
Billing Account Viewer on your billing account. Specifically, you need the
billing.accounts.getSpendingInformationpermission on your billing account.
- Project Owners, Project Editors, and Project Viewers can view Cloud Billing reports for their specific projects.
For more information about billing permissions, see:
- Overview of Access Control
- Create Custom Roles for Billing
- Cloud Billing API Access Control
- Understanding Predefined IAM Roles for Billing
To view the Cloud Billing reports for your billing account:
- Go to the Google Cloud Platform Console.
- Open the console navigation menu ( ) and click Billing.
- If you have more than one billing account, select Go to linked billing account to view the current project's billing account. To locate a different billing account, select Manage billing accounts and choose the account for which you'd like to see reports.
- From the Billing navigation menu, select Reports.
How to read the billing report chart
The report chart displays a stacked line chart where each line plots cost over time. The Group by setting determines what each line represents (each grouping gets its own line in the chart and row in the table).
You have a variety of options available to customize your report views, including filters and other settings. Your report view changes depending on the filter selections you choose.
The default view uses the Current month, all projects preset. In the default view:
The report displays the current month's daily usage-specific costs grouped by project (for all GCP products), inclusive of any usage-specific credits applied.
The summary bar above the chart provides a split view of cost: actual cost-to-date for the current month, and the total forecasted cost for the entire current month.
A cost trend line in the chart indicates the direction your forecasted cost is trending.
Each line in the chart (and row in the summary table) corresponds to the project, ranked largest to smallest by cost.
The summary footer, below the table, displays the cost breakdown based on the filter selections chosen.
Changing chart settings
You can specify a different time aggregation using the Daily/Monthly list at the top right of the chart.
You can specify a different chart display style using the Line Chart/Bar Chart selector at the top right of the chart.
The order of the data displayed in the stacked line or bar chart is controlled by the data category you are sorting on, as indicated by an arrow in the column header in the summary table. You can change the sort order of the data by clicking on a different column header. The direction of the arrow indicates if you are sorting largest to smallest (down arrow) or smallest to largest (up arrow ). To reverse the sort order on the selected column, click the column header again.
The following preset views are available:
- Current month, all projects (default): The current calendar month's daily cost for all products and SKUs, grouped by project, inclusive of any usage-specific credits applied.
- Current month, all products: Same as (1), but grouped by products (for example, Compute Engine or Cloud Storage).
- Last month, all projects: The last calendar month's (not the last 30 days') daily cost for all products and SKUs, grouped by project, inclusive of any usage-specific credits applied.
- Last month, all products: Same as (3), but grouped by products.
Filtering and grouping
In addition to the preset views, you can customize your views using the available filters.
Time range: You can select between Usage date or Invoice month.
Usage date returns actual usage and cost data incurred during the date range selected. If you select Usage date, then you can choose a preset or custom time range for charting cost data (available back to January 2017).
Invoice month returns usage and charges on the invoice(s) issued for the month(s) selected. If you select Invoice month, you can set a range based on complete months (available back to May 2019).
Group by: You can use the Group by list to group your cost data by Subaccount, Project (default), Product, SKU, or Locations (region or multi-region). Each grouping gets its own line (or bar) in the chart and row in the table.
Projects: You can select all projects under the billing account (default) or select a subset of projects by clicking them in the list.
Products: You can select all products (default) or select a subset of products by clicking them in the list.
SKUs: You can select all SKUs (default) or select a subset of SKUs by clicking them in the list. To learn more about SKUs, see the Google Cloud Platform SKUs page.
Locations: By default, all locations are enabled. By clicking the location tiles, you can filter on a subset of locations by geography (such as Europe), multi-region (such as Global), or region (such as us-east1). Specifically, the report is filtered by the regions and multi-regions selected. Use the tiles in geography 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.
Subaccounts: If your billing account has subaccounts, you can select all subaccounts (default) or select a subset of subaccounts by clicking them in the list.
Credits: You can select all usage-specific credits (default) to be included in the cost calculations, or you can uncheck some or all of the credit options. Learn more about viewing your credits.
Invoice level charges: If time range is set to Invoice month, you can select all invoice-level charges (default) to be included in the summary cost calculations, or you can uncheck some or all of the invoice-level options. Invoice-level charges display in the summary header above the chart and summary footer below the table. Learn more about viewing your charges by invoice.
Viewing your forecasted costs
You can use the forecast feature to see how your costs are trending and how much you are projected to spend.
If you are viewing your billing report using a date range that ends in a future date, your billing report chart displays both actual costs and forecasted costs:
- The summary bar above the chart provides a split view of cost: actual cost-to-date calculated from the starting date, and the total forecasted cost for the entire date range.
- A cost trend line in the chart indicates the direction your forecast is trending.
Forecasts are available for:
- Any combination of filters (except for an Invoice month time range).
- Any Usage date time range that ends with a future date.
(Forecasts are not available for an Invoice month time range.)
- If you are viewing the report for the current month, the default end date is month end.
- If you choose to specify a Time range, select Usage date, and pick a date range with the To: date set for a future date.
The cost trend is determined by:
- Analyzing all of your historical GCP spend for the filters you have currently selected.
- Selecting the most relevant, recent subset of data to use in the predictive model. For example, if a recent application launch caused a sharp increase in usage, the history selection algorithm might only look at data from after the application launch.
- Generating a forecast that accounts for both your long term trend and any consistent monthly cycles such as sustained use discounts.
The total forecasted cost combines:
- The total actual cost to date in the selected time period.
- The predicted cost for each future day in the same time period.
The time range selected for the report does not affect what data is used to generate the cost trend and forecast. For example, if you are viewing a report for the current month, cost data from previous months is still used to fit the trend.
Viewing your credits
You can change the chart view to exclude usage-specific credits by unchecking the corresponding discounts or promotions checkboxes in the Credits section in the right panel.
Usage-specific credits are applied directly to usage line items. There are two types of credits: discount credits (discounts) and promotional credits (promotions).
Discount credits are recurring and considered an integral part of the final cost.
Discount credits include: free tiers (for certain products that apply credits to implement their free tier), sustained use discounts, committed use discounts, and spending based discounts (earned after a contractual spending threshold is reached).
For example: To understand your ongoing Compute Engine costs, you need to know your VM core and RAM usage costs as well as the sustained use discounts and committed use discounts generated by your core and RAM usage.
Promotional credits are one-time use and are typically considered a form of payment.
Promotional credits include GCP Free Trial and marketing campaign credits.
Tip: To understand your ongoing GCP costs after your GCP free trial expires, uncheck the Promotions checkbox.
If you would like to see an overview of how much your usage-based credits are saving you on your invoice, view the Cost Breakdown report.
Viewing your charges by invoice
You can change the report view to display charges by invoice, including invoice-level charges (for example, taxes, contractual credits, or surcharges). If you want a CSV-downloadable table view of your invoice costs, see the cost table report.
To view invoice charges, in the Time range section in the right panel, select Invoice month, then set your From and To month range.
The Invoice level charges section (below the Credits section in the right panel) is now available and Tax and Adjustments are enabled by default.
The report summary, above the chart, displays taxes when Invoice month is selected.
- The summary footer, below the table, displays the cost breakdown based on your filter selections. Invoice-level charges (tax and adjustments) are blank (—) when you filter by Usage date, or when you set other report filters (like projects, products, or SKUs).
To view all invoice charges for a single invoice:
- In the Time range section in the right panel, select Invoice month, then set your From and To month range for the same month (for example, May 2019).
- Select your preferred Group by setting (for example, project, product, or SKU).
Ensure no other filters are set. That is, you should view the report for ALL projects, products, SKUs, credits, and so on.
In the summary footer, the cost breakdown displays:
- Subtotal: The sum of the Group by costs, after Promotions and Discounts.
- Adjustments: Reported from the invoice. (Adjustments are rare. You won't see this line item if you have no adjustments on your invoices.)
- Tax: Reported from the invoice.
Total: Includes all credits, adjustments, taxes, and rounding errors.
Tip: Rounding errors are included in the total but are not listed as a separate line item. To view the exact rounding error sum, hover your pointer over the tooltip () next to Total.
In billing reports, usage cost data is available back to January 2017 at the SKU level. Cost data viewed by invoice month is available back to May 2019 at the SKU level. Data at the sub-SKU level (for example, by resource ID) is not currently available.
As of January 2017, the following data is included in billing reports:
SKU usage: This is reported in the pricing units shown on the Google Cloud Platform SKUs page, for example, gibibyte month.
SKU cost: The SKU cost is based on the list price or contractual price for that usage. It is reported in the currency that your billing account is charged in.
Usage-specific credits: 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 also available in billing reports:
Taxes: Taxes that were applied to your invoice are reported by Invoice month(s) selected.
Account-level billing modifications: Sum of credits or surcharges applied at the account level due to billing corrections, contractual requirements, and so on. Reported as Adjustments when viewing reports by Invoice month(s). Refer to your invoices for the details of these modifications.
Invoice details: You can graph or group usage by invoice month(s). Note: We do not display the invoice number.
How do I see the data behind billing reports?
You can configure your billing account to export data to BigQuery or to export data to a CSV or JSON file in Cloud Storage, and then use BigQuery or your own tools to analyze the exported cost line items. This is the same data that your billing reports use.
Can I save or bookmark my billing report view?
You can print the billing report or recreate it with billing export data, but currently we don't offer a way to save or bookmark billing report views.
How do I filter or group costs by zone, region, or multi-region?
Why are my usage date costs different than my invoice month costs?
Sometimes there is a slight delay in usage reporting. 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. However, that same usage is reported by actual usage date when viewing your online reports. As a result, costs for a usage date month might not map directly to an invoice month.