Extensions limits
- How-to guide
- 5-min read
- Published Jun 16, 2025
This page lists the default limits of the Dynatrace Extensions Framework. These limits ensure optimal performance and resource management, so make sure you're aware of them before you start using extensions.
Extension
Type
Limit
Description
Dashboards
10
The maximum number of dashboards you can define for a single extension.
Alerts
Dynatrace version 1.304+ 100 Dynatrace version 1.303 and earlier 10
The maximum number of alerts for a single extension.
Metrics (total for the extension)
500
The limit of metrics you can define for the entire extension.
Metrics (per level)
100
The limit of metrics you can define for each level (extension, group, subgroup) of declarative extensions.
ZIP package size
25 MB
The limit for a single extension ZIP package.
Configurations handled by ActiveGate or OneAgent
100
The limit of configurations that can be run simultaneously either on ActiveGate or OneAgent. For remote activation, one configuration can be split into buckets, and each bucket is treated as a separate configuration.
Data source type
The number of subgroups each group can contain. For some data sources, adding subgroups is not available.
The number of dimensions can be defined in the extension YAML file for each level (extension, group, subgroup).
Environment
Type
Limit
Description
Extensions
250
You can create up to 100 monitoring configurations per extension (based on a single environment configuration and each of them runs in parallel).
Extension versions
10
Your environment can manage 10 versions of a single extension.
Device monitoring configuration per data source
Remote activation
This feature is automatically enabled for WMI, Prometheus, SNMP, and SQL extensions, while for other types of extensions, its activation depends on the specific extension.
You can define up to 20,000 devices for a single monitoring configuration. Configurations are split into buckets, with a default size of 100 devices per bucket. Each bucket of devices is polled independently as a separate process on one of the ActiveGates in a group.
Remote WMI monitoring is limited to 100 queries, no matter how many devices are in the configuration. If more devices are configured, you may experience performance issues and gaps in monitoring data.
Metric ingestion
| Entity | Limit | Description |
|---|---|---|
| Metric key length, characters | 250 | The total length of the metric key, including the prefix. |
| Dimension key length, characters | 100 | The total length of the dimension key. |
| Dimension value length, characters | 250 | The total length of the dimension value. |
| Number of dimensions per line | 50 | The number of dimensions in a single line of the payload. |
| Total number of possible metric keys per environment | 20,000 | The maximum number of metric keys that can be registered in Dynatrace. |
| Number of tuples per month per metric | 1,000,000 | The maximum number of tuples (unique metric-dimension key-dimension value-payload type combinations) for each metric key for the last 30 days. |
| Number of tuples per month for all custom metrics | 50,000,000 | The maximum number of tuples (unique metric-dimension key-dimension value-payload type combinations) for all custom metrics for the last 30 days. |
| Length of line, characters | 50,000 | The maximum length of a single line of the payload. |
There's also a limit to the number of metrics that Dynatrace can ingest.
Channel
Limit
Per minute per OneAgent instance:
OneAgent version 1.213 and earlier 1,000
OneAgent version 1.215+ 100,000
There's no limit to the metric number, but API throttling applies.
Resource consumption
In the following tables:
- Soft limit: Once this limit is reached, the Extension Execution Controller (EEC) no longer accepts new configuration requests.
- Hard limit: Once reached, the EEC will terminate existing configuration processes until the resource usage becomes lower.
- Per instance: Each data source process represents a single extension activation assigned to a given host or an ActiveGate group.
- Per configuration: Shows the consumption volume for one data source in OneAgent and ActiveGate.
- For all data source processes: Refers to the sum of the resources consumed by the EEC and all data source processes in OneAgent and ActiveGate.
OneAgent
| Performance profile | CPU | RAM | CPU (Soft limit) | RAM (Soft limit) | CPU (Hard limit) | RAM (Hard limit) |
|---|---|---|---|---|---|---|
Per instance | For all data source processes | |||||
Default | 2% | 100 MB | None | None | 5% | 15% |
High limits | 5% | 200 MB | None | None | 15% | 25% |
ActiveGate
| Performance profile | CPU | RAM | CPU (Soft limit) | RAM (Soft limit) | CPU (Hard limit) | RAM (Hard limit) |
|---|---|---|---|---|---|---|
Per configuration | For all data source processes | |||||
Default | 5% | 500 MB | 10% | 20% | 20% | 30% |
High limits | 15% | 700 MB | 45% | 30% | 60% | 40% |
30% | 1500 MB | 70% | 50% | 85% | 70% | |
Generic types and relationship
Managing multiple extensions in Dynatrace can lead to encountering limits related to generic types and relationship settings. To prevent these potential issues, see the table below.
| Value count limits | Default value | Soft limit | Hard limit |
|---|---|---|---|
| 100 | 500 | 500 |
| 100 | None | 500 |
Extensions