Skip to content

GCP Account Integration

By configuring a Google Cloud (GCP) account authorization, Guance can collect and synchronize the monitoring data and asset information of your cloud resources under your GCP account, enabling unified observability and management of GCP services.

Prerequisites

  • You have the Owner or Administrator role for the Guance workspace.
  • DataFlux Func (Automata) is enabled.
  • You have a GCP account and the permissions to create service accounts and download JSON keys.

Steps

Step 1: Enter Cloud Account Management

  1. Log in to the Guance console, go to Integrations > Cloud Account Management.
  2. Click Create Cloud Account in the upper right corner and select GCP.

Step 2: Configure Authentication

In the Create Cloud Account dialog, configure the parameters as described below:

Parameter Required Description
Select Authentication Method Yes Supports Service Account or Service Account Impersonation. Default is Service Account.
Service Account Key (JSON) Yes Click Select JSON Key File to upload the service account key file (.json format) downloaded from the GCP console.
Account Alias Yes Custom alias for the cloud account, used to identify the account in Guance. Supports up to 256 characters.

Authentication Method Description

  • Service Account: Authenticates by uploading the JSON key file of the service account. Suitable for regular data collection scenarios.
  • Service Account Impersonation: (If needed) Allows a service account to impersonate another identity to perform operations. Suitable for more complex permission delegation scenarios.

Step 3: Test and Save

  1. After configuration, click Test to verify the validity of the key file and whether the permissions meet the collection requirements.
  2. Once the test passes, click Save to complete the GCP account integration.
Note
  • Ensure that the service account has the required permissions to read cloud resource monitoring data (e.g., Monitoring Viewer, Compute Viewer). Otherwise, the integration may install successfully but data collection may fail.
  • Keep the JSON key file secure to avoid leakage.

Configure Integrations

After the cloud account is created successfully, the authorization to Guance is complete. You can install integrations as needed under this account to start data collection.

  1. Click into the cloud account details page > Integrations to view all related integrations under the current account.

  2. Click Install on the right to enter the automatic installation page:

    • The cloud account is automatically filled in.
    • Select the applicable region type as needed.
    • The system automatically identifies the metrics included in the current integration script; you can add or remove them as needed.
    • The filter currently supports = and in operations.

  3. After successful installation, proceed with the script installation.

Feedback

Is this page helpful?