# Datadog

## Overview

Use the Datadog integration to identify problems with your users and licenses before they occur. Integrating with Datadog enables you to build boards that correlate fields within Datadog and with other connected tools. You can also run actions on fetched data without ever leaving Stitchflow.

#### Generating API key

1. Navigate to [**API Keys**](https://app.datadoghq.com/organization-settings/api-keys)
2. Click the **+ New Key** button.
3. Stitchflow suggests adding the following name for the Key:

   ```
   Stitchflow API Key 
   ```
4. Click the **Create Key** button.
5. Click the **Copy Key** button. The Key's value will not be shown again.
6. Paste the Key into API Key input. Do not copy or paste the Key ID.

#### Generating Application key

1. Navigate to [**Application Keys**](https://app.datadoghq.com/access/application-keys)
2. Click the **+ New Key** button.
3. Stitchflow suggests adding the following name for the Key:

   ```
   Stitchflow Application Key
   ```
4. Click the **Create Key** button.
5. Click the **Copy Key** button. The Key's value will not be shown again.
6. Paste the Key into Application Key input. Do not copy or paste the Key ID.

## Configure

Enable the Datadog integration from `Connections` in the left sidenav. Click `Connect` and enter your API key and application key. Before connecting, Datadog will sync for a few minutes while fetching data. Once connected, you can click the `...` menu on the Datadog integration tile to manage or disconnect the integration. 

### Manage permissions

Datadog actions allow you to run operations on fetched data without ever leaving Stitchflow. All actions are enabled by default and will be accessible on every board, but can be disabled by clicking the `...` menu and selecting `Remove connection`.

{% hint style="info" %}
Please note that disconnecting Datadog will also permanently delete any boards in which it is used.
{% endhint %}

## Data model

We automatically fetch and relate the following objects from Datadog resources.

<details>

<summary>Supported objects</summary>

* Users
* Roles
* Organizations

</details>

We support the following actions in Datadog.

<details>

<summary>Supported actions</summary>

* Delete role&#x20;
* Grant permission to role&#x20;
* Revoke permission&#x20;
* Add user to a role&#x20;
* Remove user from role&#x20;
* Create user Disable user

</details>

## Boards

When building a board, you can select any supported Datadog resource as your object to indicate the data you want to surface on your board. We automatically determine the primary field for each object. The primary field is meant to be a unique representation of each record in a board.&#x20;

{% hint style="info" %}
An object in Stitchflow is a data type that is used to treat several different pieces of data as one unit.
{% endhint %}

### Adding fields

Click `Add field` to select fields from both within Datadog and across your other connected tools. We only show fields that can be joined with your chosen object.&#x20;

### Triggering actions

Click `Integration actions` in the top right of any board to view all available actions across your connected integrations. When selecting an action, you'll be prompted to fill out all required inputs necessary to run the action. Changes and updates made via actions will persist to all boards.

{% hint style="info" %}
Stitchflow fetches Datadog data every 24 hours.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.stitchflow.io/documentation/integrations/datadog.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.