VMware anomaly detection API - PUT configuration
Updates the configuration of anomaly detection for VMware.
The request consumes an application/json payload.
| PUT | 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 WriteConfig scope.
To learn how to obtain and use it, see Tokens and authentication.
Parameters
JSON body of the request, containing parameters of the VMware anomaly detection configuration.
Request 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.
Request body JSON model
This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.
{"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}}
Response
Response codes
Success. Configuration has been updated. Response doesn't have a body.
Validate payload
We recommend that you validate the payload before submitting it with an actual request. A response code of 204 indicates a valid payload.
The request consumes an application/json payload.
| POST | SaaS | https://{your-environment-id}.live.dynatrace.com/api/config/v1/anomalyDetection/vmware/validator |
| Environment ActiveGate | https://{your-activegate-domain}:9999/e/{your-environment-id}/api/config/v1/anomalyDetection/vmware/validator |
Authentication
To execute this request, you need an access token with WriteConfig scope.
To learn how to obtain and use it, see Tokens and authentication.
Response
Response codes
Validated. The submitted configuration is valid. Response doesn't have a body.
Example
In this example, the request updates the configuration of anomaly detection for VMware from the GET request example. It changes Detect CPU saturation ESXi host mode to based on custom thresholds and sets the following thresholds:
- Alert if CPU usage is higher than 90%
- AND VM CPU ready is higher than 12%
- AND at least one peak higher than 98% occurred in 3 out of 5 samples.
The API token is passed in the Authorization header.
You can download or copy the example request body to try it out on your own. Be sure to create a backup copy of your current configuration with the GET VMware anomaly detection configuration call.
Curl
curl -X PUT \https://mySampleEnv.live.dynatrace.com/api/config/v1/anomalyDetection/vmware \-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \-H 'Content-Type: application/json' \-d '{"esxiHighCpuSaturation": {"enabled": true,"customThresholds": {"cpuUsagePercentage": 90,"vmCpuReadyPercentage": 12,"cpuPeakPercentage": 98}},"esxiHighMemoryDetection": {"enabled": true},"overloadedStorageDetection": {"enabled": true},"undersizedStorageDetection": {"enabled": true},"slowPhysicalStorageDetection": {"enabled": true},"droppedPacketsDetection": {"enabled": true},"lowDatastoreSpaceDetection": {"enabled": true}}'
Request URL
https://mySampleEnv.live.dynatrace.com/api/config/v1/anomalyDetection/vmware
Request body
{"esxiHighCpuSaturation": {"enabled": true,"customThresholds": {"cpuUsagePercentage": 90,"vmCpuReadyPercentage": 12,"cpuPeakPercentage": 98}},"esxiHighMemoryDetection": {"enabled": true},"overloadedStorageDetection": {"enabled": true},"undersizedStorageDetection": {"enabled": true},"slowPhysicalStorageDetection": {"enabled": true},"droppedPacketsDetection": {"enabled": true},"lowDatastoreSpaceDetection": {"enabled": true}}
Response code
204
Result
The updated configuration has the following parameters:
