> ## Documentation Index
> Fetch the complete documentation index at: https://airmdr-docs-crowdstrike-skills-catalog.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Datadog 

> Datadog is a cloud-based monitoring, security, and analytics platform that provides real-time visibility into applications, infrastructure, logs, and security metrics. It helps organizations detect issues, optimize performance, and enhance security.

### Pre-requisites

Only users with an **Admin** or **Standard** role can create new keys.

### Generate Datadog API Key and Application Key

<Steps>
  <Step title="Access Datadog">
    1. Login to the [Datadog](https://app.datadoghq.com/) Account.
    2. Provide the necessary credentials (**email** and **password**), and click **Sign In**.

           <img src="https://mintcdn.com/airmdr-docs-crowdstrike-skills-catalog/Ij-YYh2XKJINpB13/images/Datadog8.png?fit=max&auto=format&n=Ij-YYh2XKJINpB13&q=85&s=4923548f564024a49aacc556c5396014" alt="" width="944" height="541" data-path="images/Datadog8.png" />
  </Step>

  <Step title="Navigate to Settings">
    1. After logging in, click on your profile icon (bottom-left corner).
    2. Select **Organization Settings**, click on **API Keys**.

           <img src="https://mintcdn.com/airmdr-docs-crowdstrike-skills-catalog/Ij-YYh2XKJINpB13/images/Datadog.png?fit=max&auto=format&n=Ij-YYh2XKJINpB13&q=85&s=5a1cdb08ca449ef1ebd65d8c20f07397" alt="" width="768" height="412" data-path="images/Datadog.png" />
  </Step>

  <Step title="Create an API Key">
    1. Click on **+ New Key** button.

           <img src="https://mintcdn.com/airmdr-docs-crowdstrike-skills-catalog/Ij-YYh2XKJINpB13/images/Datadog2.png?fit=max&auto=format&n=Ij-YYh2XKJINpB13&q=85&s=135e35e61b16ca2307ebd489e3da3cba" alt="Datadog2 Pn" width="782" height="412" data-path="images/Datadog2.png" />
    2. Enter a **Name** for the New API Key (e.g., `Test-API-Key`).

           <img src="https://mintcdn.com/airmdr-docs-crowdstrike-skills-catalog/Ij-YYh2XKJINpB13/images/Datadog3.png?fit=max&auto=format&n=Ij-YYh2XKJINpB13&q=85&s=e658f40e8d9428adea26ddcdf233962c" alt="" width="782" height="277" data-path="images/Datadog3.png" />
    3. Click **Create Key**.
    4. **Copy** and securely store the generated **API Key** (you won’t be able to see it again).

           <img src="https://mintcdn.com/airmdr-docs-crowdstrike-skills-catalog/Ij-YYh2XKJINpB13/images/Datadog4.png?fit=max&auto=format&n=Ij-YYh2XKJINpB13&q=85&s=3b753b088c2edf974ec6fb78d8893278" alt="" width="779" height="305" data-path="images/Datadog4.png" />

       📌 **Note:** API Keys are used for authentication when sending logs, metrics, and traces to Datadog.
  </Step>

  <Step title="Create an Application Key">
    1. Click on your profile icon (bottom-left corner).
    2. Select **Organization Settings**, click on **Application Keys**.

           <img src="https://mintcdn.com/airmdr-docs-crowdstrike-skills-catalog/Ij-YYh2XKJINpB13/images/Datadog5.png?fit=max&auto=format&n=Ij-YYh2XKJINpB13&q=85&s=bff553131a7e122e7f8f8f604d39d68a" alt="" width="780" height="405" data-path="images/Datadog5.png" />
    3. Click **New Key**.
    4. Enter a name for the Application Key (e.g., `Test-Application-Key`).
    5. Click **Create Key**.

           <img src="https://mintcdn.com/airmdr-docs-crowdstrike-skills-catalog/Ij-YYh2XKJINpB13/images/Datadog6.png?fit=max&auto=format&n=Ij-YYh2XKJINpB13&q=85&s=dff4d64c6b8f4c69ea12314fd452345e" alt="" width="781" height="289" data-path="images/Datadog6.png" />
    6. **Copy** and securely store the **Application Key**.

           <img src="https://mintcdn.com/airmdr-docs-crowdstrike-skills-catalog/Ij-YYh2XKJINpB13/images/Datadog7.png?fit=max&auto=format&n=Ij-YYh2XKJINpB13&q=85&s=7857178ac66e958d3efba3b88cf5c080" alt="" width="780" height="327" data-path="images/Datadog7.png" />

       📌 **Note:** Application Keys are used for **making authenticated API requests** to Datadog (e.g., retrieving logs, dashboards, or managing configurations).

    <Check>
      <Icon icon="envelope" /> Share the **API Key** and **Application Key** securely to AirMDR.\
      (or) \
      Self Configure Datadog API in the AirMDR Integrations Dashboard.
    </Check>
  </Step>
</Steps>

### Skills Provided by this Integration

| Skill ID                     | Purpose                                                                        |
| ---------------------------- | ------------------------------------------------------------------------------ |
| Fetch Signals from Datadog   | Fetches signals that match a specific query in the Datadog dashboard.          |
| Fetch Logs from Datadog      | Fetches logs that match a log search query in datdog dashboard.                |
| Fetch Incidents from Datadog | Fetches incident details that match a specific query in the Datadog dashboard. |

<Tip>
  To view the details of Input Parameters and Output for the respective skills

  * Go to [AirMDR → DataDog](https://app.airmdr.com/integrations?search=datadog) Integration page.
  * Select the **Skills** tab and click on the required listed skills.
</Tip>

### Configure Datadog API in AirMDR Integrations Dashboard

1. Navigate to [AirMDR](https://app.airmdr.com/auth/login), provide the credentials and click **Login**

   <img src="https://mintcdn.com/airmdr-docs-crowdstrike-skills-catalog/Ij-YYh2XKJINpB13/images/Datadog11.png?fit=max&auto=format&n=Ij-YYh2XKJINpB13&q=85&s=385ccc31d26691777e9f8aab897ca7a5" alt="" width="443" height="568" data-path="images/Datadog11.png" />
2. Navigate to the AirMDR Integrations Dashboard in the left navigation pane and select **Integrations.**

   <img src="https://mintcdn.com/airmdr-docs-crowdstrike-skills-catalog/X0ZfAbyNvdA3S7_M/images/AirMDRLeftNavigationPane.png?fit=max&auto=format&n=X0ZfAbyNvdA3S7_M&q=85&s=9f208abc83bd45a53dd20c6263afc599" alt="Air MDR Left Navigation Pane Pn" width="472" height="1086" data-path="images/AirMDRLeftNavigationPane.png" />
3. Use the search option, enter the keyword "**Datadog**", select the **Connections** tab, and click **Add New Connection**.
4. Enter an unique name to the Instance (e.g., `your org name-Datadog`) and brief **Description** to easily identify the user connection by AirMDR.
5. Enter the generated **API Key**, **Application Key** and Expiry (optional) in the Authentication Details field params, and click **Save.**

   <img src="https://mintcdn.com/airmdr-docs-crowdstrike-skills-catalog/Ij-YYh2XKJINpB13/images/Datadog15.png?fit=max&auto=format&n=Ij-YYh2XKJINpB13&q=85&s=5912977ab7d377717663627167fb5ab8" alt="Datadog15 Pn" width="890" height="1480" data-path="images/Datadog15.png" />

### Evaluate Datadog API & Application Keys

Open **cURL** and run the following command to check if your API Key is working:

```

curl -X GET 'https://api.datadoghq.com/api/v2/users?page[size]=1&page[offset]=1' \
-H 'Content-Type: application/json' \
-H 'DD-API-KEY: your_api_key_here' \
-H 'DD-APPLICATION-KEY: your_application_key_here' \
-H 'Accept: application/json'
```

Response

```
{"valid": true}
```
