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 IDSchema groupsScope
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

PropertyTypeDescriptionRequired
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
Set<AlertingProfileSeverityRule>

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

required
Event filters
eventFilters
Set<AlertingProfileEventFilter>

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

required
The AlertingProfileSeverityRule object
PropertyTypeDescriptionRequired
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
PropertyTypeDescriptionRequired
Filter problems by any event of source
type
enum
  • PREDEFINED
  • CUSTOM
required
predefinedFilterPredefinedEventFilter-required
customFilterCustomEventFilter-required
The PredefinedEventFilter object
PropertyTypeDescriptionRequired
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
PropertyTypeDescriptionRequired
Title filter
titleFilter
TextFilter-optional
Description filter
descriptionFilter
TextFilter-optional
Property filters
metadataFilter
MetadataFilter-optional
The TextFilter object
PropertyTypeDescriptionRequired
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
PropertyTypeDescriptionRequired
metadataFilterItemsSet<MetadataFilterItem>

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

required
The MetadataFilterItem object
PropertyTypeDescriptionRequired
Key
metadataKey
text

Type 'dt.' for key hints.

required
Value
metadataValue
text-required
Negate
negate
boolean-required