> 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 Vivo, ensure you have the following

### 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 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

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

{% hint style="info" %}
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)
* [Mange Your Platform Token](https://myaccount.dynatrace.com/platformTokens)
  {% endhint %}

## Configuration

![Dynatrace Connect Dialog](https://987903283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAxUCNi77PcMdZAmajVK6%2Fuploads%2Fgit-blob-064ade6fb491a1c598b8fb47b59518bd13c7019e%2Fdynatrace-connect-dialog.png?alt=media)

To connect Akamas Vivo to Dynatrace:

1. **Provide the required credentials** (see above).
2. **Save** the integration once validated.
3. **Test Connection** to verify the configuration.

## Advanced Options

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 as those imports are paced adaptively against the environment's own rate-limit signals.

#### Legacy Advanced Options

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.