Skip to main content
Google Cloud Platform

Learn how to use OneIQ Pulse to discover GCP endpoints

Alpha Team avatar
Written by Alpha Team
Updated over a week ago

Prerequisites

  • GCP Project, you can list yours, or create one here

  • Service account and Cloud Resource Manager API

  • OneIQ IT environment

Overview

This article explains how to collect inventory and performance data from GCP.

Discovering GCP

  1. Login to the OneIQ Portal

  2. Select IT Environments in the left navigation menu

  3. In the IT environment, go to the Connectors tab

  4. Select the Google Cloud Platform

  5. In the Download manifest section, add the inputs as shown in the example below

  6. If needed list VM sizes and zones using this account: https://console.cloud.google.com/compute/instancesAdd

Required permissions

For a collection to work an IAM service account is required with the following permissions:

  • Viewer Service Account role

  • Cloud Resource Manager API permissions

IAM

  1. Navigate to GCP IAM menu

  2. Create service account

  3. In the "Grant this service account access to the project" menu, assign the pre-built Viewer role

  4. Note the service account name (for example: oneiq-pulse@projectName.iam.gserviceaccount.com)

  5. Download Service Account Keys

    1. Go to Service Account's Keys

    2. Click Add Key - Create new Key

    3. Choose JSON format

    4. Private key is saved to your computer

  6. Adding the same service account to another project is simple. Open:
    https://console.cloud.google.com/iam-admin/iam?project={id}

  7. Add the same service account that was created in step 5 and grant it with the Viewer role.

Cloud Resource Manager API

The Google Cloud Resource Manager API is used for managing and organizing resources within Google Cloud Platform (GCP) projects. It provides a set of functionalities and tools to help users create, manage, and organize cloud resources in a structured and controlled manner. GCP collection requires Cloud Resource Manager API to be enabled:

  1. Navigate to Cloud Resource Manager API: https://console.developers.google.com/apis/api/cloudresourcemanager.googleapis.com/overview?project={id}

  2. Click Enable

Deployment of OneIQ Pulse in GCP

To deploy the generated manifest use gcloud command either via the cloud shell, or your local instance running gcloud using the following commands:

# Define the name of your deployment: 
deploymentName=oneiq-pulse-gcp

# Define the template containing the manifest for your deployment
template=oneiq-pulse-gcp.jinja

# Deploy your manifest
gcloud deployment-manager deployments create $deploymentName --template $template

To remove your deployment run the following command:
gcloud deployment-manager deployments delete $deploymentName -q

Did this answer your question?