Pliant

Pliant

Crawler Crawler

Linux Mac OS Windows OS Supported

Overview

Pliant.io enhances Datadog notifications with low-code automated workflows, creating a true close-loop-automation solution. This can help with troubleshooting, diagnosis and automated remediation.

For more integration information, check out the Pliant site.

Examples include:

  • Service restart
  • Load balancer configuration
  • System provisioning
  • Clear disk / reprovision storage
  • Provision additional VMs or container nodes in response to load
  • De-commission resources when load is low

Setup

Installation

Create one or more workflows that you would like to trigger from a Datadog notification.

Configuration

Pliant

  1. Create a Pliant API key - Log in to Pliant and click on your username at the top right of the screen to reveal a menu. Click “API Keys”.

API Key Menu step1

  1. From the API keys screen, click “+ Create” at the top right of the screen and title your new API key. Click save and note the the API key will be added to the table.

Create API Key step2

Create a Pliant workflow to trigger from Datadog

  1. Navigate to the workflows tab in Pliant. Click “+ Create” and “Create Flow” to create a new workflow. Title the workflow in the popup and click “Create” to launch the editor into our new workflow.

Create Flow step1-a-

  1. Populate the workflow with actions to take upon receiving the Datadog trigger.

This example workflow is called “RestartHost” and restarts a host from the data Datadog triggers this workflow with.

This workflow will run with its input variables initially assigned based on the request body we trigger it with. The workflow can trigger/perform any desired infrastructure automation actions, using information from its input. In this example, restart a host via SSH under certain circumstances when Datadog triggers our automation workflow with certain parameters.

  • To add Input variables which populate with data sent from Datadog, click the “Expand” icon on at the start of the workflow to open the Variable panel. To create matching Input variables, set all of these input variables to equal empty quotes: "". By default, Datadog sends the following data: body last_updated event_type title date org id

There are also have additional output variables (host, meta, and ip) that are initialized. The workflow will assign these output variables and output the resulting values upon completion. It may also specify variables which are neither input nor output variables to use internally within the workflow’s logic.

Expand

  1. To get the endpoint of the Pliant workflow, used to trigger from Datadog with an HTTP request, click the “Expand” icon at the start of the workflow.

Click “cURL” > “Temporary Bearer Token” and select the API key you just created.

curl

select key

Your endpoint is enclosed in double quotes and resembles: https://<YOUR_PLIANT_INSTANCE>/api/v1/trigger/<YOUR_PLIANT_USERNAME>/User/<PATH_TO_WORKFLOW>/<WORKFLOW_NOW>?sync=true&api_key=<YOUR_API_KEY>

endpoint

Copy the entire URL enclosed in the double quotes (which may include additional querry parameters), starting with https. Do not include the double quotes.

Datadog setup

  1. Open Datadog and from the left sidebar, click to Integrations > Integrations. integrations

  2. Enter “webhooks” in the search bar and click on the webhooks entry to reveal a configuration window. webhookSearch

  3. Scroll to “webhooks”. Click New to add a new webhook to link to the Pliant workflow. First, give the webhook a name in the “name” field. This example uses the name RestartHost. webhooksConfig2

Now, paste the URL copied from step 4. For example:

https://<YOUR_PLIANT_INSTANCE>/api/v1/trigger/<YOUR_PLIANT_USERNAME>/User/<PATH_TO_WORKFLOW>/<WORKFLOW_NOW>?sync=true&api_key=<YOUR_API_KEY>

Paste this into the URL field of the webhook form.

webhookForm

The request payload is pre-configured. Check the “ENCODE AS FORM” box and click save.

Add this integration to any alert notification in Datadog by adding the recipient of @webhook-RestartHost. When the monitor triggers an alert, the webhook triggers your Pliant workflow, and the input variables are sent to Pliant from Datadog.

Data Collected

Metrics

The Pliant integration does not provide metrics.

Service Checks

The Pliant integration does not include any service checks.

Events

The Pliant integration does not include any events.

Troubleshooting

Need help? Contact Datadog support.