# Datadog

This guide walks through adding Datadog as a provider in DuploCloud, configuring credentials, creating a scope, and querying Datadog data through the AI agent.

***

## Step 1 — Navigate to the Observability Providers

Go to **AI Admin** → **Providers** → **IT**, then click the **Observability** tab. This lists all observability providers connected to your account.

![Observability providers list](/files/0NeMR11y1fvzOGuJ91vT)

***

## Step 2 — Add a New Provider

Click **+ Add**. Fill in the provider details:

* **Name** — a name to identify this provider
* **Type** — select the provider type (e.g. Trending)
* **Account ID** — a label to identify this account within DuploCloud

![Add Provider form](/files/iJau2QKISKBOUNJUD8dL)

Click **Create Provider**.

***

## Step 3 — Add Credentials

The new provider opens on the **Credentials** tab. Click **+ Add** to add a credential. Fill in the credential fields:

* **api\_key** — your Datadog API key
* **application\_key** — your Datadog application key
* **url** — your Datadog site URL (e.g. `api.datadoghq.com`)

> **Where to find these values:** Both the API key and Application key must be created directly in Datadog under **Organization Settings → API Keys** and **Application Keys**. The site URL can be copied from your browser's address bar when logged into Datadog — use the base domain (e.g. `api.datadoghq.com` for US, `api.datadoghq.eu` for EU).

![New provider with Credentials tab](/files/anLzhN8ud9v8rB507cGL)

![Add Credential form](/files/cxgeva8SB7jg2eBo21GH)

Enter your Datadog site URL in the **url** field.

![Entering the site URL](/files/Xluj8DgDIJ3jFq8no34i)

Toggle **Sensitive** on for fields containing secrets to ensure they are stored securely.

![Marking fields as sensitive](/files/n1UeESOdP1O5CzUX6hbl)

Click **Create** to save the credential.

***

## Step 4 — Add a Scope

Switch to the **Scope** tab and click **+ Add**. Fill in:

* **Name** — a label for this scope
* **Credential** — select the credential you just created
* **Description** — optional context for the agent

![Add Scope form](/files/LNJqauLpkCja8M1yIbMd)

Click **Create**. The scope appears in the list.

![Scope created](/files/rmiw3iMdMUFYN6AIPfcc)

***

## Step 5 — Use Datadog in a Ticket

Go to **AI DevOps** → **HelpDesk** → **Add Ticket**. Select **generic-agent** as the agent and choose your Datadog scope from the scope dropdown.

![Ticket with Datadog scope selected](/files/q0Mgo2SirRz09MpNc2BE)

Enter your request — for example, asking the agent to check alerts or synthetic monitors for a domain.

![Ticket prompt entered](/files/1djoniba0wdjFlMxYjRS)

Click **Create Ticket**.

***

## Step 6 — Agent Queries Datadog

The agent processes the request, connects to Datadog using the scope credentials, and returns the results.

![Agent processing the Datadog request](/files/lAp2Gr6Bz36O7bgUCzfJ)

The response includes the relevant Datadog data — alert states, synthetic test results, monitor details, and a plain-language summary.

![Datadog results returned](/files/qRKuMMq1dhJZQweDSp2j)


---

# 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.duplocloud.com/docs/getting-started/integrating-providers/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.