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 APEX AIOps Incident Management when events of interest occur.

Before you begin

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 Incident Management API key and have access to a copy of it.

Configure the integration in Incident Management

To configure the integration:

  1. Navigate to Integrations > Ingestion Services > Create Your Own Integration.

  2. Click Add New Integration.

  3. Provide a unique endpoint name for the integration, such as "GoogleCloudOperations." Optionally, provide a description.

  4. Click Save.

    The custom endpoint is now provisioned. Keep this page open in a separate tab on your browser for later use.

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. In the left menu, click Alerting.

  3. Click Edit Notification Channels.

  4. Scroll down to the Webhooks section and click Add New.

  5. Enter the following variables:

    • Endpoint URL: Copy the Endpoint URL from Incident Management and paste it in this field.

      The endpoint displays in Incident Management 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: APEX AIOps Incident Management

  6. Select User HTTP Basic Auth to enable it.

  7. Enter the following variables:

    • Auth Username: moogintegration

    • Auth Password: Paste your Incident Management API key in this field.

  8. Click Test Connection.

  9. Click Save.

Map Google Cloud Operations data to event fields

To map Google Cloud Operations data to event fields in Incident Management, do the following:

  1. Go back to your Incident Management browser tab.

    If you closed your tab, navigate to Integrations > Ingestion Services > Create Your Own Integration > your-integration-name.

  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 (right) to corresponding target fields in Incident Management (left).

    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:

    Note

    For more information on how to map fields, read Use mapping types in custom integrations.

    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. Next to the severity target field, click Map Values and map the Google severities (left) to the Incident Management severities (right). Delete all other existing severity mappings:

    Source value

    Target value

    closed

    Clear

    open

    Critical

  5. Click Save.

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

  7. Save and Enable the integration.

In this section: