> For the complete documentation index, see [llms.txt](https://docs.akamas.io/insights/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.akamas.io/insights/connecting-your-data/datasources/dynatrace.md).

# 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)
* **Platform Token**: A Dynatrace Platform token (prefix `dt0s16`) for Grail/DQL with all the **Required Platform Token Permissions** (see below). This must be a Platform token, not an API or OAuth token.

### 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 Platform 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)
* [Dynatrace Platform tokens](https://docs.dynatrace.com/docs/manage/identity-access-management/access-tokens-and-oauth-clients/platform-tokens)

## Configuration

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

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.

The following options apply to every Dynatrace import:

* **Data granularity**: 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.

When your imports run through the managed extraction pipeline, and only when the integration points at a self-hosted Dynatrace environment (Dynatrace Managed or on-premises), one additional tuning option is available:

* **Concurrency**: Maximum number of concurrent queries the import sends to your Dynatrace environment (default: 10; selectable values: 5, 10, then 20 to 50 in steps of 10). Raise it for a faster import if your environment can absorb the extra query load, or lower it to protect a small or shared installation; values above 10 show a warning because elevated concurrency puts significant query load on the environment and may degrade it while the import runs. Integrations pointing at a Dynatrace-hosted (SaaS) environment do not show this option — those imports are paced adaptively against the environment's own rate-limit signals.

Imports running through the legacy pipeline expose the following options instead. Note that the legacy **Parallelism** option below is a separate setting from the managed **Concurrency** option above, even though both default to 10:

* **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.