--- title: Add a GCP Project to Hyperglance description: This guide will help you connect a GCP Project to Hyperglance --- [Skip to content](https://support.hyperglance.com/knowledge/add-a-gcp-project-to-hyperglance#main-content) English Show submenu for translations [More support](https://support.hyperglance.com/knowledge/kb-tickets/new?hsLang=en) ![](https://support.hyperglance.com/hs-fs/hubfs/hyperglance.png?width=100&height=75&name=hyperglance.png) Open main navigation Close main navigation - English Show submenu for translations - [More support](https://support.hyperglance.com/knowledge/kb-tickets/new) - [Contact Us](https://www.hyperglance.com/contact/) [Contact Us](https://www.hyperglance.com/contact/) How can we help you? - There are no suggestions because the search field is empty. 1. [Hyperglance Support](https://support.hyperglance.com/knowledge?hsLang=en) 2. [Setup & Configuration](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en) 3. [GCP](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#gcp) # Add a GCP Project to Hyperglance ## This guide will help you connect a GCP Project to Hyperglance ### Prerequisites #### Prereq #1 - API Enablement For projects where Hyperglance will ingest inventory resources from please enable the following APIs: - Compute Engine API - API Gateway API - BigQuery API - Cloud Functions API - Cloud Resource Manager API - Cloud Monitoring API - Storage API For projects that store only billing data in BigQuery then only the BigQuery API needs to be enabled. #### Prereq #2 - Big Query Cost Exports Hyperglance will ingest billing data from BigQuery. For this to work you must [enable cost exports to BigQuery.](https://cloud.google.com/billing/docs/how-to/export-data-bigquery) #### Prereq #3 - Service Account To access a project Hyperglance will use a Service Account.  Create a GCP Service Account and download the credentials json file to input into Hyperglance later. Assign both these roles to the service account: - **Compute Viewer**  (this is a [predefined role](https://cloud.google.com/iam/docs/understanding-roles)) - A custom role role with the following permissions: - ``` apigateway.apiconfigs.getapigateway.apiconfigs.listapigateway.apis.listapigateway.gateways.listbigquery.tables.listbigquery.tables.getbigquery.datasets.getcloudfunctions.functions.liststorage.buckets.getstorage.buckets.getIamPolicystorage.buckets.liststorage.objects.getIamPolicyStorage.objects.list ``` Additionally the service account will need these predefined roles assigned to but only for the project that owns the BigQuery billing exports: - **BigQuery Data Viewer** - **BigQuery Job User** NOTE: As we increase service coverage in Hyperglance our recommendations around which roles or permissions are required will change ### Connect to the project within Hyperglance 1. Log in to Hyperglance 2. Visit the Settings page 3. Click Connect to GCP: ![](https://support.hyperglance.com/hs-fs/hubfs/image-png-Oct-17-2024-06-49-04-1180-PM.png?width=670&height=234&name=image-png-Oct-17-2024-06-49-04-1180-PM.png) 4. Complete the form to connect to a project (inputs described below): ![](https://support.hyperglance.com/hs-fs/hubfs/image-png-May-02-2025-07-35-06-0466-PM.png?width=721&height=971&name=image-png-May-02-2025-07-35-06-0466-PM.png) Hyperglance will ingest resource inventory from the project that owns the Service Account, this information will be provided via the Credentials json field.  It will also ingest billing data from BigQuery, since this is usually held in a different project that is why you are prompted for the Billing Account ID and Billing Project ID. 1. **Alias** - A user chosen name for the connection 2. **Project ID** - The ID for the project you want to connect to. 3. **Credentials json** - The credentials json file for a service account in GCP 4. **Billing Account ID** - See: https://cloud.google.com/billing/docs/how-to/find-billing-account-id 5. **Billing Project ID** - The project ID of the project that owns the billing BigQuery exports 6. **Organization Groups** - Optionally tag this connection to group it with others in the Hyperglance platform. 5. Submit the form. 6. If everything is successful GCP inventory and billing should start to be ingested and a connection entry should appear on the Settings page: ![](https://support.hyperglance.com/hs-fs/hubfs/image-png-Oct-17-2024-06-58-18-7863-PM.png?width=670&height=171&name=image-png-Oct-17-2024-06-58-18-7863-PM.png) - [Before You Start](https://support.hyperglance.com/knowledge/before-you-start?hsLang=en#main-content) - [Kubernetes](https://support.hyperglance.com/knowledge/before-you-start?hsLang=en#kubernetes) - [GCP](https://support.hyperglance.com/knowledge/before-you-start?hsLang=en#gcp) - [AWS](https://support.hyperglance.com/knowledge/before-you-start?hsLang=en#aws) - [Azure](https://support.hyperglance.com/knowledge/before-you-start?hsLang=en#azure) - [Using Hyperglance](https://support.hyperglance.com/knowledge/using-hyperglance?hsLang=en#main-content) - [Automations](https://support.hyperglance.com/knowledge/using-hyperglance?hsLang=en#automations) - [Inventory & Diagrams](https://support.hyperglance.com/knowledge/using-hyperglance?hsLang=en#inventory-diagrams) - [Rules](https://support.hyperglance.com/knowledge/using-hyperglance?hsLang=en#rules) - [Cost Management](https://support.hyperglance.com/knowledge/using-hyperglance?hsLang=en#cost-management) - [Dashboards](https://support.hyperglance.com/knowledge/using-hyperglance?hsLang=en#dashboards) - [Security & Compliance](https://support.hyperglance.com/knowledge/using-hyperglance?hsLang=en#security-compliance) - [Setup & Configuration](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#main-content) - [Updating & Migrating](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#updating-migrating) - [General](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#general) - [RBAC & Users](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#rbac-users) - [STIGS & FIPS](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#stigs-fips) - [AWS](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#aws) - [Azure](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#azure) - [Kubernetes](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#kubernetes) - [GCP](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#gcp) - [API](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#api) - [Legacy Docker-based deployments](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#legacy-docker-based-deployments) - [AI](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#ai) [![Chill listening crop-3](https://support.hyperglance.com/hs-fs/hubfs/hyperglance.png?width=134&height=24&name=hyperglance.png "Chill listening crop-3")](https://www.hyperglance.com/) 2880 Zanker Road, Suite 203, San Jose, CA 95134 Copyright © 2025 Hyperglance. All rights reserved.