# Dynatrace

[Dynatrace](https://www.dynatrace.com/) is a software intelligence platform that provides automated observability, AI-powered analytics, and continuous automation for cloud-native environments.

## Requirements

Before connecting Dynatrace to Akamas Insights, ensure you have:

### Required Credentials

* **Endpoint URL**: Your Dynatrace environment URL in the format `https://{your-environment-id}.live.dynatrace.com`
* **API Token**: A Dynatrace API token with all the **Required API Token Permissions** (see below)
* **Grail Bearer Token**: A Dynatrace Grail Bearer Token for DQL with all the **Required Grail Bearer Token Permissions** (see below)

### Required API Token Permissions

Your Dynatrace API token must have the following scopes:

* `metrics.read`: Read metrics from the environment
* `entities.read`: Read monitored entities information

### Required Grail Bearer Token Permissions

* `storage:events:read` 
* `storage:buckets:read` 
* `storage:metrics:read`
* `storage:entities:read`

You can obtain this information from the following references:

* [Dynatrace API Authentication](https://www.dynatrace.com/support/help/dynatrace-api/basics/dynatrace-api-authentication)
* [Dynatrace Access Tokens and Scopes](https://docs.dynatrace.com/docs/ingest-from/setup-on-k8s/deployment/tokens-permissions)
*

## Configuration

![Dynatrace Connect Dialog](/files/vlVhfQHGj2dOwDbwc3Om)

To connect Akamas Insights to Dynatrace:

1. **Endpoint URL**: Enter your Dynatrace environment URL
   * Format: `https://{your-environment-id}.live.dynatrace.com`
2. **API Token**: Provide a Dynatrace API token with the following permissions:
   * Read entities
   * Read metrics
   * Read problems
3. **Test Connection**: Click the test button to verify the configuration
4. **Save**: Once the test succeeds, save the integration

## Data Import Settings

When creating a new import, you can configure advanced settings to optimize data extraction, handle API rate limits, and support large-scale environments. While the default values are suitable for most use cases, you may need to adjust them to fit your specific environment size and API constraints. Available options:

* **Time resolution**: The resolution of the data, going from 5 minutes to 1 day;
* **Import scope**: The scope of data to import. There are 2 options:
  * **Complete**, includes all infrastructure layers;
  * **Infrastructure,** focuses only on cluster and node data.
* **Page Size**: Number of entities retrieved per API request (default: 500). Reduce this value if you encounter API timeouts or memory issues;
* **Entity Limit**: The number of entries to insert in the import;
* **Retries**: Number of retry attempts for failed API requests (default: 3). Increase this value if you experience intermittent connectivity issues;
* **Max Import Time**: Maximum number of days per time chunk when splitting large time ranges (default: 7). Reduce this value if extracting very large datasets to improve reliability;
* **Max Metrics per Request**: Maximum number of metrics to request in a single API call (default: 100). Adjust based on your environment's API performance and response times;
* **Parallelism**: Number of concurrent API requests (default: 10). Increase for faster extraction if your Dynatrace environment can handle higher load, or decrease to reduce API pressure.


---

# 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/dynatrace.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.