Alerting profiles API - PUT a profile

Updates the specified alerting profile. If an alerting profile with the specified ID doesn't exist, a new profile is created.

The request consumes and produces an application/json payload.

Early Adopter

This request is an Early Adopter release and may be changed in non-compatible way.

PUT	Managed	`https://{your-domain}/e/{your-environment-id}/api/config/v1/alertingProfiles/{id}`
	SaaS	`https://{your-environment-id}.live.dynatrace.com/api/config/v1/alertingProfiles/{id}`
	Environment ActiveGate	`https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/alertingProfiles/{id}`

Authentication

To execute this request, you need Write configuration (WriteConfig) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.

Parameters

Parameter	Type	Description	In	Required
id	string	The ID of the alerting profile to be updated.	path	required
body	AlertingProfile	The JSON body of the request. Contains updated parameters of the alerting profile.	body	optional

Request body objects

The `AlertingProfile` object

Configuration of an alerting profile.

Element	Type	Description	Required
metadata	ConfigurationMetadata	Metadata useful for debugging	optional
id	string	The ID of the alerting profile.	optional
displayName	string	The name of the alerting profile, displayed in the UI.	required
rules	AlertingProfileSeverityRule[]	A list of severity rules. The rules are evaluated from top to bottom. The first matching rule applies and further evaluation stops. If you specify both severity rule and event filter, the AND logic applies.	optional
mzId	string	The ID of the management zone to which the alerting profile applies.	optional
eventTypeFilters	AlertingEventTypeFilter[]	The list of event filters. For all filters that are negated inside of these event filters, that is all "Predefined" as well as "Custom" (Title and/or Description) ones the AND logic applies. For all non-negated ones the OR logic applies. Between these two groups, negated and non-negated, the AND logic applies. If you specify both severity rule and event filter, the AND logic applies.	optional

The `ConfigurationMetadata` object

Metadata useful for debugging

Element	Type	Description	Required
configurationVersions	integer[]	A sorted list of the version numbers of the configuration.	optional
currentConfigurationVersions	string[]	A sorted list of version numbers of the configuration.	optional
clusterVersion	string	Dynatrace version.	optional

The `AlertingProfileSeverityRule` object

A severity rule of the alerting profile.

A severity rule defines the level of severity that must be met before an alert is sent our for a detected problem. Additionally it restricts the alerting to certain monitored entities.

Element	Type	Description	Required
severityLevel	string	The severity level to trigger the alert. The element can hold these values `AVAILABILITY` `CUSTOM_ALERT` `ERROR` `MONITORING_UNAVAILABLE` `PERFORMANCE` `RESOURCE_CONTENTION`	required
tagFilter	AlertingProfileTagFilter	Configuration of the tag filtering of the alerting profile.	required
delayInMinutes	integer	Send a notification if a problem remains open longer than X minutes.	required

The `AlertingProfileTagFilter` object

Configuration of the tag filtering of the alerting profile.

Element Type Description Required

includeMode

string

Element	Type	Description	Required
includeMode	string	The filtering mode: `INCLUDE_ANY`: The rule applies to monitored entities that have at least one of the specified tags. You can specify up to 100 tags. `INCLUDE_ALL`: The rule applies to monitored entities that have all of the specified tags. You can specify up to 10 tags. `NONE`: The rule applies to all monitored entities. The element can hold these values `INCLUDE_ALL` `INCLUDE_ANY` `NONE`	required
tagFilters	TagFilter[]	A list of required tags.	optional

The filtering mode:

INCLUDE_ANY: The rule applies to monitored entities that have at least one of the specified tags. You can specify up to 100 tags.
INCLUDE_ALL: The rule applies to monitored entities that have all of the specified tags. You can specify up to 10 tags.
NONE: The rule applies to all monitored entities.

The element can hold these values

INCLUDE_ALL
INCLUDE_ANY
NONE

required

tagFilters

TagFilter[]

A list of required tags.

optional

The `TagFilter` object

A tag-based filter of monitored entities.

Element Type Description Required

context

string

Element	Type	Description	Required
context	string	The origin of the tag, such as AWS or Cloud Foundry. Custom tags use the `CONTEXTLESS` value. The element can hold these values `AWS` `AWS_GENERIC` `AZURE` `CLOUD_FOUNDRY` `CONTEXTLESS` `ENVIRONMENT` `GOOGLE_CLOUD` `KUBERNETES`	required
key	string	The key of the tag. Custom tags have the tag value here.	required
value	string	The value of the tag. Not applicable to custom tags.	optional

The origin of the tag, such as AWS or Cloud Foundry.

Custom tags use the CONTEXTLESS value.

The element can hold these values

AWS
AWS_GENERIC
AZURE
CLOUD_FOUNDRY
CONTEXTLESS
ENVIRONMENT
GOOGLE_CLOUD
KUBERNETES

required

key

string

The key of the tag.

Custom tags have the tag value here.

required

value

string

The value of the tag.

Not applicable to custom tags.

optional

The `AlertingEventTypeFilter` object

Configuration of the event filter for the alerting profile.

You have two mutually exclusive options:

Select an event type from the list of the predefined events. Specify it in the predefinedEventFilter field.
Set a rule for custom events. Specify it in the customEventFilter field.

Element	Type	Description	Required
predefinedEventFilter	AlertingPredefinedEventFilter	Configuration of a predefined event filter.	optional
customEventFilter	AlertingCustomEventFilter	Configuration of a custom event filter. Filters custom events by title or description. If both specified, the AND logic applies.	optional

Element

Type

Description

Required

predefinedEventFilter

AlertingPredefinedEventFilter

Configuration of a predefined event filter.

optional

customEventFilter

AlertingCustomEventFilter

Configuration of a custom event filter.

Filters custom events by title or description. If both specified, the AND logic applies.

optional

The `AlertingPredefinedEventFilter` object

Configuration of a predefined event filter.

Element Type Description Required

eventType

string

Element	Type	Description	Required
eventType	string	The type of the predefined event. The element can hold these values `APPLICATION_ERROR_RATE_INCREASED` `APPLICATION_SLOWDOWN` `APPLICATION_UNEXPECTED_HIGH_LOAD` `APPLICATION_UNEXPECTED_LOW_LOAD` `AWS_LAMBDA_HIGH_ERROR_RATE` `CUSTOM_APPLICATION_ERROR_RATE_INCREASED` `CUSTOM_APPLICATION_SLOWDOWN` `CUSTOM_APPLICATION_UNEXPECTED_HIGH_LOAD` `CUSTOM_APPLICATION_UNEXPECTED_LOW_LOAD` `CUSTOM_APP_CRASH_RATE_INCREASED` `DATABASE_CONNECTION_FAILURE` `DATA_CENTER_SERVICE_PERFORMANCE_DEGRADATION` `DATA_CENTER_SERVICE_UNAVAILABLE` `EBS_VOLUME_HIGH_LATENCY` `EC2_HIGH_CPU` `ELB_HIGH_BACKEND_ERROR_RATE` `ENTERPRICE_APPLICATION_PERFORMANCE_DEGRADATION` `ENTERPRISE_APPLICATION_UNAVAILABLE` `ESXI_GUEST_ACTIVE_SWAP_WAIT` `ESXI_GUEST_CPU_LIMIT_REACHED` `ESXI_HOST_CPU_SATURATION` `ESXI_HOST_DATASTORE_LOW_DISK_SPACE` `ESXI_HOST_DISK_QUEUE_SLOW` `ESXI_HOST_DISK_SLOW` `ESXI_HOST_MEMORY_SATURATION` `ESXI_HOST_NETWORK_PROBLEMS` `ESXI_HOST_OVERLOADED_STORAGE` `ESXI_VM_IMPACT_HOST_CPU_SATURATION` `ESXI_VM_IMPACT_HOST_MEMORY_SATURATION` `EXTERNAL_SYNTHETIC_TEST_OUTAGE` `EXTERNAL_SYNTHETIC_TEST_SLOWDOWN` `HOST_OF_SERVICE_UNAVAILABLE` `HTTP_CHECK_GLOBAL_OUTAGE` `HTTP_CHECK_LOCAL_OUTAGE` `HTTP_CHECK_TEST_LOCATION_SLOWDOWN` `MOBILE_APPLICATION_ERROR_RATE_INCREASED` `MOBILE_APPLICATION_SLOWDOWN` `MOBILE_APPLICATION_UNEXPECTED_HIGH_LOAD` `MOBILE_APPLICATION_UNEXPECTED_LOW_LOAD` `MOBILE_APP_CRASH_RATE_INCREASED` `MONITORING_UNAVAILABLE` `OSI_DISK_LOW_INODES` `OSI_GRACEFULLY_SHUTDOWN` `OSI_HIGH_CPU` `OSI_HIGH_MEMORY` `OSI_LOW_DISK_SPACE` `OSI_NIC_DROPPED_PACKETS_HIGH` `OSI_NIC_ERRORS_HIGH` `OSI_NIC_UTILIZATION_HIGH` `OSI_SLOW_DISK` `OSI_UNEXPECTEDLY_UNAVAILABLE` `PGI_OF_SERVICE_UNAVAILABLE` `PGI_UNAVAILABLE` `PG_LOW_INSTANCE_COUNT` `PROCESS_CRASHED` `PROCESS_HIGH_GC_ACTIVITY` `PROCESS_MEMORY_RESOURCE_EXHAUSTED` `PROCESS_NA_HIGH_CONN_FAIL_RATE` `PROCESS_NA_HIGH_LOSS_RATE` `PROCESS_THREADS_RESOURCE_EXHAUSTED` `RDS_HIGH_CPU` `RDS_HIGH_LATENCY` `RDS_LOW_MEMORY` `RDS_LOW_STORAGE_SPACE` `RDS_OF_SERVICE_UNAVAILABLE` `RDS_RESTART_SEQUENCE` `SERVICE_ERROR_RATE_INCREASED` `SERVICE_SLOWDOWN` `SERVICE_UNEXPECTED_HIGH_LOAD` `SERVICE_UNEXPECTED_LOW_LOAD` `SYNTHETIC_GLOBAL_OUTAGE` `SYNTHETIC_LOCAL_OUTAGE` `SYNTHETIC_NODE_OUTAGE` `SYNTHETIC_PRIVATE_LOCATION_OUTAGE` `SYNTHETIC_TEST_LOCATION_SLOWDOWN`	required
negate	boolean	The alert triggers when the problem of specified severity arises while the specified event is happening (`false`) or while the specified event is not happening (`true`). For example, if you chose the Slowdown (`PERFORMANCE`) severity and Unexpected high traffic (`APPLICATION_UNEXPECTED_HIGH_LOAD`) event with negate set to `true`, the alerting profile will trigger only when the slowdown problem is raised while there is no unexpected high traffic event. Consider the following use case as an example. The Slowdown (`PERFORMANCE`) severity rule is set. Depending on the configuration of the event filter (Unexpected high traffic (`APPLICATION_UNEXPECTED_HIGH_LOAD`) event is used as an example), the behavior of the alerting profile is one of the following:* negate is set to `false`: The alert triggers when the slowdown problem is raised while unexpected high traffic event is happening. negate is set to `true`: The alert triggers when the slowdown problem is raised while there is no unexpected high traffic event. no event rule is set: The alert triggers when the slowdown problem is raised, regardless of any events.	required

The type of the predefined event.

The element can hold these values

APPLICATION_ERROR_RATE_INCREASED
APPLICATION_SLOWDOWN
APPLICATION_UNEXPECTED_HIGH_LOAD
APPLICATION_UNEXPECTED_LOW_LOAD
AWS_LAMBDA_HIGH_ERROR_RATE
CUSTOM_APPLICATION_ERROR_RATE_INCREASED
CUSTOM_APPLICATION_SLOWDOWN
CUSTOM_APPLICATION_UNEXPECTED_HIGH_LOAD
CUSTOM_APPLICATION_UNEXPECTED_LOW_LOAD
CUSTOM_APP_CRASH_RATE_INCREASED
DATABASE_CONNECTION_FAILURE
DATA_CENTER_SERVICE_PERFORMANCE_DEGRADATION
DATA_CENTER_SERVICE_UNAVAILABLE
EBS_VOLUME_HIGH_LATENCY
EC2_HIGH_CPU
ELB_HIGH_BACKEND_ERROR_RATE
ENTERPRICE_APPLICATION_PERFORMANCE_DEGRADATION
ENTERPRISE_APPLICATION_UNAVAILABLE
ESXI_GUEST_ACTIVE_SWAP_WAIT
ESXI_GUEST_CPU_LIMIT_REACHED
ESXI_HOST_CPU_SATURATION
ESXI_HOST_DATASTORE_LOW_DISK_SPACE
ESXI_HOST_DISK_QUEUE_SLOW
ESXI_HOST_DISK_SLOW
ESXI_HOST_MEMORY_SATURATION
ESXI_HOST_NETWORK_PROBLEMS
ESXI_HOST_OVERLOADED_STORAGE
ESXI_VM_IMPACT_HOST_CPU_SATURATION
ESXI_VM_IMPACT_HOST_MEMORY_SATURATION
EXTERNAL_SYNTHETIC_TEST_OUTAGE
EXTERNAL_SYNTHETIC_TEST_SLOWDOWN
HOST_OF_SERVICE_UNAVAILABLE
HTTP_CHECK_GLOBAL_OUTAGE
HTTP_CHECK_LOCAL_OUTAGE
HTTP_CHECK_TEST_LOCATION_SLOWDOWN
MOBILE_APPLICATION_ERROR_RATE_INCREASED
MOBILE_APPLICATION_SLOWDOWN
MOBILE_APPLICATION_UNEXPECTED_HIGH_LOAD
MOBILE_APPLICATION_UNEXPECTED_LOW_LOAD
MOBILE_APP_CRASH_RATE_INCREASED
MONITORING_UNAVAILABLE
OSI_DISK_LOW_INODES
OSI_GRACEFULLY_SHUTDOWN
OSI_HIGH_CPU
OSI_HIGH_MEMORY
OSI_LOW_DISK_SPACE
OSI_NIC_DROPPED_PACKETS_HIGH
OSI_NIC_ERRORS_HIGH
OSI_NIC_UTILIZATION_HIGH
OSI_SLOW_DISK
OSI_UNEXPECTEDLY_UNAVAILABLE
PGI_OF_SERVICE_UNAVAILABLE
PGI_UNAVAILABLE
PG_LOW_INSTANCE_COUNT
PROCESS_CRASHED
PROCESS_HIGH_GC_ACTIVITY
PROCESS_MEMORY_RESOURCE_EXHAUSTED
PROCESS_NA_HIGH_CONN_FAIL_RATE
PROCESS_NA_HIGH_LOSS_RATE
PROCESS_THREADS_RESOURCE_EXHAUSTED
RDS_HIGH_CPU
RDS_HIGH_LATENCY
RDS_LOW_MEMORY
RDS_LOW_STORAGE_SPACE
RDS_OF_SERVICE_UNAVAILABLE
RDS_RESTART_SEQUENCE
SERVICE_ERROR_RATE_INCREASED
SERVICE_SLOWDOWN
SERVICE_UNEXPECTED_HIGH_LOAD
SERVICE_UNEXPECTED_LOW_LOAD
SYNTHETIC_GLOBAL_OUTAGE
SYNTHETIC_LOCAL_OUTAGE
SYNTHETIC_NODE_OUTAGE
SYNTHETIC_PRIVATE_LOCATION_OUTAGE
SYNTHETIC_TEST_LOCATION_SLOWDOWN

required

negate

boolean

The alert triggers when the problem of specified severity arises while the specified event is happening (false) or while the specified event is not happening (true).

For example, if you chose the Slowdown (PERFORMANCE) severity and Unexpected high traffic (APPLICATION_UNEXPECTED_HIGH_LOAD) event with negate set to true, the alerting profile will trigger only when the slowdown problem is raised while there is no unexpected high traffic event.

Consider the following use case as an example. The Slowdown (PERFORMANCE) severity rule is set. Depending on the configuration of the event filter (Unexpected high traffic (APPLICATION_UNEXPECTED_HIGH_LOAD) event is used as an example), the behavior of the alerting profile is one of the following:* negate is set to false: The alert triggers when the slowdown problem is raised while unexpected high traffic event is happening.

negate is set to true: The alert triggers when the slowdown problem is raised while there is no unexpected high traffic event.
no event rule is set: The alert triggers when the slowdown problem is raised, regardless of any events.

required

The `AlertingCustomEventFilter` object

Configuration of a custom event filter.

Filters custom events by title or description. If both specified, the AND logic applies.

Element	Type	Description	Required
customTitleFilter	AlertingCustomTextFilter	Configuration of a matching filter.	optional
customDescriptionFilter	AlertingCustomTextFilter	Configuration of a matching filter.	optional

The `AlertingCustomTextFilter` object

Configuration of a matching filter.

Element	Type	Description	Required
enabled	boolean	The filter is enabled (`true`) or disabled (`false`).	required
value	string	The value to compare to.	required
operator	string	Operator of the comparison. You can reverse it by setting negate to `true`. The element can hold these values `BEGINS_WITH` `CONTAINS` `CONTAINS_REGEX` `ENDS_WITH` `EQUALS`	required
negate	boolean	Reverses the comparison operator. For example it turns the begins with into does not begin with.	required
caseInsensitive	boolean	The condition is case sensitive (`false`) or case insensitive (`true`). If not set, then `false` is used, making the condition case sensitive.	required

Request body JSON model

This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.

json
{
  "id": "12345678-abcd-1234-abcd-1234567890ab",
  "displayName": "sampleAlertingProfile",
  "mzId": "1",
  "rules": [
    {
      "severityLevel": "AVAILABILITY",
      "tagFilter": {
        "includeMode": "INCLUDE_ALL",
        "tagFilters": [
          {
            "context": "AWS",
            "key": "tagKey",
            "value": "tagValue"
          }
        ]
      },
      "delayInMinutes": 60
    }
  ],
  "eventTypeFilters": [
    {
      "predefinedEventFilter": {
        "eventType": "OSI_HIGH_CPU",
        "negate": true
      }
    },
    {
      "customEventFilter": {
        "customTitleFilter": {
          "enabled": true,
          "value": "filterValue",
          "operator": "EQUALS",
          "negate": false,
          "caseInsensitive": true
        },
        "customDescriptionFilter": {
          "enabled": false,
          "value": "filterValue",
          "operator": "CONTAINS",
          "negate": true,
          "caseInsensitive": false
        }
      }
    }
  ]
}

Response

Response codes

Code	Type	Description
201	EntityShortRepresentation	Success. The new alerting profile has been created. The response contains the ID of the new alerting profile.
204	-	Success. The alerting profile has been updated. Response doesn't have a body.
400	ErrorEnvelope	Failed. The input is invalid.

Response body objects

The `EntityShortRepresentation` object

The short representation of a Dynatrace entity.

Element	Type	Description	Required
id	string	The ID of the Dynatrace entity.	required
name	string	The name of the Dynatrace entity.	optional
description	string	A short description of the Dynatrace entity.	optional

Response body JSON model

json
{
  "id": "6a98d7bc-abb9-44f8-ae6a-73e68e71812a",
  "name": "Dynatrace entity",
  "description": "Dynatrace entity for the REST API example"
}

Validate payload

We recommend that you validate the payload before submitting it with an actual request. A response code of 204 indicates a valid payload.

The request consumes an application/json payload.

Early Adopter

This request is an Early Adopter release and may be changed in non-compatible way.

POST	Managed	`https://{your-domain}/e/{your-environment-id}/api/config/v1/alertingProfiles/{id}/validator`
	SaaS	`https://{your-environment-id}.live.dynatrace.com/api/config/v1/alertingProfiles/{id}/validator`
	Environment ActiveGate	`https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/alertingProfiles/{id}/validator`

Authentication

To execute this request, you need Write configuration (WriteConfig) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.

Response

Response codes

Code	Type	Description
204	-	Validated. The submitted alerting profile is valid. Response doesn't have a body
400	ErrorEnvelope	Failed. The input is invalid.

Example

In this example, the request updates the alerting profile from the POST request example. It makes the following changes:

Reduces delay to 1 minute.
Adds a second tag of monitored entities: MobileApp.
Adds a second event filter that requires Unexpected low traffic to not be present.

The API token is passed in the Authorization header.

You can download or copy the example request body to try it out on your own. By sure to replace tags with some that you have in your environment.

Curl

bash
curl -X PUT \
  https://mySampleEnv.live.dynatrace.com/api/config/v1/alertingProfiles/19e50c27-8aed-408f-ad44-d6a1bf856f49 \
  -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
  -H 'Content-Type: application/json' \
  -d '{<truncated - see the Request body section >}
'

Request URL

http
https://mySampleEnv.live.dynatrace.com/api/config/v1/alertingProfiles/19e50c27-8aed-408f-ad44-d6a1bf856f49

Request body

json
{
  "displayName": "App availability",
  "rules": [
    {
      "severityLevel": "AVAILABILITY",
      "tagFilter": {
        "includeMode": "INCLUDE_ANY",
        "tagFilters": [
          {
            "context": "CONTEXTLESS",
            "key": "MainApp"
          },
          {
            "context": "CONTEXTLESS",
            "key": "MobileApp"
          }
        ]
      },
      "delayInMinutes": 1
    }
  ],
  "mzId": "9130632296508575249",
  "eventTypeFilters": [
    {
      "predefinedEventFilter": {
        "eventType": "SYNTHETIC_GLOBAL_OUTAGE",
        "negate": false
      }
    },
    {
      "predefinedEventFilter": {
        "eventType": "APPLICATION_UNEXPECTED_HIGH_LOAD",
        "negate": true
      }
    }
  ]
}

Response code

204

Result

The updated alerting profile has the following parameters:

PUT example

Alerting profiles API - PUT a profile

Authentication

Parameters

Request body objects

The AlertingProfile object

The ConfigurationMetadata object

The AlertingProfileSeverityRule object

The AlertingProfileTagFilter object

The TagFilter object

The AlertingEventTypeFilter object

The AlertingPredefinedEventFilter object

The AlertingCustomEventFilter object

The AlertingCustomTextFilter object

Request body JSON model

Response

Response codes

Response body objects

The EntityShortRepresentation object

Response body JSON model

Validate payload

Authentication

Response

Response codes

Example

Curl

Request URL

Request body

Response code

Result

The `AlertingProfile` object

The `ConfigurationMetadata` object

The `AlertingProfileSeverityRule` object

The `AlertingProfileTagFilter` object

The `TagFilter` object

The `AlertingEventTypeFilter` object

The `AlertingPredefinedEventFilter` object

The `AlertingCustomEventFilter` object

The `AlertingCustomTextFilter` object

The `EntityShortRepresentation` object