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 Read configuration (ReadConfig) permission assigned to your API token. 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	AwsAnomalyDetectionConfig	Success

Response body objects

The `AwsAnomalyDetectionConfig` object

The configuration of anomaly detection for AWS.

Element	Type	Description	Required
metadata	ConfigurationMetadata	Metadata useful for debugging	optional
rdsHighCpuDetection	RdsHighCpuDetectionConfig	The configuration of the high CPU utilization on RDS detection.	required
rdsHighWriteReadLatencyDetection	RdsHighWriteReadLatencyDetectionConfig	The configuration of the high RDS write/read latency detection.	required
rdsLowStorageDetection	RdsLowStorageDetectionConfig	The configuration of the low free storage space on RDS detection.	required
rdsHighMemoryDetection	RdsHighMemoryDetectionConfig	The configuration of RDS running out of memory detection.	required
elbHighConnectionErrorsDetection	ElbHighConnectionErrorsDetectionConfig	The configuration of the high number of backend connection errors on ELB detection.	required
rdsRestartsSequenceDetection	RdsRestartsSequenceDetectionConfig	The configuration of the restarts sequence on RDS detection.	required
lambdaHighErrorRateDetection	LambdaHighErrorRateDetectionConfig	The configuration of the AWS Lambda high error rate detection.	required
ec2CandidateCpuSaturationDetection	Ec2CandidateCpuSaturationDetectionConfig	The configuration of the high CPU saturation on EC2 without installed agent (monitoring candidate). If null, then this configuration won't be changed.	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 `RdsHighCpuDetectionConfig` object

The configuration of the high CPU utilization on RDS detection.

Element	Type	Description	Required
enabled	boolean	The detection is enabled (`true`) or disabled (`false`).	required
customThresholds	RdsHighCpuThresholds	Custom thresholds for high CPU utilization on RDS. If not set, automatic mode is used.	optional

The `RdsHighCpuThresholds` object

Custom thresholds for high CPU utilization on RDS. If not set, automatic mode is used.

Element	Type	Description	Required
cpuUsagePercentage	integer	Alert if CPU usage is higher than X% in 3 out of 5 samples.	required

The `RdsHighWriteReadLatencyDetectionConfig` object

The configuration of the high RDS write/read latency detection.

Element	Type	Description	Required
enabled	boolean	The detection is enabled (`true`) or disabled (`false`).	required
customThresholds	RdsHighLatencyThresholds	Custom thresholds for high RDS write/read latency. If not set, automatic mode is used	optional

The `RdsHighLatencyThresholds` object

Custom thresholds for high RDS write/read latency. If not set, automatic mode is used

Element	Type	Description	Required
writeReadLatency	integer	Alert if read/write latency is higher than X milliseconds in 3 out of 5 samples.	required

The `RdsLowStorageDetectionConfig` object

The configuration of the low free storage space on RDS detection.

Element	Type	Description	Required
enabled	boolean	The detection is enabled (`true`) or disabled (`false`).	required
customThresholds	RdsLowStorageThresholds	Custom thresholds for low free storage space on RDS. If not set, automatic mode is used.	optional

The `RdsLowStorageThresholds` object

Custom thresholds for low free storage space on RDS. If not set, automatic mode is used.

Element	Type	Description	Required
freeStoragePercentage	integer	Alert if free storage space divided by allocated storage is lower than X% in 3 out of 5 samples.	required

The `RdsHighMemoryDetectionConfig` object

The configuration of RDS running out of memory detection.

Element Type Description Required

enabled

boolean

The detection is enabled (true) or disabled (false).

required

customThresholds

RdsHighMemoryThresholds

Custom thresholds for RDS running out of memory. If not set, automatic mode is used.

All conditions must be fulfilled to trigger an alert.

optional

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	Required
freeMemory	number	Freeable memory is lower than X Megabytes in 3 out of 5 samples.	required
swapUsage	number	Swap usage is higher than X Gigabytes in 3 out of 5 samples.	required

The `ElbHighConnectionErrorsDetectionConfig` object

The configuration of the high number of backend connection errors on ELB detection.

Element	Type	Description	Required
enabled	boolean	The detection is enabled (`true`) or disabled (`false`).	required
customThresholds	ElbHighConnectionErrorsThresholds	Custom thresholds for high number of backend connection errors on ELB. If not set, automatic mode is used.	optional

The `ElbHighConnectionErrorsThresholds` object

Custom thresholds for high number of backend connection errors on ELB. If not set, automatic mode is used.

Element	Type	Description	Required
connectionErrorsPerMinute	integer	Alert if number of backend connection errors is higher than X per minute in 3 out of 5 samples.	required

The `RdsRestartsSequenceDetectionConfig` object

The configuration of the restarts sequence on RDS detection.

Element	Type	Description	Required
enabled	boolean	The detection is enabled (`true`) or disabled (`false`).	required
customThresholds	RdsRestartsThresholds	Custom thresholds for restarts sequence on RDS. If not set, automatic mode is used.	optional

The `RdsRestartsThresholds` object

Custom thresholds for restarts sequence on RDS. If not set, automatic mode is used.

Element	Type	Description	Required
restartsPerMinute	integer	Alert if number of restarts is X per minute or higher in 3 out of 20 samples.	required

The `LambdaHighErrorRateDetectionConfig` object

The configuration of the AWS Lambda high error rate detection.

Element	Type	Description	Required
enabled	boolean	The detection is enabled (`true`) or disabled (`false`).	required
customThresholds	LambdaHighErrorRateThresholds	Custom thresholds for AWS Lambda high error rate. If not set, automatic mode is used.	optional

The `LambdaHighErrorRateThresholds` object

Custom thresholds for AWS Lambda high error rate. If not set, automatic mode is used.

Element	Type	Description	Required
failedInvocationsRate	integer	Alert if failed invocations rate is higher than X% in 3 out of 5 samples.	required

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	Required
enabled	boolean	The detection is enabled (`true`) or disabled (`false`).	required
customThresholds	Ec2CandidateCpuSaturationThresholds	Custom thresholds for high CPU saturation on EC2 monitoring candidate. If not set, automatic mode is used.	optional

The `Ec2CandidateCpuSaturationThresholds` object

Custom thresholds for high CPU saturation on EC2 monitoring candidate. If not set, automatic mode is used.

Element	Type	Description	Required
cpuUsagePercentage	integer	Alert if CPU usage is higher than X% in 3 out of 5 samples.	required

Response body JSON model

json
{
  "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:

Anomaly detection config - AWS

Curl

bash
curl -X GET \
  https://mySampleEnv.live.dynatrace.com/api/config/v1/anomalyDetection/aws \
  -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'

Request URL

http
https://mySampleEnv.live.dynatrace.com/api/config/v1/anomalyDetection/aws

Response body

json
{
  "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

AWS anomaly detection API - GET configuration

Authentication

Parameters

Response

Response codes

Response body objects

The AwsAnomalyDetectionConfig object

The ConfigurationMetadata object

The RdsHighCpuDetectionConfig object

The RdsHighCpuThresholds object

The RdsHighWriteReadLatencyDetectionConfig object

The RdsHighLatencyThresholds object

The RdsLowStorageDetectionConfig object

The RdsLowStorageThresholds object

The RdsHighMemoryDetectionConfig object

The RdsHighMemoryThresholds object

The ElbHighConnectionErrorsDetectionConfig object

The ElbHighConnectionErrorsThresholds object

The RdsRestartsSequenceDetectionConfig object

The RdsRestartsThresholds object

The LambdaHighErrorRateDetectionConfig object

The LambdaHighErrorRateThresholds object

The Ec2CandidateCpuSaturationDetectionConfig object

The Ec2CandidateCpuSaturationThresholds object