Datadog

Use the Datadog integration to ingest alerts raised by the monitoring system and respond to them automatically.

Overview

Datadog gives you the ability to create monitors that actively check metrics, integration availability, network endpoints, and more.

Using the Fylamynt | Datadog integration you can see the list of available monitors and pick the monitor to trigger a workflow when it goes into the state of Alert.

Use Cases

The integration between Fylamynt and Datadog lets you:

• Trigger a workflow in Fylamynt, when a specific DataDog monitor goes into the state of ALERT.

• Retrieve data from Datadog Monitors based on a search query.

• Returns the test result from all the synthetic tests.

Configure Datadog in Fylamynt

• Navigate to Settings > Integrations > Datadog

• Configure a new integration instance

Details needed to set up Datadog instance in Fylamynt:

Parameter	Description	Required
Datadog API Key	API key for your Datadog instance	True
Datadog Application Key	Application key for your Datadog instance	True
External ID	Identifier that identifies the tenant, to be added into HTTP headers by Datadog	True
Webhook API Key Name	Fylamynt API Key Name	True
Datadog Webhook Name	Fylamynt webhook name to be used by Datadog service	True
Datadog Webhook URL	Fylamynt webhook URL to be used by Datadog service	True

Follow the steps listed below in your Datadog Account and get the desired parameters to enter in Fylamynt. To configure Datadog you will require access to Organization settings with write permission for API Keys and Application Keys.

• Login to your Datadog Account

• Navigate to Organization settings

  • Click on your username in the bottom left corner

  • Select Organization Settings

  • 
• Select Access -> API Keys

• Click + New Key

  • Provide a name for the new API key

  • Click Create Key

  • 
  • Click Copy Key

    • Paste the new API Key into the Datadog API Key field on the Authorize Fylamynt card on the Datadog Integration settings page.

  • Close the window

• Select Access -> Application Keys

• Click + New Key

  • Provide a name for the new Application key

  • Click Create Key

  • 
  • Click Copy Key

    • Paste the new Application Key into the Datadog Application Key field on the Authorize Fylamynt card on the Datadog Integration settings page.

  • Close the window

• Navigate to Integrations -> Integrations

• 
• Go to the Team page

• Search and select for webhooks

• 
• Click + New button to create a new Webhook

• Complete “New Webhook” panel using the following details

  • Copy Datadog Webhook Name from the Authorize Fylamynt card as the Name of the New Webhook

  • Copy Datadog Webhook URL from the Authorize Fylamynt card as the URL of the New Webhook

  • Add "alert_id": "$ALERT_ID" in the JSON object for Payload

    • Optionally, add or remove any other fields

  • Check the Custom Headers box

    • Copy the JSON header information below and paste it into the Custom Header field

    • {
          "x-api-key": "<fylamynt-api-key>",
          "fylamynt-external-id": "<fylamynt-external-id>",
          "Content-Type": "application/json"
      }

    • Replace <fylamynt-api-key>

      • From the Authorize Fylamynt card, choose one of the Webhook API Key Name from the dropdown, and the corresponding Webhook API Key Value should be shown

        • If no options are available for the Webhook API Key Name, first go to Settings --> Resources -> API Keys to create a New API Key

      • Copy the Webhook API Key Value and replace <fylamynt-api-key> in the header.

    • Replace <fylamynt-external-id>

      • From Authorize Fylamynt card, copy the External ID and replace <fylamynt-external-id> in the header

• Click Save to complete Webhook creation

• Click on the Authorize button to complete the integration between Fylamynt and Datadog

Integration Actions

You can add these actions in the Fylamynt workflow builder, as part of your workflow.

1. Datadog Alert Trigger

2. Datadog Get API Test Results

3. Datadog Search Monitors

Datadog Alert Trigger

The integration node triggers the automatic execution of a workflow from a selected Datadog Monitor.

When creating a workflow, you are presented with a wizard to select the trigger type to use.

• On the workflow page, select New Workflow

• Enter the name of the Workflow.

• Select the Datadog trigger type.

• Click Create Workflow

• 

Configure the automatic execution of a workflow

To automatically run workflows with the Datadog Alert trigger, the incident type and assignment need to be configured. Follow the step-by-step instructions provided on the Incident Management - Automatic workflow execution page.

Datadog Get API Test Results

Get the last 50 test results summaries for all Synthetics API tests.

Input

Parameter Name	Description	Required
Start Timestamp	Date-time from which to start querying results	False
End Timestamp	Date-time up to which to query results	False

Output

Parameter Name	Type	Description
result	Object	A list of test result objects in JSON

Action Example

Datadog Search Monitors

Perform a search query and return matching monitors

Input

Parameter Name	Description	Required
Query	The query to be executed. Query documentation: https://docs.datadoghq.com/monitors/manage_monitor/#find-the-monitors	True
Page Index	Page to start paginating from	False
Monitors Per Page	Number of monitors to return per page	False
Sort Order	String for sort order, composed of field and sort order separate by a comma, e.g. name,asc. Supported sort directions: asc, desc. Supported fields: name, status, tags	False

Output

Parameter Name	Type	Description
result	Object	A list of monitors in JSON

Action Example