Services anomaly detection API - GET configuration
This API is deprecated. Use the Settings API instead. Look for the Anomaly detection for services (builtin:anomaly-detection.services
) schema.
Gets the configuration of anomaly detection for services.
The request produces an application/json
payload.
GET | Managed | https://{your-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/services |
SaaS | https://{your-environment-id}.live.dynatrace.com/api/config/v1/anomalyDetection/services | |
Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/services |
Authentication
To execute this request, you need an access token with Read configuration (ReadConfig
) scope. To learn how to obtain and use it, see Tokens and authentication.
Parameters
The request doesn't provide any configurable parameters.
Response
Response codes
Code | Type | Description |
---|---|---|
200 | Service | Success |
Response body objects
The ServiceAnomalyDetectionConfig
object
Dynatrace automatically detects service-related performance anomalies such as response time degradations and failure rate increases. Use these settings to configure detection sensitivity, set alert thresholds, or disable alerting for certain services.
Element | Type | Description |
---|---|---|
metadata | Configuration | Metadata useful for debugging Can be |
responseTimeDegradation | Response | Configuration of response time degradation detection. |
loadDrop | Load | The configuration of load drops detection. Can be |
loadSpike | Load | The configuration of load spikes detection. Can be |
failureRateIncrease | Failure | Configuration of failure rate increase detection. |
The ConfigurationMetadata
object
Metadata useful for debugging
Element | Type | Description |
---|---|---|
configurationVersions | integer[] | A sorted list of the version numbers of the configuration. Can be |
currentConfigurationVersions | string[] | A sorted list of version numbers of the configuration. Can be |
clusterVersion | string | Dynatrace version. Can be |
The ResponseTimeDegradationDetectionConfig
object
Configuration of response time degradation detection.
Element | Type | Description |
---|---|---|
detectionMode | string | How to detect response time degradation: automatically, or based on fixed thresholds, or do not detect. |
automaticDetection | Response | Parameters of the response time degradation auto-detection. Required if the detectionMode is Violation of any criterion triggers an alert. Can be |
thresholds | Response | Fixed thresholds for response time degradation detection. Required if detectionMode is Can be |
The ResponseTimeDegradationAutodetectionConfig
object
Parameters of the response time degradation auto-detection. Required if the detectionMode is DETECT_AUTOMATICALLY
. Not applicable otherwise.
Violation of any criterion triggers an alert.
Element | Type | Description |
---|---|---|
responseTimeDegradationMilliseconds | integer | Alert if the response time degrades beyond X milliseconds. |
responseTimeDegradationPercent | integer | Alert if the response time degrades beyond X %. |
slowestResponseTimeDegradationMilliseconds | integer | Alert if the response time of the slowest 10% degrades beyond X milliseconds. |
slowestResponseTimeDegradationPercent | integer | Alert if the response time of the slowest 10% degrades beyond X %. |
loadThreshold | string | Minimal service load to detect response time degradation. Response time degradation of services with smaller load won't trigger alerts. |
The ResponseTimeDegradationThresholdConfig
object
Fixed thresholds for response time degradation detection.
Required if detectionMode is DETECT_USING_FIXED_THRESHOLDS
. Not applicable otherwise.
Element | Type | Description |
---|---|---|
responseTimeThresholdMilliseconds | integer | Response time during any 5-minute period to trigger an alert, in milliseconds. |
slowestResponseTimeThresholdMilliseconds | integer | Response time of the 10% slowest during any 5-minute period to trigger an alert, in milliseconds. |
loadThreshold | string | Minimal service load to detect response time degradation. Response time degradation of services with smaller load won't trigger alerts. |
sensitivity | string | Sensitivity of the threshold. With With |
The LoadDropDetectionConfig
object
The configuration of load drops detection.
Element | Type | Description |
---|---|---|
enabled | boolean | The detection is enabled ( |
loadDropPercent | integer | Alert if the observed load is less than X % of the expected value. Can be |
minAbnormalStateDurationInMinutes | integer | Alert if the service stays in abnormal state for at least X minutes. Can be |
The LoadSpikeDetectionConfig
object
The configuration of load spikes detection.
Element | Type | Description |
---|---|---|
enabled | boolean | The detection is enabled ( |
loadSpikePercent | integer | Alert if the observed load is more than X % of the expected value. Can be |
minAbnormalStateDurationInMinutes | integer | Alert if the service stays in abnormal state for at least X minutes. Can be |
The FailureRateIncreaseDetectionConfig
object
Configuration of failure rate increase detection.
Element | Type | Description |
---|---|---|
detectionMode | string | How to detect failure rate increase: automatically, or based on fixed thresholds, or do not detect. |
automaticDetection | Failure | Parameters of failure rate increase auto-detection. Required if detectionMode is The absolute and relative thresholds both must exceed to trigger an alert. Example: If the expected error rate is 1.5%, and you set an absolute increase of 1%, and a relative increase of 50%, the thresholds will be: Absolute: 1.5% + 1% = 2.5% Relative: 1.5% + 1.5% * 50% = 2.25% Can be |
thresholds | Failure | Fixed thresholds for failure rate increase detection. Required if detectionMode is Can be |
The FailureRateIncreaseAutodetectionConfig
object
Parameters of failure rate increase auto-detection. Required if detectionMode is DETECT_AUTOMATICALLY
. Not applicable otherwise.
The absolute and relative thresholds both must exceed to trigger an alert.
Example: If the expected error rate is 1.5%, and you set an absolute increase of 1%, and a relative increase of 50%, the thresholds will be: Absolute: 1.5% + 1% = 2.5% Relative: 1.5% + 1.5% * 50% = 2.25%
Element | Type | Description |
---|---|---|
failingServiceCallPercentageIncreaseAbsolute | integer | Absolute increase of failing service calls to trigger an alert, %. |
failingServiceCallPercentageIncreaseRelative | integer | Relative increase of failing service calls to trigger an alert, %. |
The FailureRateIncreaseThresholdConfig
object
Fixed thresholds for failure rate increase detection.
Required if detectionMode is DETECT_USING_FIXED_THRESHOLDS
. Not applicable otherwise.
Element | Type | Description |
---|---|---|
threshold | integer | Failure rate during any 5-minute period to trigger an alert, %. |
sensitivity | string | Sensitivity of the threshold. With With |
Response body JSON model
{
"metadata": {
"configurationVersions": [
4,
2
],
"clusterVersion": "Mock version"
},
"responseTimeDegradation": {
"detectionMode": "DETECT_AUTOMATICALLY",
"automaticDetection": {
"responseTimeDegradationMilliseconds": 250,
"responseTimeDegradationPercent": 90,
"slowestResponseTimeDegradationMilliseconds": 500,
"slowestResponseTimeDegradationPercent": 200,
"loadThreshold": "ONE_REQUEST_PER_MINUTE"
}
},
"loadDrop": {
"enabled": true,
"loadDropPercent": 40,
"minAbnormalStateDurationInMinutes": 5
},
"loadSpike": {
"enabled": false
},
"failureRateIncrease": {
"detectionMode": "DETECT_USING_FIXED_THRESHOLDS",
"thresholds": {
"threshold": 10,
"sensitivity": "LOW"
}
}
}
Example
In this example, the request lists the current configuration of anomaly detection for services.
The API token is passed in the Authorization header.
The configuration has the following settings:
Curl
curl -X GET \
https://mySampleEnv.live.dynatrace.com/api/config/v1/anomalyDetection/services \
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'
Request URL
https://mySampleEnv.live.dynatrace.com/api/config/v1/anomalyDetection/services
Response body
{
"metadata": {
"clusterVersion": "1.163.14.20190204-102159",
"configurationVersions": [
2
]
},
"responseTimeDegradation": {
"detectionMode": "DETECT_AUTOMATICALLY",
"automaticDetection": {
"responseTimeDegradationMilliseconds": 100,
"responseTimeDegradationPercent": 50,
"slowestResponseTimeDegradationMilliseconds": 100,
"slowestResponseTimeDegradationPercent": 100,
"loadThreshold": "TEN_REQUESTS_PER_MINUTE"
}
},
"failureRateIncrease": {
"detectionMode": "DETECT_AUTOMATICALLY",
"automaticDetection": {
"failingServiceCallPercentageIncreaseAbsolute": 0,
"failingServiceCallPercentageIncreaseRelative": 50
}
}
}
Response code
200