Skip to main content

Google Cloud Operations (formerly Stackdriver) integration

You can configure a Google Cloud Operations Suite (formerly Stackdriver) webhook to post notifications to Moogsoft Cloud when events of interest occur.

Before you begin

This integration was validated with Google Cloud Operations Suite on December 11, 2020.

Before you start to set up your integration, make sure:

  • You have an active Google Cloud Operations Suite account.

  • You have the necessary permissions to create alerts and notifications channels in Google Cloud Operations Suite.

  • Google Cloud Operations Suite can make requests to external endpoints over port 443. This is the default.

  • You have created an API key and have access to a copy of it.

Configure the integration in Moogsoft Cloud

To configure the integration:

  1. Click Integrations > Ingestion Services.

  2. Under Integrations, click Create Your Own Integration.

  3. Click Add New Integration.

  4. In the Moogsoft Endpoint field, provide a unique integration name to describe this plugin.

    You can give it the same name as the target application or customize the name according to your business needs.

  5. In the API Description field, enter a description (optional) of the purpose for the API or other information relevant to your business needs.

  6. Click Save.

The custom endpoint is now provisioned.

Note

Leave this browser tab open as you will use it later on in the procedure. Open a new tab to configure the current integration. See Create your own integration for additional help.

Define the webhook in Google Cloud Operations Suite

To create a new webhook in Google Cloud Operations Suite, do the following:

  1. Log in to Google Cloud Operations Suite.

  2. Click the Settings/Configuration menu.

  3. Click Monitoring > Alerting.

  4. Click Edit Notification Channels.

  5. Scroll down to the Webhook section and click Add New.

  6. Enter the following variables:

    • Endpoint URL: Copy the Endpoint URL from Moogsoft Cloud and paste it in this field.

      The endpoint displays in Moogsoft Cloud under Integrations > Ingestion Services > Create Your Own Integration > <Your Integration> > Configuration Information after you save your integration.

      Example:

      https://api.moogsoft.ai/v1/integrations/custom/<custom_id>/<your_integration>

    • Display Name: Moogsoft

  7. Select the User HTTP Basic Auth check.

  8. Enter the following variables:

  9. Click Test Connection.

Map Google Cloud Operations data to event fields

To map Google Cloud Operations Suite data to event fields in Moogsoft Cloud, do the following:

  1. Go back to your Moogsoft Cloud browser tab.

    If you closed your tab, navigate to the Map your Data section of your integration:

    1. Click Integrations > Ingestion Services.

    2. Click Create your own integration.

    3. Click the custom integration that you created in the first part of this procedure.

  2. Under Map Your Data, click the received payload to view the fields.

  3. Scroll down and map the source fields from Google Clouds Operations to target fields relevant in Moogsoft Cloud.

    The mappings for Source, Description, Service, Check and Severity in the following table should work for most cases, but you may prefer to map the fields according to your own business needs.

    • Click Add a Mapping to add new rows for additional mappings.

    • To add a default value, click inside a field, scroll to the end of the list of possible source fields, and then click Default Value. You can then type in the default text to display.

    • To create a tag mapping in the Moogsoft Target Fields column, click inside a field and then click Add Tag.

    • After creating a mapping, click Add to save it.

    Field mappings Map the Google Cloud Operations source fields (left) to the Moogsoft Cloud target fields (right).

    Source fields

    Target fields

    incident.resource_display_name

    Source

    incident_summary

    Description

    incident.metric.displayName

    Check

    incident.state

    Severity

    incident.resource_type_display_name

    Service

    incident.policy_name

    Class

  4. Click Map Values and map the Google severities (left) to the Moogsoft Cloud severities:

    Source value

    Target value

    closed

    Clear

    *

    Unknown

    *

    Warning

    *

    Minor

    *

    Major

    open

    Critical

    Note

    Fields marked with * indicate this severity mapping is not used.

    Click Save.

  5. Scroll down to the Set Your Deduplication Key section and then click Test Deduplication Key.

  6. Click Save and Enable.

In this section: