About the integration:


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


Datadog Application Performance Monitoring (APM or tracing) provides you with deep insight into your application's performance, from automatically generated dashboards for monitoring key metrics like request volume and latency to detailed traces of individual requests side by side with your logs and infrastructure monitoring.


Through this integration with Freshservice, triage all your Datadog APM 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 APM in the tool selection page

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


Configuration in Datadog APM:

  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

Payload:


URL:

Please paste the end-point URL and the Auth header copied from the Freshservice Authorize integration page of Datadog APM 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", 

    "hostname": "$HOSTNAME",

    "priority": "$PRIORITY",

    "tags": "$TAGS",

    "logs_sample": "$LOGS_SAMPLE",

    "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 set-up, navigate to Integrations -> Agents. Select agent for your platform to download the agent. Install the downloaded agent on the monitoring tools. Please also note down the Account API key here.





  2. Please update the API Key in the monitoring tool installed in the machine.





  3. Once the API key is configured, now navigate to Monitor -> New Monitor and choose Metric -> New Metric



  4. Choose the detection method as Threshold Alert

  5. Under Define the metric - choose the name of the metric and the host machine from the dropdown list.

  6. Specify the threshold value to trigger alert.

  7. Under Say what’s happening section, enter a name for the integration. Typing will populate the list of webhooks configured. Choose the webhook from the list that was configured earlier.

  8. Click on Save to complete the integration.