Overview

This procedure describes how to deploy and configure a OneIQ Pulse connector VM in your Google Cloud project to collect GCP inventory and performance data.

Steps Involved

Create a dedicated OneIQ Pulse service account, grant it the Viewer role on the target project or projects, and download the JSON key.
Enable the Cloud Resource Manager API & Cloud Runtime Configuration API
In OneIQ, create or select an IT Environment, then deploy the GCP connector using the service account key and project details.
Deployment of OneIQ Pulse VM in GCP

Step 1: Create a OneIQ Pulse service account in GCP

Select the project in GCP, then under IAM and admin / Service Accounts Create a service account that the OneIQ Pulse VM will use.
1. Service account name: e.g. "OneIQ Pulse Service Account"
2. Service account ID: e.g. "oneiq-pulse"
3. Service Account description: e.g. Used by the OneIQ Pulse Connector
Click Create and continue
Under Permissions (optional), select Viewer as the role. (OneIQ Pulse only needs read-only permission.)

Select Done

4. Go to the service account you just created, select Keys, and under Add Key select Create new key, select JSON.

A private key is saved to your computer.

6. If you need to collect data from multiple GCP Projects, go to each project, select IAM, Grant access, add the OneIQ Pulse service account principal email, and set the Viewer role.

Step 2: Enable Cloud Resource Manager API

Navigate to APIs & Services > Library, find "Cloud Resource Manager API"
Click Enable. (Ensure the correct project is selected)

Step 3: Configure the Pulse Connector in the OneIQ portal.

The OneIQ Pulse connector uses a Google Cloud Deployment Manager template (a Jinja file) to create the connector VM and related resources.

Log in to the OneIQ Portal
If GCP is the first platform you're connecting to, then select IT Environment in the left navigation menu, and select Connect IT Environment.
If an IT Environment already exists, then skip to Step 4
Give the IT Environment a name and select Confirm.
Select the IT Environment and click on Deploy connector.
Select Google Cloud Platform
Select the Google Cloud Platform and fill in the details:
1. Connector name: The name of the virtual machine that will be deployed in GCP that will run the OneIQ Pulse connector. e.g. oneiq-gcp-connector
2. Service account: The email address configured in GCP that represents the service account
3. Projects: The Project(s) in GCP that the Pulse Connector should connect to and gather data from.

Click Download to download the .jinja deployment file. Save for the next step.

Step 4: Deploy the Connector using Google Cloud Shell

Open the GCP Console: Go to the Google Cloud Console and ensure you have the correct project selected.
Launch Cloud Shell: Click the Activate Cloud Shell button (a small terminal icon “>_”) in the top-right toolbar of the console.
Upload the Template to Cloud Shell: Next, you need the oneiq-pulse-gcp.jinja file in your Cloud Shell environment:
- Click the ⋮ (three-dot menu) in the top-right corner of the Cloud Shell window and select “Upload file”. Choose the oneiq-pulse-gcp.jinja file you downloaded earlier. This will upload the file into your Cloud Shell home directory (typically at ~/cloudshell_open/).

Run these 3 commands in Cloud Shell in the GCP console, or on a computer with gcloud installed and signed in.


deploymentName=oneiq-pulse-gcp

template="oneiq-pulse-gcp.jinja" # Replace with name of your jinja file

gcloud deployment-manager deployments create "$deploymentName" --template "$template"

If prompted to authorize, then agree to that request.

NB: To remove your deployment, run the following command:

gcloud deployment-manager deployments list

Confirm the deployment name that exists:

gcloud deployment-manager deployments list

Delete the existing deployment (use the exact name shown, example below):

gcloud deployment-manager deployments delete oneiq-pulse-gcp -q