Settings API - Problem alerting profiles schema table

Problem alerting profiles (builtin:alerting.profile)

Alerting profiles enable you to set up fine-grained alert-filtering rules that are based on the severity, customer impact, associated tags, and/or duration of detected problems. Alerting profiles enable you to control exactly which conditions result in problem notifications and which don't. This includes all problem-push notifications that are sent via the Dynatrace mobile app and displayed in the Dynatrace web UI. Alerting profiles can also be used to set up filtered problem-notification integrations with 3rd party messaging systems like Slack, VictorOps, and PagerDuty.

Schema ID
Schema groups
Scope
builtin:alerting.profile
  • group:alerting
environment
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:alerting.profile
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:alerting.profile
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:alerting.profile

Authentication

To execute this request, you need an access token with Read settings (settings.read) scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

Property
Type
Description
Required
Name
name
text
-
required
Management zone
managementZone
setting

Entities which are part of the configured management zones will match this alerting profile. It is recommended to use manual tags instead.

Note: Management zones may experience delays or inconsistencies due to rule complexity and attribute variability. Entities may not be immediately assigned to management zones, impacting filter effectiveness.

It is recommended to use manual tags instead.

For more information, visit our best practices for management zones documentation page.

optional
Severity rules
severityRules

Define severity rules for profile. A maximum of 100 severity rules is allowed.

required
Event filters
eventFilters

Define event filters for profile. A maximum of 100 event filters is allowed.

required
The AlertingProfileSeverityRule object
Property
Type
Description
Required
Problem severity level
severityLevel
enum
  • AVAILABILITY
  • CUSTOM_ALERT
  • ERRORS
  • MONITORING_UNAVAILABLE
  • PERFORMANCE
  • RESOURCE_CONTENTION
required
Problem send delay in minutes
delayInMinutes
integer

Send a notification if a problem remains open longer than X minutes.

required
Filter problems by tag
tagFilterIncludeMode
enum
  • NONE
  • INCLUDE_ANY
  • INCLUDE_ALL
required
Tags
tagFilter
set

Entities which contain any/all of the configured tags will match this alerting profile. It is recommended to use manual tags.

Note: Automatically applied tags may experience delays or inconsistencies due to rule complexity and attribute variability. Entities may not be immediately tagged, impacting filter effectiveness.

It is recommended to use manual tags instead.

For more information, visit our best practices for tagging documentation page.

required
The AlertingProfileEventFilter object
Property
Type
Description
Required
Filter problems by any event of source
type
enum
  • PREDEFINED
  • CUSTOM
required
predefinedFilter
-
required
customFilter
-
required
The PredefinedEventFilter object
Property
Type
Description
Required
Filter problems by a Dynatrace event type
eventType
enum
  • EC2_HIGH_CPU
  • OSI_HIGH_CPU
  • ELB_HIGH_BACKEND_ERROR_RATE
  • PROCESS_NA_HIGH_CONN_FAIL_RATE
  • CUSTOM_APP_CRASH_RATE_INCREASED
  • CUSTOM_APPLICATION_ERROR_RATE_INCREASED
  • CUSTOM_APPLICATION_SLOWDOWN
  • CUSTOM_APPLICATION_UNEXPECTED_LOW_LOAD
  • CUSTOM_APPLICATION_UNEXPECTED_HIGH_LOAD
  • ESXI_GUEST_CPU_LIMIT_REACHED
  • ESXI_GUEST_ACTIVE_SWAP_WAIT
  • ESXI_HOST_CPU_SATURATION
  • ESXI_HOST_MEMORY_SATURATION
  • ESXI_VM_IMPACT_HOST_CPU_SATURATION
  • ESXI_VM_IMPACT_HOST_MEMORY_SATURATION
  • ESXI_HOST_NETWORK_PROBLEMS
  • ESXI_HOST_DISK_SLOW
  • EBS_VOLUME_HIGH_LATENCY
  • DATABASE_CONNECTION_FAILURE
  • SERVICE_ERROR_RATE_INCREASED
  • RDS_HIGH_LATENCY
  • OSI_NIC_UTILIZATION_HIGH
  • OSI_NIC_ERRORS_HIGH
  • OSI_NIC_DROPPED_PACKETS_HIGH
  • OSI_GRACEFULLY_SHUTDOWN
  • OSI_UNEXPECTEDLY_UNAVAILABLE
  • HOST_OF_SERVICE_UNAVAILABLE
  • ESXI_HOST_DISK_QUEUE_SLOW
  • APPLICATION_ERROR_RATE_INCREASED
  • AWS_LAMBDA_HIGH_ERROR_RATE
  • PROCESS_HIGH_GC_ACTIVITY
  • ESXI_HOST_DATASTORE_LOW_DISK_SPACE
  • OSI_LOW_DISK_SPACE
  • OSI_DISK_LOW_INODES
  • RDS_LOW_STORAGE_SPACE
  • PROCESS_MEMORY_RESOURCE_EXHAUSTED
  • OSI_HIGH_MEMORY
  • MOBILE_APP_CRASH_RATE_INCREASED
  • MOBILE_APPLICATION_ERROR_RATE_INCREASED
  • MOBILE_APPLICATION_SLOWDOWN
  • MOBILE_APPLICATION_UNEXPECTED_LOW_LOAD
  • MOBILE_APPLICATION_UNEXPECTED_HIGH_LOAD
  • MONITORING_UNAVAILABLE
  • PROCESS_NA_HIGH_LOSS_RATE
  • ESXI_HOST_OVERLOADED_STORAGE
  • PROCESS_CRASHED
  • PG_LOW_INSTANCE_COUNT
  • PGI_UNAVAILABLE
  • RDS_HIGH_CPU
  • RDS_LOW_MEMORY
  • RDS_OF_SERVICE_UNAVAILABLE
  • SERVICE_SLOWDOWN
  • RDS_RESTART_SEQUENCE
  • PGI_OF_SERVICE_UNAVAILABLE
  • OSI_SLOW_DISK
  • SYNTHETIC_NODE_OUTAGE
  • SYNTHETIC_PRIVATE_LOCATION_OUTAGE
  • PROCESS_THREADS_RESOURCE_EXHAUSTED
  • SERVICE_UNEXPECTED_HIGH_LOAD
  • APPLICATION_UNEXPECTED_HIGH_LOAD
  • SERVICE_UNEXPECTED_LOW_LOAD
  • APPLICATION_UNEXPECTED_LOW_LOAD
  • APPLICATION_SLOWDOWN
  • SYNTHETIC_GLOBAL_OUTAGE
  • SYNTHETIC_LOCAL_OUTAGE
  • SYNTHETIC_TEST_LOCATION_SLOWDOWN
  • HTTP_CHECK_GLOBAL_OUTAGE
  • HTTP_CHECK_LOCAL_OUTAGE
  • HTTP_CHECK_TEST_LOCATION_SLOWDOWN
  • MULTI_PROTOCOL_GLOBAL_OUTAGE
  • MULTI_PROTOCOL_LOCAL_OUTAGE
  • MULTI_PROTOCOL_LOCATION_SLOWDOWN
  • EXTERNAL_SYNTHETIC_TEST_OUTAGE
  • EXTERNAL_SYNTHETIC_TEST_SLOWDOWN
required
Negate
negate
boolean
-
required
The CustomEventFilter object
Property
Type
Description
Required
Title filter
titleFilter
-
optional
Description filter
descriptionFilter
-
optional
Property filters
metadataFilter
-
optional
The TextFilter object
Property
Type
Description
Required
Operator of the comparison
operator
enum
  • BEGINS_WITH
  • ENDS_WITH
  • CONTAINS
  • REGEX_MATCHES
  • STRING_EQUALS
required
Value
value
text
-
required
Negate
negate
boolean
-
required
Enabled
enabled
boolean
-
required
Case sensitive
caseSensitive
boolean
-
required
The MetadataFilter object
Property
Type
Description
Required
metadataFilterItems

Define filters for event properties. A maximum of 20 properties is allowed.

required
The MetadataFilterItem object
Property
Type
Description
Required
Key
metadataKey
text

Type 'dt.' for key hints.

required
Value
metadataValue
text
-
required
Negate
negate
boolean
-
required