VMware anomaly detection API - GET configuration
Gets the configuration of anomaly detection for VMware.
The request produces an application/json payload.
| GET | SaaS | https://{your-environment-id}.live.dynatrace.com/api/config/v1/anomalyDetection/vmware |
| Environment ActiveGate | https://{your-activegate-domain}:9999/e/{your-environment-id}/api/config/v1/anomalyDetection/vmware |
Authentication
To execute this request, you need an access token with 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
Response body objects
The VMwareAnomalyDetectionConfig object
The configuration of the anomaly detection for VMware.
The configuration of the high number of dropped packets detection.
The configuration of the CPU saturation on ESXi host detection.
The configuration of the memory saturation on ESXi host detection.
The configuration of the guest CPU limit reached configuration detection.
The configuraiton of the low datastore free space detection.
The cofiguration of the overloaded storage on physical storage device detection.
The configuraiton of the physical storage device running slow detection.
Undersized storage device detection cofing
The DroppedPacketsDetectionConfig object
The configuration of the high number of dropped packets detection.
Custom thresholds for high number of dropped packets. If not set then the automatic mode is used.
The detection is enabled (true) or disabled (false).
The DroppedPacketsThresholds object
Custom thresholds for high number of dropped packets. If not set then the automatic mode is used.
Alert if receive/transmit dropped packets rate on NIC is higher than X packets per second in 3 out of 5 samples.
The EsxiHighCpuSaturationConfig object
The configuration of the CPU saturation on ESXi host detection.
Custom thresholds for CPU saturation detection on ESXi. If not set then the automatic mode is used.
All conditions must be fulfilled to trigger an alert.
The detection is enabled (true) or disabled (false).
The EsxiHighCpuThresholds object
Custom thresholds for CPU saturation detection on ESXi. If not set then the automatic mode is used.
All conditions must be fulfilled to trigger an alert.
At least one peak higher than X% occurred in 3 out of 5 samples.
CPU usage is higher than X% in 3 out of 5 samples.
VM CPU ready is higher than X% in 3 out of 5 samples.
The EsxiHighMemoryDetectionConfig object
The configuration of the memory saturation on ESXi host detection.
Custom thresholds for memory saturation on ESXi host. If not set then the automatic mode is used.
The detection is enabled (true) or disabled (false).
The EsxiHighMemoryThresholds object
Custom thresholds for memory saturation on ESXi host. If not set then the automatic mode is used.
Alert if ESXi host swap IN/OUT or compression/decompression rate is higher X kilobytes per second in 3 out of 5 samples.
The GuestCPULimitReachedConfig object
The configuration of the guest CPU limit reached configuration detection.
Custom thresholds for guest CPU limit detection. If not set then the automatic mode is used.
All conditions must be fulfilled to trigger an alert.
The detection is enabled (true) or disabled (false).
The GuestCPULimitThresholds object
Custom thresholds for guest CPU limit detection. If not set then the automatic mode is used.
All conditions must be fulfilled to trigger an alert.
Hypervisor CPU usage is higher than X% in 3 out of 5 samples.
VM CPU ready is higher than X% occurred in 3 out of 5 samples.
VM CPU usage (VM CPU Usage Mhz / VM CPU limit in Mhz) is higher than X% in 3 out of 5 samples.
The LowDatastoreSpaceDetectionConfig object
The configuraiton of the low datastore free space detection.
Custom thresholds for low datastore free space. If not set then the automatic mode is used.
The detection is enabled (true) or disabled (false).
The LowDatastoreSpaceThresholds object
Custom thresholds for low datastore free space. If not set then the automatic mode is used.
Alert if datastore free space is lower than X%.
The ConfigurationMetadata object
Metadata useful for debugging
Dynatrace version.
A sorted list of the version numbers of the configuration.
A sorted list of version numbers of the configuration.
The OverloadedStorageDetectionConfig object
The cofiguration of the overloaded storage on physical storage device detection.
Custom thresholds for overloaded storage on physical storage device. If not set then the automatic mode is used.
The detection is enabled (true) or disabled (false).
The OverloadedStorageThresholds object
Custom thresholds for overloaded storage on physical storage device. If not set then the automatic mode is used.
Alert if number of command aborts is higher than X in 3 out of 5 samples.
The SlowPhysicalStorageDetectionConfig object
The configuraiton of the physical storage device running slow detection.
Custom thresholds for slow running physical storage device. If not set then the automatic mode is used.
Fulfillment of any condition triggers an alert.
The detection is enabled (true) or disabled (false).
The SlowPhysicalStorageThresholds object
Custom thresholds for slow running physical storage device. If not set then the automatic mode is used.
Fulfillment of any condition triggers an alert.
Read/write latency is higher than X milliseconds in 4 out of 5 samples.
Peak value for read/write latency is higher than X milliseconds in 4 out of 5 samples.
The UndersizedStorageDetectionConfig object
Undersized storage device detection cofing
Custom thresholds for undersized storage device. If not set then the automatic mode is used.
Fulfillment of any condition triggers an alert.
The detection is enabled (true) or disabled (false).
The UndersizedStorageThresholds object
Custom thresholds for undersized storage device. If not set then the automatic mode is used.
Fulfillment of any condition triggers an alert.
Average queue command latency is higher than X milliseconds in 3 out of 5 samples.
Peak queue command latency is higher than X milliseconds in 3 out of 5 samples.
Response body JSON model
{"droppedPacketsDetection": {"customThresholds": {"droppedPacketsPerSecond": 4},"enabled": true},"esxiHighCpuSaturation": {"customThresholds": {"cpuPeakPercentage": 90,"cpuUsagePercentage": 80,"vmCpuReadyPercentage": 10},"enabled": true},"esxiHighMemoryDetection": {"customThresholds": {"compressionDecompressionRate": 120},"enabled": true},"lowDatastoreSpaceDetection": {"customThresholds": {"freeSpacePercentage": 5},"enabled": true},"metadata": {"clusterVersion": "Mock version","configurationVersions": [4,2]},"overloadedStorageDetection": {"customThresholds": {"commandAbortsNumber": 1},"enabled": true},"slowPhysicalStorageDetection": {"customThresholds": {"avgReadWriteLatency": 150,"peakReadWriteLatency": 400},"enabled": true},"undersizedStorageDetection": {"customThresholds": {"averageQueueCommandLatency": 15,"peakQueueCommandLatency": 160},"enabled": true}}
Example
In this example, the request lists the current configuration of anomaly detection for VMware.
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/vmware \-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'
Request URL
https://mySampleEnv.live.dynatrace.com/api/config/v1/anomalyDetection/vmware
Response body
{"metadata": {"clusterVersion": "1.164.0.20190204-124711","configurationVersions": [1]},"esxiHighCpuSaturation": {"enabled": true},"esxiHighMemoryDetection": {"enabled": true},"overloadedStorageDetection": {"enabled": true},"undersizedStorageDetection": {"enabled": true},"slowPhysicalStorageDetection": {"enabled": true},"droppedPacketsDetection": {"enabled": true},"lowDatastoreSpaceDetection": {"enabled": true}}
Response code
200