# Ingest Google Cloud Monitoring Metrics

groundcover supports ingesting Google Cloud Monitoring Metrics directly into our platform, allowing you to visualize them using dashboards and create alerts.

## Things to know <a href="#key-things-to-know" id="key-things-to-know"></a>

### **Integration Interval**

The integration pulls data from GCP according to this interval. The lower the interval, the higher the polling rate and as a result, the overall costs will be higher. The interval can be altered in the configuration wizard.

### **Data storage**

Data fetched is stored in the Victoria Metrics database, meaning metrics are queried via the Google Cloud Monitoring API only one time per data point.

### Supported services

groundcover supports ingestion of every GCP service listed in the GCP [docs](https://cloud.google.com/monitoring/api/metrics_gcp). Users should provide a prefix of a service or metric in order to pull it, e.g. cloudsql.googleapis.com will pull all metrics for CloudSQL, while cloudsql.googleapis.com/database/active\_directory/domain\_reachable will pull this specific metric.

<details>

<summary>List of supported services</summary>

```
actions
aiplatform
alloydb
apigateway
apigee
appengine
apphub
artifactregistry
autoscaler
backupdr
baremetalsolution
bigquery
bigquerybiengine
bigquerydatatransfer
bigquerystorage
bigtable
billingbudgets
blockchainnodeengine
certificatemanager
chronicle
cloudaicompanion
cloudbuild
clouddeploy
cloudfunctions
cloudkms
cloudsql
cloudtasks
cloudtrace
composer
compute
connectors
contactcenterinsights
container
dataflow
datamigration
dataplex
dataproc
datastore
datastream
dbinsights
dialogflow
discoveryengine
displayvideo
dlp
dns
earthengine
edgecache
edgecontainer
eventarc
file
firebaseappcheck
firebaseapphosting
firebaseauth
firebasedatabase
firebasedataconnect
firebaseextensions
firebasehosting
firebasestorage
firestore
firewallinsights
fleetengine
gkebackup
healthcare
iam
identitytoolkit
ids
integrations
interconnect
livestream
loadbalancing
logging
managedflink
managedidentities
managedkafka
maps
memcache
memorystore
metastore
ml
monitoring
netapp
networkconnectivity
networking
networksecurity
networkservices
oracledatabase
osconfig
parallelstore
privateca
pubsub
pubsublite
recaptchaenterprise
recommendationengine
redis
retail
router
run
serviceruntime
spanner
storage
storagetransfer
telcoautomation
tpu
trafficdirector
transferappliance
translationhub
videostitcher
visionai
vpcaccess
vpn
workflows
```

</details>

## Setting up the integration

The integration setup is done directly through the App by following these steps:

1. Navigate to the Data Sources page or follow [this link](https://app.groundcover.com/data-sources). Note that only users with Admin permissions can navigate to this page.
2. Select Google Cloud Platform and follow the 3 steps in the wizard. Note that in step 1 you'll need to provide a Service Account, granting groundcover with permissions to poll metrics. To create a service account, please follow the guidelines in the next section.

### Create a Service Account and Assign Permissions

{% hint style="info" %}
This guide assumes your BYOC backend is set up on GCP. If it's not, please follow the guidelines in this [guide](https://docs.groundcover.com/integrations/data-sources/google-cloud-monitoring/adding-gcp-integration-with-a-backend-on-another-cloud-provider).
{% endhint %}

{% hint style="info" %}
The following steps requires the details of dedicated service account set up the integration - marked below as **\<integrations-sa>.**

Make sure it has been provided to you by the groundcover team
{% endhint %}

1. Go to IAM & Admin in GCP Console
2. Navigate to **IAM & Admin** → **Service Accounts**.
3. Create a New Service Account
   * Click on **Create Service Account**.
   * Provide a **name** and **description** for the service account.
   * Click **Create & Continue**.
   * In the **Grant this service account access to the project** step, search for and select **Monitoring Viewer** (`roles/monitoring.viewer`).
   * Click **Continue** → **Done**.
4. Grant service account impersonation access
   * Click on the newly created service account → **Permissions** → **View by Principals** → **Grant Access**
   * In the **Add principals** → **New principal** section enter the **\<integrations-sa>** provided to you.
   * In the **Assign roles** → **Role** section choose **Service Account Token Creator**
   * Click **Save**


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.groundcover.com/integrations/data-sources/google-cloud-monitoring/ingest-google-cloud-monitoring-metrics.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
