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.

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