Alerting profiles API - GET a profile
Gets the parameters of the specified alerting profile.
The request produces an application/json
payload.
This request is an Early Adopter release and may be changed in non-compatible way.
GET |
|
Authentication
To execute this request, you need the Read configuration (ReadConfig
) 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 required alerting profile. |
path | required |
Response
Response codes
Code | Description |
---|---|
200 | Success |
Response body
The AlertingProfile object
Configuration of an alerting profile.
Element | Type | Description |
---|---|---|
metadata | ConfigurationMetadata | |
id | string | The ID of the alerting profile. |
displayName | string | The name of the alerting profile, displayed in the UI. |
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. |
mzId | string | The ID of the management zone to which the alerting profile applies. |
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. |
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 |
---|---|---|
predefinedEventFilter | AlertingPredefinedEventFilter | |
customEventFilter | AlertingCustomEventFilter |
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 |
---|---|---|
customTitleFilter | AlertingCustomTextFilter | |
customDescriptionFilter | AlertingCustomTextFilter |
The AlertingCustomTextFilter object
Configuration of a matching filter.
Element | Type | Description |
---|---|---|
enabled | boolean | The filter is enabled ( |
value | string | The value to compare to. |
operator | string | Operator of the comparison. You can reverse it by setting negate to |
negate | boolean | Reverses the comparison operator. For example it turns the begins with into does not begin with. |
caseInsensitive | boolean | The condition is case sensitive ( If not set, then |
The AlertingPredefinedEventFilter object
Configuration of a predefined event filter.
Element | Type | Description |
---|---|---|
eventType | string | The type of the predefined event. |
negate | boolean | The alert triggers when the problem of specified severity arises while the specified event is happening ( For example, if you chose the Slowdown ( Consider the following use case as an example. The Slowdown (
|
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 |
---|---|---|
severityLevel | string | The severity level to trigger the alert. |
tagFilter | AlertingProfileTagFilter | |
delayInMinutes | integer | Send a notification if a problem remains open longer than X minutes. |
The AlertingProfileTagFilter object
Configuration of the tag filtering of the alerting profile.
Element | Type | Description |
---|---|---|
includeMode | string | The filtering mode:
|
tagFilters | TagFilter[] | A list of required tags. |
The TagFilter object
A tag-based filter of monitored entities.
Element | Type | Description |
---|---|---|
context | string | The origin of the tag, such as AWS or Cloud Foundry. Custom tags use the |
key | string | The key of the tag. Custom tags have the tag value here. |
value | string | The value of the tag. Not applicable to custom tags. |
The ConfigurationMetadata object
Metadata useful for debugging
Element | Type | Description |
---|---|---|
configurationVersions | integer[] | A Sorted list of the version numbers of the configuration. |
currentConfigurationVersions | string[] | A Sorted list of string version numbers of the configuration. |
clusterVersion | string | Dynatrace server version. |
{
"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
}
}
}
]
}
Example
In this example, the request lists the parameters of the Transaction slowdown alerting profile.
The API token is passed in the Authorization header.
The profile has the following parameters:
Curl
curl -X GET \
https://mySampleEnv.live.dynatrace.com/api/config/v1/alertingProfiles/93ac79a3-8cba-4be5-af44-50673b5e77f2 \
-H 'Authorization: Api-token abcdefjhij1234567890'
Request URL
https://mySampleEnv.live.dynatrace.com/api/config/v1/alertingProfiles/93ac79a3-8cba-4be5-af44-50673b5e77f2
Response body
{
"metadata": {
"configurationVersions": [
0
],
"clusterVersion": "1.181.0.20191016-161808"
},
"id": "93ac79a3-8cba-4be5-af44-50673b5e77f2",
"displayName": "Transaction slowdown",
"rules": [
{
"severityLevel": "PERFORMANCE",
"tagFilter": {
"includeMode": "INCLUDE_ANY",
"tagFilters": [
{
"context": "CONTEXTLESS",
"key": "searchService",
"value": null
},
{
"context": "CONTEXTLESS",
"key": "bookingService",
"value": null
},
{
"context": "CONTEXTLESS",
"key": "paymentService",
"value": null
}
]
},
"delayInMinutes": 5
}
],
"managementZoneId": 9130632296508575249,
"eventTypeFilters": [
{
"predefinedEventFilter": {
"eventType": "APPLICATION_UNEXPECTED_HIGH_LOAD",
"negate": false
}
}
]
}
Response code
200