Monitor connectors

Integration Connectors is integrated with Cloud Monitoring. This means that all your Integration Connectors metrics and usage data is automatically available to Cloud Monitoring. To know about the type of metrics sent by the Integration Connectors service, see Integration Connectors metrics.

You can visualize your Integration Connectors metrics and data using the following Cloud Monitoring tools:

• Custom dashboards
• Metrics Explorer

Before you begin

Before you use Cloud Monitoring, enable the Cloud Monitoring API.

Enable the Cloud Monitoring API

Note: You may incur additional charges for using Cloud Monitoring API directly. For more information, see Cloud Monitoring pricing.

Access metrics using custom dashboards

To create custom monitoring dashboards for your Integration Connectors resources in your Google Cloud project, do the following:

1. In the Google Cloud console, go to the Cloud Monitoring > Dashboard Overview page:

   Go to Dashboard Overview page

2. Click Create dashboard.
3. Optionally, modify the name of the dashboard.
4. Click or drag and drop a chart on the canvas.
5. In the chart configuration properties, perform the following:
   1. Expand the Resource & Metric menu and select Connectors as the Active resource.
   2. Choose the desired metrics that you want to visualize.
   3. Click Apply.
6. Add additional charts to your dashboard as desired.

For more information about custom dashboards, see Create and manage custom dashboards.

Access metrics using Metrics Explorer

The Cloud Monitoring Metric Explorer helps you build temporary metric charts to visualize the available resource metrics for your Google Cloud project. Once you have created a metric chart, if desired, you can also save it to a custom monitoring dashboard.

To create a chart using the Integration Connectors resource metrics, do the following:

1. In the Google Cloud console, go to the Cloud Monitoring > Metrics explorer page:

   Go to Metrics explorer page

2. In the Select a metric pane, expand the Metric menu and select Connectors as the Active resource.
3. Choose the desired metrics that you want to visualize.
4. Click Apply.

You can also select filters, group by metric labels, perform aggregations, and select chart viewing options using the Metric Explorer. For more information, see Create charts with Metrics Explorer.

Monitor using MQL

You can use MQL (Monitoring Query Language) to create custom monitoring dashboards based on various metrics. MQL queries let you aggregate your connection data based on metrics such as connector provider and connector version. You can write MQL queries by using the Query Editor.

The following examples show how to use the MQL queries to gather connection data.

Example - Monitor request count

The following MQL query shows how to get and aggregate request count data for active connections:

fetch connectors.googleapis.com/Connection |
{ metric 'connectors.googleapis.com/connection/state' | filter value.state > 0 | align delta(1m);
metric 'connectors.googleapis.com/connection/request_count'}
| join
| group_by 1m, [value_request_count_aggregate: aggregate(value.request_count)]
| every 1m
| group_by [resource.location, resource.connection, metric.connector, metric.provider],
    [value_request_count_aggregate_aggregate:
       aggregate(value_request_count_aggregate)]

Example - Monitor active nodes

The following MQL query shows how to get and aggregate active node count data for all your connections:

fetch connectors.googleapis.com/Connection |
{ metric 'connectors.googleapis.com/connection/state' | filter value.state > 0 | align delta(1m);
metric 'connectors.googleapis.com/connection/nodes'}
| join
| group_by 1m, [value_nodes_aggregate: aggregate(value.nodes)]
| every 1m
| group_by [resource.location, resource.connection, metric.connector, metric.provider],
    [value_nodes_aggregate_aggregate:
       aggregate(value_nodes_aggregate)]

Example - Monitor connection status over a time period

The following MQL query shows how to get the status trend over a time period for all your connections:

fetch connectors.googleapis.com/Connection
| metric 'connectors.googleapis.com/connection/connection_status'
| filter value.connection_status
| align next_older(10m)
| every 10m
| group_by [metric.status, resource.connection],
    [value_connection_status_count_true: count_true(value.connection_status)]
| align next_older(10m)
| every 10m

If you want to know the status of connections at the current point in time, use the Metrics Explorer in the Google Cloud console instead of a MQL.

Note: You can also configure alerts to know if a connection is in a particular state. For example, you can configure an alert that is triggered when a connection goes to an Error state.

What's next

Understand how to view and manage various Google Cloud services and third party applications (applicable to your Google Cloud project) that are integrated with Cloud Monitoring. For more information, see Manage integrations in Cloud Monitoring.