Table of Contents

Datadog

Active with remarks
This application needs additional settings. Please follow the documentation below to create your own connection.

Datadog

The Datadog modules enable you to post time-series data that can be graphed on Datadog’s dashboards or make a custom API call.

Getting Started with Datadog

Prerequisites

A Datadog account

In order to use Datadog with Boost.space Integrator, it is necessary to have a Datadog account. If you do not have one, you can create a Datadog account at www.datadoghq.com.

	Note
	The module dialog fields that are displayed in bold (in the Boost.space Integrator scenario, not in this documentation article) are mandatory!

Connect Datadog to Boost.space Integrator

To connect your Datadog account to Boost.space Integrator you need to retrieve an API Key from your Datadog account.

Log in to your Datadog account.
In the menu on the left, open Integrations > APIs.
Click the API Keys option and then copy the provided API Key (point the mouse over the rectangle in the Key column to unhide your API Key).
Repeat the same for the Application Keys option to retrieve the Application Key.

Go to Boost.space Integrator and open the Datadog module’s Create a connection dialog.

Fill the module’s fields as follows:

Connection Type	Select the Datadog Application option to get full access to Datadog API.
Connection Name	Enter the desired name for the connection.
Domain	Select your domain (US site or EU site).
API Key	Enter the API Key you have copied in step 3 (above).
Application Key	Enter the Application Key you have copied in step 4 (above).

To the respective field and click the Continue button to establish the connection.

The connection has been established. You can proceed with setting up the module.

Actions

Post Timeseries Points

The module allows you to post time-series data that can be graphed on Datadog’s dashboards. The limit for compressed payloads is 3.2 megabytes (3200000), and 62 megabytes (62914560) for decompressed payloads.

Connection

Establish a connection to your Datadog account.

Series

Add time series you want to submit to Datadog.

Metric	Enter the name of the timeseries.
Type	Select the type of the metric.
Interval	If the type of the metric is rate or count, define the corresponding interval.
Points	Add points relating to a metric. A JSON array of points. Each point is of the form: `[[POSIX_timestamp, numeric_value], ...]` Note: The timestamp should be in seconds, current. The numeric value format should be a float value. Current is defined as not more than 10 minutes in the future or more than 1 hour in the past. Must contain at least 1 item(s).
Host	Enter the name of the host that produced the metric.

Make an API Call

Allows you to perform a custom API call.

Connection

Establish a connection to your Datadog account.

URL

Enter a path relative to https://api.datadoghq.com/api/. For example: /v1/org.

	Note
	For the list of available endpoints, refer to the Datadog API Documentation.

Method

Select the HTTP method you want to use:

GET

to retrieve information for an entry.

POST

to create a new entry.

PUT

to update/replace an existing entry.

PATCH

to make a partial entry update.

DELETE

to delete an entry.

Headers

Enter the desired request headers. You don’t have to add authorization headers; we already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

Example of Use – List Dashboards

The following API call returns the all dashboards in your Datadog account:

URL:

/v1/dashboard

Method:

GET

The result can be found in the module’s Output under Bundle > Body > dashboards.

In our example, 3 dashboards were returned: