ÃÛ¶¹ÊÓƵ

DocumentationWorkfrontWorkfront Guide

Datadog modules

Last update: Thu Nov 21 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • User

In an ÃÛ¶¹ÊÓƵ Workfront Fusion scenario, you can automate workflows that use Datadog, as well as connect it to multiple third-party applications and services.

If you need instructions on creating a scenario, see Create a scenario in ÃÛ¶¹ÊÓƵ Workfront Fusion.

For information about modules, see Modules in ÃÛ¶¹ÊÓƵ Workfront Fusion.

Access requirements

You must have the following access to use the functionality in this article:

ÃÛ¶¹ÊÓƵ Workfront plan*
Pro or higher
ÃÛ¶¹ÊÓƵ Workfront license*
Plan, Work
ÃÛ¶¹ÊÓƵ Workfront Fusion license**

Current license requirement: No Workfront Fusion license requirement.

Or

Legacy license requirement: Workfront Fusion for Work Automation and Integration

Product

Current product requirement: If you have the Select or Prime ÃÛ¶¹ÊÓƵ Workfront plan, your organization must purchase ÃÛ¶¹ÊÓƵ Workfront Fusion as well as ÃÛ¶¹ÊÓƵ Workfront to use functionality described in this article. Workfront Fusion is included in the Ultimate Workfront plan.

Or

Legacy product requirement: Your organization must purchase ÃÛ¶¹ÊÓƵ Workfront Fusion as well as ÃÛ¶¹ÊÓƵ Workfront to use functionality described in this article.

To find out what plan, license type, or access you have, contact your Workfront administrator.

For information on ÃÛ¶¹ÊÓƵ Workfront Fusion licenses, see ÃÛ¶¹ÊÓƵ Workfront Fusion licenses.

Prerequisites

To use Datadog modules, you must have a Datadog account.

Datadog API information

The Datadog connector uses the following:

API tag
1.0.11

Connect Datadog to Workfront Fusion connect-datadog-to-workfront-fusion

Retrieve your API key and application key retrieve-your-api-key-and-application-key

To connect your Datadog account to Workfront Fusion you need to retrieve an API Key and an application key from your Datadog account.

  1. Log in to your Datadog account.
  2. In the left navigation panel, click Integrations, then click APIs.
  3. On the main screen, click API Keys.
  4. Hover over the purple bar to reveal the API key.
  5. Copy the API key to a secure location.
  6. On the main screen, click Application Keys.
  7. Hover over the purple bar to reveal the application key.
  8. Copy the application key to a secure location.

Create a connection to Datadog in Workfront Fusion

You can create a connection to your Datadog account directly from inside a Datadog module.

  1. In any Datadog module, click Add next to the Connection field.
  2. Fill the module’s fields as follows:
Connection Type
Select the Datadog Application option to get full access to Datadog API.
Connection Name
Enter a name for the connection.
Domain
Select the domain you want to connect to (US or EU).
API Key

Enter your Datadog API key.

For instructions on retrieving the API key, see Retrieve your API key and application key in this article.

Application Key

Enter your Datadog application key.

For instructions on retrieving the application key, see Retrieve your API key and application key in this article.

  1. Click Continue to create the connection and go back to the module.

Datadog modules and their fields

When you configure Datadog modules, Workfront Fusion displays the fields listed below. Along with these, additional Datadog fields might display, depending on factors such as your access level in the app or service. A bolded title in a module indicates a required field.

If you see the map button above a field or function, you can use it to set variables and functions for that field. For more information, see Map information from one module to another in ÃÛ¶¹ÊÓƵ Workfront Fusion.

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
For instructions about connecting your Datadog account to Workfront Fusion, see Connect Datadog to Workfront Fusion in this article.
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.

    This is a JSON array of points. Each point has the format: [[POSIX_timestamp, numeric_value], ...]

    Note:

    The timestamp must be in seconds.

    The timestamp must be current. Current is defined as not more than 10 minutes in the future or more than 1 hour in the past.

    The numeric value format should be a float value.

    This field must contain at least 1 item.

  • Host

    Enter the name of the host that produced the metric.

Make an API Call

This action module allows you to perform a custom API call.

Connection
For instructions about connecting your Datadog account to Workfront Fusion, see Connect Datadog to Workfront Fusion in this article.
URL
Enter a path relative to https://api.datadoghq.com/api/. Example: /v1/org.
Method
Select the HTTP request method you need to configure the API call. For more information, see HTTP request methods in ÃÛ¶¹ÊÓƵ Workfront Fusion.
Headers

Add the headers of the request in the form of a standard JSON object.

For example, {"Content-type":"application/json"}

Workfront Fusion adds the authorization headers for you.

Query String

Add the query for the API call in the form of a standard JSON object.

For example: {"name":"something-urgent"}

Body

Add the body content for the API call in the form of a standard JSON object.

Note:

When using conditional statements such as if in your JSON, put the quotation marks outside of the conditional statement.

Example: 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:

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43