AWS anomaly detection API - GET configuration
Gets the configuration of anomaly detection for AWS.
The request produces an application/json
payload.
GET | Managed | https://{your-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/aws |
SaaS | https://{your-environment-id}.live.dynatrace.com/api/config/v1/anomalyDetection/aws | |
Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/aws |
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 | Aws | Success |
Response body objects
The AwsAnomalyDetectionConfig
object
The configuration of anomaly detection for AWS.
Element | Type | Description |
---|---|---|
metadata | Configuration | Metadata useful for debugging Can be |
rdsHighCpuDetection | Rds | The configuration of the high CPU utilization on RDS detection. |
rdsHighWriteReadLatencyDetection | Rds | The configuration of the high RDS write/read latency detection. |
rdsLowStorageDetection | Rds | The configuration of the low free storage space on RDS detection. |
rdsHighMemoryDetection | Rds | The configuration of RDS running out of memory detection. |
elbHighConnectionErrorsDetection | Elb | The configuration of the high number of backend connection errors on ELB detection. |
rdsRestartsSequenceDetection | Rds | The configuration of the restarts sequence on RDS detection. |
lambdaHighErrorRateDetection | Lambda | The configuration of the AWS Lambda high error rate detection. |
ec2CandidateCpuSaturationDetection | Ec2 | The configuration of the high CPU saturation on EC2 without installed agent (monitoring candidate). If null, then this configuration won't be changed. Can be |
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 RdsHighCpuDetectionConfig
object
The configuration of the high CPU utilization on RDS detection.
Element | Type | Description |
---|---|---|
enabled | boolean | The detection is enabled ( |
customThresholds | Rds | Custom thresholds for high CPU utilization on RDS. If not set, automatic mode is used. Can be |
The RdsHighCpuThresholds
object
Custom thresholds for high CPU utilization on RDS. If not set, automatic mode is used.
Element | Type | Description |
---|---|---|
cpuUsagePercentage | integer | Alert if CPU usage is higher than X% in 3 out of 5 samples. |
The RdsHighWriteReadLatencyDetectionConfig
object
The configuration of the high RDS write/read latency detection.
Element | Type | Description |
---|---|---|
enabled | boolean | The detection is enabled ( |
customThresholds | Rds | Custom thresholds for high RDS write/read latency. If not set, automatic mode is used Can be |
The RdsHighLatencyThresholds
object
Custom thresholds for high RDS write/read latency. If not set, automatic mode is used
Element | Type | Description |
---|---|---|
writeReadLatency | integer | Alert if read/write latency is higher than X milliseconds in 3 out of 5 samples. |
The RdsLowStorageDetectionConfig
object
The configuration of the low free storage space on RDS detection.
Element | Type | Description |
---|---|---|
enabled | boolean | The detection is enabled ( |
customThresholds | Rds | Custom thresholds for low free storage space on RDS. If not set, automatic mode is used. Can be |
The RdsLowStorageThresholds
object
Custom thresholds for low free storage space on RDS. If not set, automatic mode is used.
Element | Type | Description |
---|---|---|
freeStoragePercentage | integer | Alert if free storage space divided by allocated storage is lower than X% in 3 out of 5 samples. |
The RdsHighMemoryDetectionConfig
object
The configuration of RDS running out of memory detection.
Element | Type | Description |
---|---|---|
enabled | boolean | The detection is enabled ( |
customThresholds | Rds | Custom thresholds for RDS running out of memory. If not set, automatic mode is used. All conditions must be fulfilled to trigger an alert. Can be |
The RdsHighMemoryThresholds
object
Custom thresholds for RDS running out of memory. If not set, automatic mode is used.
All conditions must be fulfilled to trigger an alert.
Element | Type | Description |
---|---|---|
freeMemory | number | Freeable memory is lower than X Megabytes in 3 out of 5 samples. |
swapUsage | number | Swap usage is higher than X Gigabytes in 3 out of 5 samples. |
The ElbHighConnectionErrorsDetectionConfig
object
The configuration of the high number of backend connection errors on ELB detection.
Element | Type | Description |
---|---|---|
enabled | boolean | The detection is enabled ( |
customThresholds | Elb | Custom thresholds for high number of backend connection errors on ELB. If not set, automatic mode is used. Can be |
The ElbHighConnectionErrorsThresholds
object
Custom thresholds for high number of backend connection errors on ELB. If not set, automatic mode is used.
Element | Type | Description |
---|---|---|
connectionErrorsPerMinute | integer | Alert if number of backend connection errors is higher than X per minute in 3 out of 5 samples. |
The RdsRestartsSequenceDetectionConfig
object
The configuration of the restarts sequence on RDS detection.
Element | Type | Description |
---|---|---|
enabled | boolean | The detection is enabled ( |
customThresholds | Rds | Custom thresholds for restarts sequence on RDS. If not set, automatic mode is used. Can be |
The RdsRestartsThresholds
object
Custom thresholds for restarts sequence on RDS. If not set, automatic mode is used.
Element | Type | Description |
---|---|---|
restartsPerMinute | integer | Alert if number of restarts is X per minute or higher in 3 out of 20 samples. |
The LambdaHighErrorRateDetectionConfig
object
The configuration of the AWS Lambda high error rate detection.
Element | Type | Description |
---|---|---|
enabled | boolean | The detection is enabled ( |
customThresholds | Lambda | Custom thresholds for AWS Lambda high error rate. If not set, automatic mode is used. Can be |
The LambdaHighErrorRateThresholds
object
Custom thresholds for AWS Lambda high error rate. If not set, automatic mode is used.
Element | Type | Description |
---|---|---|
failedInvocationsRate | integer | Alert if failed invocations rate is higher than X% in 3 out of 5 samples. |
The Ec2CandidateCpuSaturationDetectionConfig
object
The configuration of the high CPU saturation on EC2 without installed agent (monitoring candidate). If null, then this configuration won't be changed.
Element | Type | Description |
---|---|---|
enabled | boolean | The detection is enabled ( |
customThresholds | Ec2 | Custom thresholds for high CPU saturation on EC2 monitoring candidate. If not set, automatic mode is used. Can be |
The Ec2CandidateCpuSaturationThresholds
object
Custom thresholds for high CPU saturation on EC2 monitoring candidate. If not set, automatic mode is used.
Element | Type | Description |
---|---|---|
cpuUsagePercentage | integer | Alert if CPU usage is higher than X% in 3 out of 5 samples. |
Response body JSON model
{
"metadata": {
"configurationVersions": [
4,
2
],
"clusterVersion": "Mock version"
},
"rdsHighCpuDetection": {
"enabled": true,
"customThresholds": {
"cpuUsagePercentage": 99
}
},
"rdsHighWriteReadLatencyDetection": {
"enabled": true,
"customThresholds": {
"writeReadLatency": 800
}
},
"rdsLowStorageDetection": {
"enabled": true,
"customThresholds": {
"freeStoragePercentage": 7
}
},
"rdsHighMemoryDetection": {
"enabled": true,
"customThresholds": {
"freeMemory": 96.99,
"swapUsage": 5.5
}
},
"elbHighConnectionErrorsDetection": {
"enabled": true,
"customThresholds": {
"connectionErrorsPerMinute": 4
}
},
"rdsRestartsSequenceDetection": {
"enabled": true,
"customThresholds": {
"restartsPerMinute": 3
}
},
"lambdaHighErrorRateDetection": {
"enabled": true,
"customThresholds": {
"failedInvocationsRate": 2
}
},
"ec2CandidateCpuSaturationDetection": {
"enabled": true,
"customThresholds": {
"cpuUsagePercentage": 98
}
}
}
Example
In this example, the request lists the current configuration of anomaly detection for AWS.
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/aws \
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'
Request URL
https://mySampleEnv.live.dynatrace.com/api/config/v1/anomalyDetection/aws
Response body
{
"metadata": {
"clusterVersion": "1.163.2.20190201-072431",
"configurationVersions": [
8,
2
]
},
"rdsHighCpuDetection": {
"enabled": true
},
"rdsHighWriteReadLatencyDetection": {
"enabled": true
},
"rdsLowStorageDetection": {
"enabled": true
},
"rdsHighMemoryDetection": {
"enabled": true
},
"elbHighConnectionErrorsDetection": {
"enabled": true
},
"rdsRestartsSequenceDetection": {
"enabled": true
},
"lambdaHighErrorRateDetection": {
"enabled": true
}
}
Response code
200