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`

GET	Managed	`https://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:alerting.profile`
	SaaS	`https://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:alerting.profile`
	Environment ActiveGate	`https://{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`	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

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`	PredefinedEventFilter	-	required
`customFilter`	CustomEventFilter	-	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` `EXTERNAL_SYNTHETIC_TEST_OUTAGE` `EXTERNAL_SYNTHETIC_TEST_SLOWDOWN`	required
Negate `negate`	boolean	-	required

The `CustomEventFilter` object

Property	Type	Description	Required
Title filter `titleFilter`	TextFilter	-	optional
Description filter `descriptionFilter`	TextFilter	-	optional
Property filters `metadataFilter`	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`	Set<MetadataFilterItem>	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

Settings API - Problem alerting profiles schema table

Problem alerting profiles (builtin:alerting.profile)

Authentication

Parameters

The AlertingProfileSeverityRule object

The AlertingProfileEventFilter object

The PredefinedEventFilter object

The CustomEventFilter object

The TextFilter object

The MetadataFilter object

The MetadataFilterItem object