Google Cloud Operations Suite (formerly Stackdriver) Webhook

You can configure the Google Cloud Operations Suite (formerly Stackdriver) webhook to post notifications to the Events API 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

To configure the integration:

  1. Click Data Config > Ingestion Services.

  2. Under Ingestion Services, click Create your own integration.

  3. Click ADD NEW INTEGRATION.

  4. In the MOOGSOFT ENDPOINT field, provide a unique integration name.

    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. Under DATA TYPE, select Events.

  7. Click Save.

The custom API is now provisioned.

Note

Leave this browser tab open as you will use it later on in the procedure.

Note

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 and paste it in this field.

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

      Example:

      https://api.moogsoft.ai/express/v1/integrations/custom/cc11a9e714d1/your_application

    • 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, do the following:

  1. Go back to your Moogsoft browser tab.

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

    1. Click Data Config > 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.

    The mappings for SourceDescriptionServiceCheck 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.

    Google Cloud Operations Source Fields

    Moogsoft 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 following severity values:

    Source Fields

    Moogsoft Severity

    *

    Major

    *

    Minor

    *

    Unknown

    *

    Warning

    closed

    Clear

    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.