> For the complete documentation index, see [llms.txt](https://docs.dropzone.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dropzone.ai/integrations/data/datadog_data.md).

# Datadog

{% hint style="info" %}
Datadog is an SIEM integration. SIEM integrations are used to perform analysis of any SIEM generated alerts, and/or to use generated data as part of investigation analysis.
{% endhint %}

Dropzone AI integrates with the [Datadog](https://www.datadoghq.com/) security SIEM. Many customers ingest other alert sources into DataDog (e.g. IDPs) and integrate Dropzone into DataDog rather than the source systems.

## Integration Overview

To enable this integration you will perform the following actions:

* Create an API Key
* Create an Application Key
* Enable the Data source in your Dropzone tenant

## Create an API Key

To obtain an API Key, do the following:

* In the bottom left hand corner of your Datadog Dashboard, click on your organization icon
* Navigate to Organization Settings > API Keys

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FqbfOzS7c9efh7AicXzVx%2Fdatadog-integration-1.png?alt=media" alt=""><figcaption><p>Navigate to API Keys</p></figcaption></figure>

* Click "New Key"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FNNkrPxCJPmuWhn3gpIjj%2Fdatadog-integration-2.png?alt=media" alt=""><figcaption><p>Click "New Key"</p></figcaption></figure>

* Name your token something memorable, such as "dropzone.ai," then click "Create Key"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FTKEt7JjaD9nKkSeSmKyl%2Fdatadog-integration-3.png?alt=media" alt=""><figcaption><p>Create Key</p></figcaption></figure>

* Copy the key generated for use later in the Dropzone UI where it is called "API Key," then click "Finish"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FVVNux72RRI0bDWJnBiCD%2Fdatadog-integration-4.png?alt=media" alt=""><figcaption><p>Copy the key</p></figcaption></figure>

## Create an Application Key

To obtain an Application Key, do the following:

* In the bottom left hand corner of your Datadog Dashboard, click on your organization icon
* Navigate to Organization Settings > Application Keys

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FqbfOzS7c9efh7AicXzVx%2Fdatadog-integration-1.png?alt=media" alt=""><figcaption><p>Navigate to Application Keys</p></figcaption></figure>

* Click "New Key"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FNNkrPxCJPmuWhn3gpIjj%2Fdatadog-integration-2.png?alt=media" alt=""><figcaption><p>Click "New Key"</p></figcaption></figure>

* Name the key something memorable, such as "dropzone.ai," then click "Create Key"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FTKEt7JjaD9nKkSeSmKyl%2Fdatadog-integration-3.png?alt=media" alt=""><figcaption><p>Create Key</p></figcaption></figure>

* In the "Scope" section, select "Edit"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FZSMsG8nVzFanF22XSHsB%2Fdatadog-integration-5.png?alt=media" alt=""><figcaption><p>Edit Scopes</p></figcaption></figure>

* Assign the key the following scopes, then click "Save":
  * logs\_read\_data
  * security\_monitoring\_signals\_read

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FJkX7qnSOYgmzdZ0z3ciZ%2Fdatadog-integration-6.png?alt=media" alt=""><figcaption><p>Assign scopes</p></figcaption></figure>

* Copy the key generated for use later in the Dropzone UI where it is called "Application Key," then click "Finish"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2Fie0AkiFucOVTL61FHYjH%2Fdatadog-integration-7.png?alt=media" alt=""><figcaption><p>Copy the key</p></figcaption></figure>

## Enable Datadog

To enable the Data Source integration, you will need the following information:

| Dropzone Field  | Source                                                                      |
| --------------- | --------------------------------------------------------------------------- |
| API Key         | The API key value you generated earlier                                     |
| Application Key | The Application key value you generated earlier                             |
| Datadog site    | The same as your url in Datadog, e.g. datadoghq.com, us3.datadoghq.com, etc |

* Navigate to your Dropzone AI tenant home page e.g. https\://*mycompany*.dropzone.app
* In the left side bar, navigate to Platform Settings > Integrations

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FQKQGU2YK0KqsewZWvh0i%2Fui-integrations-dropdown.png?alt=media" alt=""><figcaption><p>Integrations Dropdown</p></figcaption></figure>

* Click "Library"

{% hint style="info" %}
If you have previously integrated this application, click "Configured"
{% endhint %}

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2Fx4O3FuRG5IqPwx5sFuHr%2Fapp_system_integrations_library.png?alt=media" alt=""><figcaption><p>Click Library</p></figcaption></figure>

* In the Search bar, search Datadog, then click "Configure"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FAgqpUwCXfG4jM0uJ8oY8%2Fapp_system_integrations_available_datadog.png?alt=media" alt=""><figcaption><p>The Datadog Tile</p></figcaption></figure>

* Under the Data Source heading, input the API Key, Application Key, and your Datadog site
* If you wish to enable Datadog's [Flex Logs](https://docs.datadoghq.com/logs/log_configuration/flex_logs/), check the box labeled "Enabled" in the Flex Logs section

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FJPGOMnVMwjHU2VKptboT%2Fapp_system_integrations_available_datadog_data_config.png?alt=media" alt=""><figcaption><p>The Datadog Data Source Configuration (pt 1)</p></figcaption></figure>

* If you wish to help guide the AI's information gathering process, enable the [Query Guidance](https://docs.dropzone.ai/integrations/data) feature. Click "Add Item" and input your Condition and Instruction pairs

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FcYfD24VJsFX1ZjoP5UDb%2Fintegration-query-guidance.png?alt=media" alt=""><figcaption><p>The Datadog Data Source Configuration (pt 2)</p></figcaption></figure>

* Click "Test & Save" to finish

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FzlXvpTSeEcWS1gYQgTan%2Fui-test-and-save.png?alt=media" alt=""><figcaption></figcaption></figure>

If you have any errors contact our Customer Success team.
