Get data from Google Cloud Monitoring

Use the Google Cloud Monitoring source function to get data from Google Cloud Monitoring.

Prerequisites

Before you can use this function, you must create a connection. See Create a DSP connection to Google Cloud Monitoring in the Connect to Data Sources and Destinations with the manual. When configuring this source function, set the connection_id argument to the ID of that connection.

Function output schema

This function outputs data pipeline metric events using the metrics schema.

For each metric in the body field, the function includes a resource_type dimension in addition to the ones that are part of the original payload. This resource_type dimension shows the name of the resource type that the metric belongs to.

The following is an example of a typical record from the read_from_gcp_monitoring_metrics function:

{
"timestamp": 1582151880000,
"nanos": 0,
"id": "2823738566644596",
"host": "my-test-instance",
"source": "serviceruntime.googleapis.com/api",
"source_type": "gcp:monitoring:metrics",
"kind": "metric",
"body": {  
     "name": "request_count",
     "unit": "",
     "type": "",
     "value": 2,
     "dimensions": {
          "end_time": "1582151880",
          "location": "global",
          "method": "compute.targetVpnGateways.list",
          "resource_type": "consumed_api",
          "service": "compute",
          "start_time": "1582151820",
          "version": "v1"		
          }
     },
"attributes": {
     "default_unit": "1",
     "default_type": "INT64",
     "default_dimensions": {
          "project_id": "my-google-cloud-project"
          }
     }
}

Required arguments

connection_id

Syntax: string

Description: The ID of your Google Cloud Monitoring connection.

Example in Canvas View: my-gcp-monitor-connection

Optional arguments

initial_position

Syntax: LATEST | TRIM_HORIZON

Description: The position in the data stream where you want to start reading data. Defaults to LATEST.

• LATEST: Start reading data from the latest position on the data stream.
• TRIM_HORIZON: Start reading data from the very beginning of the data stream.

Example in Canvas View: LATEST

SPL2 example

When working in the SPL View, you can write the function using arguments in this exact order.

| from read_from_gcp_monitoring_metrics("my-connection-id", "TRIM_HORIZON") |... ;

Alternatively, you can use named arguments to declare arguments in any order. The following SPL2 example uses named arguments to specify the initial_position argument before the connection_id argument.

| from read_from_gcp_monitoring_metrics(initial_position: "TRIM_HORIZON", connection_id: "my-connection-id") |... ;

If you want to use a mix of unnamed and named arguments in your functions, you must list all unnamed arguments in the correct order before providing the named arguments.

Limitations of the Google Cloud Monitoring source function

The Google Cloud Monitoring source function uses scheduled data collection jobs to ingest data. See Limitations of scheduled data collection jobs for information about limitations that apply to all scheduled data collection jobs.