Dynatrace Webhook

You can configure the Dynatrace webhook to post data to Moogsoft Enterprise when actions of interest occur.

Before You Begin

This integration was validated with Dynatrace Version 1.205.

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

  • You have an active Dynatrace account.

  • You have the necessary permissions to create a alerts and notifications channels in Dynatrace.

  • Dynatrace 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 Dynatrace

To create a new webhook, in Dynatrace, do the following:

  1. Log in to Dynatrace.

  2. Under the Manage section, click Settings.

  3. Click Integration > Problem notifications.

  4. Click Set up notifications.

  5. Click Custom integration.

    1. Name: Moogsoft (for example)

    2. Webhook URL: Copy the Moogsoft Endpoint URL and paste it in the 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

    3. Under Additional HTTP headers,click Create basic authorization header.

      1. Username: moog

        NOTE: The username can be anything you want. This field must be completed but it is not referenced.

      2. Password: Paste the API key you copied in the previous section in the field.

      3. Click Add.

    4. Click Add header.

      1. Box 1: Content-type

      2. Box 2: application/json

    5. Custom payload: Copy the payload shown and paste it in the field.

      {
      "State":"{State}","ProblemID":"{ProblemID}","ProblemTitle":"{ProblemTitle}","Source":"{ImpactedEntity}","tags":"{Tags}","ProblemDetailsText":"{ProblemDetailsText}","ProblemImpact":"{ProblemImpact}","ProblemSeverity":"{ProblemSeverity}","ProblemURL":"{ProblemURL}"
      }
      
    6. Click Send test notification.

    7. Click Save.

    8. If relevant to your organization, select the appropriate profile from the Alerting profile list.

      If your company has only one profile, you can leave this set to Default.

Map Dynatrace data to event fields

To map Dynatrace data to event fields in Moogsoft, do the following:

  1. Go back to your Moogsoft tab.

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

    1. Click Data Config > Integrations.

    2. Click Create your own integration.

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

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

  3. Scroll down and map the source fields from Dynatrace 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.

    Dynatrace Source Fields

    Moogsoft Target Fields

    ImpactedEntity

    Source

    ProblemTitle

    Description

    ProblemSeverity

    Check

    State

    Severity

    ProblemDetailsText

    Tag: problemDetails

    Dynatrace

    (Default Value)

    Manager

    tags

    Service

    Unknown

    (Default Value)

    Service

    ProblemImpact

    Class

    ProblemURL

    Tag: dynatraceURL

  4. After mapping the fields listed above, click Map Values.

  5. Map the following severity values:

    1. Map RESOLVED to Clear.

    2. Map CLOSED to Clear.

    3. Map OPEN to Critical.

  6. Click Save.

  7. Scroll down to the Set Your Deduplication Key section and then click TEST DEDUPLICATION KEY.

  8. Click SAVE AND ENABLE.