Optima uses bill data to provide an accurate view of your costs across accounts and services. This data is consumed by the Optima platform and made available for pre-built and ad-hoc analyses. In order to gather the cost information, certain configuration steps must be performed with specific data and credentials being shared with Optima.

This page describes the configuration and input information needed to connect Google billing data to Optima using BigQuery billing exports.

For instructions on using Optima to add or update billing information, see the billing information guide. For instructions on connecting your cloud accounts to the platform for management purposes, see the cloud account management guide

If you have any questions and would like live assistance, please join us on our chat channel on or email us at


This page walks you through the steps to connect your Google cloud billing data to RightScale for cost reporting purposes.

The following steps must be completed in order for RightScale to provide insight on your Google cloud bill:

  1. Enable Billing Data Export to BigQuery in GCE
  2. Allow RightScale to access the BigQuery dataset

Each of the steps above is explained in detail on this page.

Enable Billing Data Export to BigQuery in GCE

RightScale consumes the billing data via the BigQuery export method in Google. This can be enabled in GCE for each Billing Account and will contain data for all projects in that Billing Acccount.

If you have already configured billing export to BigQuery, please ensure you have the Dataset ID and Project that contains the dataset, and proceed to the next step.

If you need to configure data export to BigQuery, please follow the instructions provided by Google for your Google billing accounts.

Take note of the Dataset ID when you create the dataset as well as the Project in which the dataset exists.

Determine ID of the Google Billing Account that pays for this bill's GCP resources

A Cloud Billing Account is a Google construct for managing usage and billing records for GCP resources payed for by a common entity. For more information on Google Cloud Billing Accounts, please see the GCP Overview of Cloud Billing Concepts.

To determine your Google Billing Account ID, navigate here and take note of the Billing account ID circled in green below containing the billing data your wish to onboard.


Note: If you are unable to view any billing accounts in the above UI, please confirm that your user has the required Google privileges.

Allow RightScale to access the BigQuery dataset using a Service Account

Once your billing data is being exported to BigQuery, RightScale needs access to the BigQuery dataset to read the data. The RightScale platform uses a Google Service Account to gain access to the BigQuery dataset.

Create or identify which Google Service Account you want to use for this permission, and ensure you have access to the JSON private key for the service account as well as the service account ID.

Once you have determined the service account you would like to use, the following steps must be completed:

Grant project-level IAM roles

The first step is to grant the service account the roles necessary to interact with BigQuery within the project.

  1. In Google Cloud Platform, navigate to the IAM menu
  2. Ensure the selected project is the on that contains the billing BigQuery dataset
  3. Click on the Add icon at the top of the window
  4. Enter the service account ID in the New members field
  5. Select the BigQuery Job User role
    • BigQuery Job User - needed to create query jobs from which results can be read (currently 2 jobs per day are created)
  6. Click Save


Share the dataset with the service account

Additionally, the BigQuery dataset must explicitly be shared with the service account.

  1. In Google Cloud Platform, navigate to BigQuery
  2. Select the dataset that contains your billing data
  3. In the dataset details pane, select SHARE DATASET


  4. In the Add members box, enter the service account ID

  5. From the Select a role drop down, select BigQuery > BigQuery Data Viewer

  6. Click Add

  7. Click Done


Submit the information

Follow the billing configuration guide to submit the above information to Optima