# Datadog

[Datadog](https://www.datadoghq.com/) is a cloud-based monitoring and analytics platform that provides comprehensive observability for cloud-scale applications.

## Requirements

Before connecting Datadog to Akamas Insights, ensure you have:

### Required Credentials

* **Site**: Your Datadog [site region](https://docs.datadoghq.com/getting_started/site/) (e.g.US1, EU1)
* **API Key**: A Datadog API key for authentication
* **Application Key**: A Datadog application key for API access
  * The Application Key requires the following scopes: **timeseries\_query**, **metrics\_read** and **hosts\_read**

{% hint style="info" %}
You can obtain this information from the following references:

* [Datadog API Authentication](https://docs.datadoghq.com/api/latest/authentication/)
* [Datadog API and Application Keys](https://docs.datadoghq.com/account_management/api-app-keys/)
  {% endhint %}

## Configuration

![Datadog Edit Dialog](/files/Vz315ZcElNmeUww1K74W)

To connect Akamas Insights to Datadog:

1. **Site**: Select your Datadog [site region](https://docs.datadoghq.com/getting_started/site/);
2. **API Key**: Enter your Datadog API key;
3. **App Key**: Enter your Datadog application key;
4. **Save**: Save the integration once validated;
5. **Test Connection**: Verify the configuration.

## Data Import Settings

These advanced settings allow you to tune the data extraction process for Datadog to optimize performance and handle API rate limiting. In most cases, the default values work well, but you can adjust them based on your specific requirements.

* **Time Chunks**: Number of time periods to split the import window into (default: Automatic). Higher values reduce the data load per API response, but making more calls may trigger API rate limits. When set to "Automatic", chunks are dynamically calculated based on environment size (number of entities and data points)
* **Retries**: Number of retry attempts for failed API requests (default: 3). Increase this value if you experience intermittent connectivity issues.


---

# 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.akamas.io/insights/connecting-your-data/datasources/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.