Google Cloud Platform Monitoring Datasource Integration

Knowi comes with inbuilt support to create a dataset using Google Cloud Platform (GCP) Monitoring as a datasource. Add it to the dashboard and build numerous visualizations with an altered representation of the GCP metrics.

Add GCP Monitoring Datasource

  1. Select Queries from the left sidebar menu.

  2. Click on the NEW DATASOURCE+ button from the top right corner of the interface.

  3. Select Google Cloud Platform Monitoring under the API & Cloud Services.

  4. Add the following details to configure GCP monitoring datasource:

    a. Datasource Name: Name of your datasource
    b. Scope: Permissions list
    c. Key File: Upload Key File to authenticate the application as a service account
    d. Google Monitor Project Name: Project name (ID) associated with Google account used for application as a service account.

  5. Click on the Test Connection to confirm successful connection to the GCP Monitoring datasource, hit the Save button, and start Querying.

Connect-gcp

Query GCP Monitoring Datasource

The GCP Monitoring datasource can be queried in two ways:

  • Metric
  • Meta

Query Mode: Metric

The options available may change depending upon the metric you select.

  • Query Type: Select the query type

  • From-To: Choose the time period for which you wish the results to be returned.

  • Metric Folder: Select the Metric Folder from which you want to retrieve the list of metrics from GCP.

  • Metrics: Metrics from selected Metric Folder will populate here. Select the metrics type you wish to monitor.

  • Dimensions (Filters): Select the dimensions of the metric you are querying from the dropdown list. Dimensions are name/value pairs that carry additional data to describe the metric value. Note: Using the asterisk for one or more dimension values, you can keep track of a dynamic set of metrics. More info here

  • Aggregation Aligner: The aligner specifies the operation that will be applied to the data points in each alignment period in a time series. Except for ALIGN_NONE, which specifies that no operation be applied, each alignment operation replaces the set of data values in each alignment period with a single value: the result of applying the operation to the data values. An aligned time series has a single data value at the end of each alignment period. More info here

  • Cross-Series Reducer: A Reducer operation describes how to aggregate data points from multiple time series into a single time series, where the value of each data point in the resulting series is a function of all the already aligned values in the input time series. More info here

  • Alignment Period: Alignment period for aggregation, in seconds. More info: https://cloud.google.com/monitoring/api/v3/aggregation#picking-alignment-periods

  • Additional Filter: Enter an additional filter. For example: metric.labels.instance_name="instance-vm-one-two-3". More info here

Here is an example of a Query made against Google Cloud Platform Monitoring:

query-GCP

Below are the preview results of the Query based on the information provided above.

gcp-preview

Query Mode: Meta

Meta query mode offers to select the Meta type. Depending upon the Meta type, users may be asked to configure Metrics Folder, Metrics, Additional Filter, Dimensions (Filters), From To Time, and other parameters.

query-mode-meta