About the integration:


Resolve poor performance and outages before your business users notice, by integrating Datadog Synthetic monitoring with Freshservice. 


Datadog Synthetic Monitoring allows you to observe how your systems and applications are performing using simulated requests and actions from around the globe. Datadog tracks the performance of your webpages and APIs from the backend to the frontend, and at various network levels (HTTP, TCP, SSL, and DNS) in a controlled and stable way, alerting you in case of faulty behavior


Through this integration with Freshservice, triage all your Datadog Synthetic monitoring alerts in Freshservice to enable your team to quickly resolve the issues.


Configuration in Freshservice:


  1. Click on Admin > Alert Profiles > Create a New Alert Profile or open an existing Alert Profile.

  2. Click on Add Integration to select the tool to integrate with

  3. Select Datadog Synthetic Monitoring in the tool selection page

  4. Get the Endpoint URL and the Auth header for Datadog Synthetic Monitoring by following the integration setup.



Configuration in Datadog Synthetic Monitoring:



  1. Click on Integration from left pane and Go to integrations.



  2. In the search toolbar under Integrations tabsearch for Webhooks and click on the webhooks integration from the search result.



  3. Navigate to the Configuration tab in the Webhook pop-up window and select +New button next to the Webhook.



  4. Enter Name, URL, Payload and Headers for the webhook and click save


URL:

Please paste the end-point URL copied from the Freshservice Authorize integration page of Datadog Synthetic Monitoring Integration.

Example:
https://yourcompanyname.alerts.freshservice.com/alert_profiles/715/integrations/614/alerts


Payload:


        {

        "datadog_alert_id": "$ALERT_ID",

        "alert_cycle_key": "$ALERT_CYCLE_KEY",

    "aggreg_key": "$AGGREG_KEY",

    "alert_metric": "$ALERT_METRIC",

    "alert_scope": "$ALERT_SCOPE",

    "alert_status": "$ALERT_STATUS",

    "alert_title": "$ALERT_TITLE",

    "alert_transition": "$ALERT_TRANSITION",

    "last_updated": "$LAST_UPDATED", 

    "priority": "$PRIORITY",

    "tags": "$TAGS",

    "org_name": "$ORG_NAME",

    "link": "$LINK",

    "alert_query": "$ALERT_QUERY",

    "event_title": "$EVENT_TITLE",

    "event_msg": "$EVENT_MSG",

    "event_type": "$EVENT_TYPE",

    "metric_namespace": "$METRIC_NAMESPACE"

}

 

 

Headers :

{ "Authorization": "auth-key eyJhbGciOiJIUzI1NiJ9.eyJhX2lkIjoyOTIsImFwX2lkIjo1Mywic19pZCI6NSwidHMiOjE2MDM5NTgzOTYuNzAyNDMyfQ.-MWvIL98-hIe6oZDUjarHK0WwFe5CiJ4pBqbUxkeQck", "Content-Type": "application/json" }


 

 

  1.  Once the webhook is setup, navigate to UX Monitoring->Synthetic Tests



  2.  Click on New Test and select ‘New API Test’ in the Create a new synthetic test popup window.





  3. Please follow the below guidelines to fill out the New API Test form.

    1. Enter URL which needs to be monitored in url field Eg.https://acme.freshservice.com/health_check

    2. Enter Name for the Synthetic Integration

    3. Select the corresponding Location checkboxes from where the site needs to be pinged and tested.

    4. Assertions - Choose when Status code is 200

    5. Specify Test Frequency - Choose how frequently the site has to be pinged and monitored.

    6. Define alert conditions - Specify condition on when an alert needs to be triggered.

    7. Enter  ‘@’ to get the webhook suggestions list and choose the webhook that you configured earlier from the list.

    8. Click Save to complete the integration.