Monitoring configuration fields

• Latest Dynatrace
• Reference
• 4-min read
• Published Jul 10, 2026

If you want to modify a monitoring configuration via the REST API, use this reference to identify which fields you can safely update. Fields are either supported for modification or NOT supported for modification.

Supported (user-modifiable) fields

value.enabled

Type: boolean

Enables or disables given AWS connection.

"enabled": true

value.description

Type: string

The display name of the connection as it appears in Settings.

"description": "my-aws-connection"

value.featureSets

Type: array of strings

Defines which AWS services are enabled for CloudWatch metric collection, the _essential corresponds to the Recommended metric collection sets (MCS), the _autodiscovery corresponds to the auto-discovery metric collection sets (MCS).

"featureSets": [
  "ApplicationELB_essential",
  "EC2_essential",
  "Lambda_essential",
  "Bedrock_AgentAlias_autodiscovery"
]

aws.regionFiltering

Type: array of strings

Restricts CloudWatch metric polling and topology polling to specific AWS regions. Accepts standard (supported) AWS region identifiers.

"regionFiltering": ["us-east-1", "us-east-2"]

aws.tagFiltering

Type: array

Filters monitored resources by AWS resource tags. Leave empty to monitor all resources regardless of tags.

"tagFiltering": [
  {
    "key": "env",
    "value": "prod",
    "condition": "INCLUDE"
  },
  {
    "key": "appid",
    "value": "105",
    "condition": "INCLUDE"
  }
]

aws.tagEnrichment

Type: array of strings

Specifies which AWS resource tag keys should be ingested and enrich topology linked signals (metrics, logs, topology events).

"tagEnrichment": ["appid", "group", "center"]

aws.metricsConfiguration.enabled

Type: boolean

Enables or disables AWS CloudWatch metrics collection.

"metricsConfiguration": {
  "enabled": true
}

aws.metricsConfiguration.regions

Type: array of strings

Future compatibility field. Regions set here must be identical to the ones set at aws.regionFiltering.

"metricsConfiguration": {
  "regions": ["us-east-1", "us-east-2"]
}

aws.namespaces

Type: array

Advanced metric collection use-cases, see Advanced metric ingest use cases for more details.

"namespaces": [
  {
    "namespace": "AWS/EBS",
    "autoDiscoveryEnabled": false,
    "metrics": [
      {
        "name": "FastSnapshotRestoreCreditsBalance",
        "unit": "Count",
        "dimensions": [
          "SnapshotId",
          "AvailabilityZone"
        ],
        "aggregations": [
          "Average",
          "Minimum"
        ],
        "type": "CUSTOM_AWS"
      }
    ]
  },
  {
    "namespace": "myapp/frontend",
    "autoDiscoveryEnabled": false,
    "metrics": [
      {
        "name": "ReqPerSeq",
        "unit": "Count",
        "dimensions": [
          "appID"
        ],
        "aggregations": [
          "Maximum"
        ],
        "type": "CUSTOM"
      }
    ]
  },
  {
    "namespace": "AWS/DynamoDB",
    "autoDiscoveryEnabled": false,
    "metrics": [
      {
        "name": "TimeToLiveDeletedItemCount",
        "unit": "Count",
        "dimensions": [
          "Operation",
          "TableName"
        ],
        "aggregations": [
          "SampleCount",
          "Sum"
        ],
        "type": "ESSENTIAL_PLUS"
      }
    ]
  }
]

Read-only (system-managed) or non-supported modification fields

The following fields are set and managed by the system. Do not modify them manually—changes will be ignored or may cause errors.