![](<https://www.versio.io/img/supported-technology/google-cloud.svg>)

# Google Cloud Platform importer

Versio.io can import, historize and process monitoring data from Google Cloud Platform.

## Configuration

You can find the configuration option in Versio.io at `Environment settings > OneImporter > Configurations > Google Cloud Platform`.

Here you can edit all existing configurations, create new configurations or delete existing configurations. To add a new configuration, enter a `Name` for your importer and an `Entity suffix` (default: `-google-cloud`) to clearly identify your Google Cloud entities.  
Note that the `Entity suffix` is fixed and cannot be changed afterwards.

Click `Add` to proceed to the configuration.

To edit an existing configuration, click the arrow on the left of your importer name to expand the configuration options.

The following configuration options are available:

| Field | Description | Advice |
| --- | --- | --- |
| **Name** | Meaningful name | Add the word "Google" to identify the importer when viewing the logs |
| **Active** | Option to activate and deactivate the configuration. Data is only imported if the configuration is activated. |  |
| **Service account JSON key** | JSON document containing all relevant access information | 1\. Enable the cloud asset inventory API of your GCP project: [see here](<https://cloud.google.com/asset-inventory/docs/listing-assets>).<br>2\. Create a service account with the role `roles/cloudasset.viewer` in your GCP project.<br>3\. Create a JSON-based key to access the GCP API: [see here](<https://cloud.google.com/iam/docs/creating-managing-service-account-keys#creating>)<br>4\. Copy the complete JSON file content into the password field of your credential in the Versio.io credential vault (`Environment Settings` \> `Access management` \> `Credential vault`). |
| **Executing OneImporter** | Select a Versio.io OneImporter to import the data based on the importer configuration. | Requires an installed OneImporter: [Installation instructions](<https://docs.versio.io/setup-one-importer/index.md>) |
| **Schedule time (cron format)** | Determine the frequency of imports in CRON format | Learn more about CRON format: [https://en.wikipedia.org/wiki/Cron](<https://en.wikipedia.org/wiki/Cron>) |

*Table: Google Cloud configuration parameters*

The following image is an example of a Google Cloud configuration:

![Versio.io Google Cloud importer configuration](<https://docs.versio.io/img/importer/google-cloud/google-cloud-configuration.png>) *Figure: Example of a Versio.io Google Cloud configuration*

## Create GCP JSON key

The following video shows you how to create the GCP JSON key and create a credential and a GCP importer configuration in Versio.io:

## Example

The Versio.io OneImporter imports Google Cloud data based on a specific configuration into entities with a suffix defined by you (default: `-google-cloud`). To view the imported instances in Versio.io, select 'Asset &amp; Configuration Repository → Instance Viewer'. There you can select your specific instance and click it for a detailed view in the instance history viewer.

The following image is an example of imported Google Cloud data:

![Versio.io Google Cloud instance overview](<https://www.versio.io/img/screenshots/one-importer/google-cloud/versio.io-google-cloud-instance.png>)  
*Figure: Overview of a Versio.io Google Cloud instance (left) and topology of related instances (right)*

![Versio.io Google Cloud topology](<https://www.versio.io/img/screenshots/one-importer/google-cloud/versio.io-google-cloud-topology.png>)  
*Figure: Overview of a Versio.io Google Cloud topology*

## Reference

- [Google Cloud API documentation](<https://cloud.google.com/apis#section-2>)
