This article describes the steps required to connect your GCP (Google Cloud Platform) account.

The main steps of the onboarding process are as follows:

1. Create a billing dataset on BigQuery
2. Enable APIs for Umbrella Cost
3. Create a service account on GCP
4. Provide access to the BigQuery billing dataset
5. Connect an additional project
6. Onboard your account in Umbrella Cost

Create a billing dataset on Big Query

1. GCP billing cost data is saved on a BigQuery dataset. To create this dataset and generate the billing report data, follow the steps described in the following GCP article:
   https://cloud.google.com/billing/docs/how-to/export-data-bigquery-setup

💡

Note

1. You need to use the exact naming convention for the billing table name, as we will need this at a later stage during the account connection process.

2. Umbrella Cost does not support reseller-specific export. Whenever setting up the cost export, the preferred option is Detailed usage cost data.

2. After completing this step, make a note of the following information when you enable the cost export:
   1. GCP project ID hosting the BigQuery data set
   2. Billing dataset name
   3. Billing table name

The following image shows how your BigQuery should look on the designated project (the names may be different).

Enable APIs for Umbrella Cost

Enable the following APIs on the chosen project:

1. Recommender API
2. Resource Manager API

Create a service account on GCP

1. Choose the project that contains the billing dataset you created in the first step.

2. Navigate to the IAM & Admin > Service Account page.

3. Click CREATE SERVICE ACCOUNT.

4. 

   Provide a name for the service account and click Create and continue.

5. In the second step (Grant this service account access to the project), add the following roles, and then click Done:

• Monitoring Viewer
• Compute Viewer
• Compute Recommender Viewer
• BigQuery Job User

6. Click on the service account you just created. Navigate to the KEYS tab, and click Create new key.

7. Choose the JSON key type and click CREATE (this will download a JSON file to your computer).

ℹ️

Make a note of the Service Account email and JSON file. These will be used later on during the account onboarding in the Umbrella Cost UI.

Provide access to the BigQuery billing dataset

1. Navigate to the BigQuery service and find the dataset you created with the billing export.
2. Click the three dots next to it and choose Share.

3. Click the ADD PRINCIPAL option. Enter the Service Account email address, add the BigQuery Data Viewer role to it, and click Save.

Connecting additional projects

Connecting additional projects enables Umbrella Cost to analyze multiple projects in one single authorized service account. This will require the service account to be provisioned on any additional project you connect to to retrieve recommendations on resources located under those projects.

1. Under the relevant project, navigate to the **IAM & Admin **> **IAM **page, and click GRANT ACCESS.

2. Under the principal, add the service account email you created for Umbrella Cost, choose the Compute Viewer role permissions, and click Save.

When the account is processed in Umbrella Cost (happens automatically every day), the projects will be connected, and we will be able to create recommendations.
You can see the projects status under the Accounts > Projects page.

Onboard your account in Umbrella Cost

Before starting the onboarding in Umbrella Cost, ensure you have the following information available:

• GCP project ID holding the BQ billing data set
• Billing dataset name
• Billing table name
• Service Account key file

1. Login to Umbrella Cost.
2. Navigate to Account > Cloud Account, and click Create Cloud Account.
3. Click on the GCP cloud icon, and then click Let’s Start.

4. Add the parameters you saved in the previous steps and click Next.

ℹ️

Umbrella Cost will store this information, validate connectivity to the relevant billing dataset, and schedule a task for cost data collection on a daily basis.

For information on how to connect GKE clusters to Umbrella Cost, click here