GCP Compute Engine¶

Google Compute Engine (GCE) is a service within Google Cloud Platform (GCP) that provides virtual machines (VMs) running in Google's data centers. It offers scalable, on-demand computing resources, allowing users to run applications on customizable virtual machines. Our GCP Compute Engine connector allows you to get a clean overview of your GCE most useful metrics, but also more specific metrics about a singular selected Compute instance.

To use this connector, it is mandatory that you enable the Compute Engine API, which will allow us to make calls to your compute instances and gather metrics. Follow the link, connect to your google cloud account, select your gcp project, and then click enable API.

You can then start using our connector to gather metrics.

Name*: A simple label for easier identification in the SenHub interface.
Description: For your personal reference only.
Vault: Select the appropriate vault for this resource from the modal. A vault is linked to a service account, so you must select a service account from the relevant Google project, with reader's permission.
Group: optional — assign this instance to a group to organise it within SenHub.
Resource Type*: Our GCP Connector can be of two types:
- Overview — General overview metrics of all your GCE instances.
- Instance details — Useful info about an instance in particular, if you select this type in the listbox, you will then need to provide the ID of the particular Instance VM you want to monitor. To find this particular ID, you can browse to the instances list following this link, you can search for the wanted instance using filters. Here, under the "Basic Information" category, you can find the ID among other infos

Example output

The channels returned depend on the selected Resource Type. In Overview mode, the connector returns fleet-wide counts (active instances per zone, IPs, snapshots, images, static IPs, quotas near saturation) plus the summed rate of the delta metrics across all instances:

{
  "metrics": [
    { "channel": "Active instances for zones/europe-west1-b", "value": 3, "unit": "#" },
    { "channel": "Number of IPs in use", "value": 3, "unit": "#" },
    { "channel": "Number of snapshots", "value": 8, "unit": "#" },
    { "channel": "Quota over 90% usage", "value": 0, "unit": "#" },
    { "channel": "Number of custom images", "value": 2, "unit": "#" },
    { "channel": "Number of static IPs", "value": 1, "unit": "#" },
    { "channel": "Sum for firewall dropped bytes", "value": 20.48, "unit": "Byte" },
    { "channel": "Sum for disk read operations per second", "value": 1.15, "unit": "/s" },
    { "channel": "Sum for disk write operations per second", "value": 42.60, "unit": "/s" },
    { "channel": "Sum for received packets per second", "value": 59.07, "unit": "/s" },
    { "channel": "Sum for sent packets per second", "value": 62.25, "unit": "/s" }
  ],
  "message": "Metrics successfully retrieved.",
  "status": "OK",
  "date": 1725981405127
}

In Instance details mode, it returns the most recent per-instance monitoring metrics for the selected instance ID (one channel per mounted disk for utilization):

{
  "metrics": [
    { "channel": "firewall dropped bytes", "value": 51.38, "unit": "Byte" },
    { "channel": "disk read operations per second", "value": 1.45, "unit": "/s" },
    { "channel": "disk write operations per second", "value": 1.07, "unit": "/s" },
    { "channel": "received packets per second", "value": 8.68, "unit": "/s" },
    { "channel": "sent packets per second", "value": 11.78, "unit": "/s" },
    { "channel": "CPU utilization", "value": 13.81, "unit": "%" },
    { "channel": "disk utilization /dev/sda1", "value": 37.74, "unit": "%" },
    { "channel": "disk utilization /dev/sda15", "value": 9.33, "unit": "%" }
  ],
  "message": "Metrics successfully retrieved.",
  "status": "OK",
  "date": 1725981405127
}