Host anomaly detection API - GET configuration
Gets the configuration of anomaly detection for hosts.
The request produces an application/json
payload.
GET | Managed | https://{your-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/hosts |
SaaS | https://{your-environment-id}.live.dynatrace.com/api/config/v1/anomalyDetection/hosts | |
Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/hosts |
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 | Hosts | Success |
Response body objects
The HostsAnomalyDetectionConfig
object
Configuration of anomaly detection for hosts.
Element | Type | Description |
---|---|---|
metadata | Configuration | Metadata useful for debugging Can be |
connectionLostDetection | Connection | Configuration of lost connection detection. |
highCpuSaturationDetection | High | Configuration of high CPU saturation detection |
highMemoryDetection | High | Configuration of high memory usage detection. |
highGcActivityDetection | High | Configuration of high Garbage Collector activity detection. |
outOfMemoryDetection | Out | Configuration of Java out of memory problems detection. |
outOfThreadsDetection | Out | Configuration of Java out of threads problems detection. |
networkDroppedPacketsDetection | Network | Configuration of high number of dropped packets detection. |
networkErrorsDetection | Network | Configuration of high number of network errors detection. |
highNetworkDetection | High | Configuration of high network utilization detection. |
networkTcpProblemsDetection | Network | Configuration of TCP connectivity problems detection. |
networkHighRetransmissionDetection | Network | Configuration of high retransmission rate detection. |
diskLowSpaceDetection | Disk | Configuration of low disk space detection. |
diskSlowWritesAndReadsDetection | Disk | Configuration of slow running disks detection. |
diskLowInodesDetection | Disk | Configuration of low disk inodes number 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 ConnectionLostDetectionConfig
object
Configuration of lost connection detection.
Element | Type | Description |
---|---|---|
enabled | boolean | The detection is enabled ( |
enabledOnGracefulShutdowns | boolean | Alert ( |
The HighCpuSaturationDetectionConfig
object
Configuration of high CPU saturation detection
Element | Type | Description |
---|---|---|
enabled | boolean | The detection is enabled ( |
customThresholds | High | Custom thresholds for high CPU saturation. If not set then the automatic mode is used. Can be |
The HighCpuSaturationThresholds
object
Custom thresholds for high CPU saturation. If not set then the automatic mode is used.
Element | Type | Description |
---|---|---|
cpuSaturation | integer | Alert if CPU usage is higher than X% in 3 out of 5 samples. |
The HighMemoryDetectionConfig
object
Configuration of high memory usage detection.
Element | Type | Description |
---|---|---|
enabled | boolean | The detection is enabled ( |
customThresholds | High | Custom thresholds for high memory usage. If not set then the automatic mode is used. Both conditions must be met to trigger an alert. Can be |
The HighMemoryThresholds
object
Custom thresholds for high memory usage. If not set then the automatic mode is used.
Both conditions must be met to trigger an alert.
Element | Type | Description |
---|---|---|
pageFaultsPerSecondWindows | integer | Memory page fault rate is higher than X faults per second on Windows. |
usedMemoryPercentageWindows | integer | Memory usage is higher than X% on Windows. |
pageFaultsPerSecondNonWindows | integer | Memory page fault rate is higher than X faults per second on Linux. |
usedMemoryPercentageNonWindows | integer | Memory usage is higher than X% on Linux. |
The HighGcActivityDetectionConfig
object
Configuration of high Garbage Collector activity detection.
Element | Type | Description |
---|---|---|
enabled | boolean | The detection is enabled ( |
customThresholds | High | Custom thresholds for high GC activity. If not set, automatic mode is used. Meeting any of these conditions triggers an alert. Can be |
The HighGcActivityThresholds
object
Custom thresholds for high GC activity. If not set, automatic mode is used.
Meeting any of these conditions triggers an alert.
Element | Type | Description |
---|---|---|
gcTimePercentage | integer | GC time is higher than X% in 3 out of 5 samples. |
gcSuspensionPercentage | integer | GC suspension is higher than X% in 3 out of 5 samples. |
The OutOfMemoryDetectionConfig
object
Configuration of Java out of memory problems detection.
Element | Type | Description |
---|---|---|
enabled | boolean | The detection is enabled ( |
customThresholds | Out | Custom thresholds for Java out of memory. If not set, automatic mode is used. Can be |
The OutOfMemoryThresholds
object
Custom thresholds for Java out of memory. If not set, automatic mode is used.
Element | Type | Description |
---|---|---|
outOfMemoryExceptionsNumber | integer | Alert if the number of Java out of memory exceptions is X per minute or higher. |
The OutOfThreadsDetectionConfig
object
Configuration of Java out of threads problems detection.
Element | Type | Description |
---|---|---|
enabled | boolean | The detection is enabled ( |
customThresholds | Out | Custom thresholds for Java out of threads detection. If not set, automatic mode is used. Can be |
The OutOfThreadsThresholds
object
Custom thresholds for Java out of threads detection. If not set, automatic mode is used.
Element | Type | Description |
---|---|---|
outOfThreadsExceptionsNumber | integer | Alert if the number of Java out of threads exceptions is X per minute or higher. |
The NetworkDroppedPacketsDetectionConfig
object
Configuration of high number of dropped packets detection.
Element | Type | Description |
---|---|---|
enabled | boolean | The detection is enabled ( |
customThresholds | Network | Custom thresholds for dropped packets. If not set, automatic mode is used. All of these conditions must be met to trigger an alert. Can be |
The NetworkDroppedPacketsThresholds
object
Custom thresholds for dropped packets. If not set, automatic mode is used.
All of these conditions must be met to trigger an alert.
Element | Type | Description |
---|---|---|
droppedPacketsPercentage | integer | Receive/transmit dropped packet percentage is higher than X% in 3 out of 5 samples. |
totalPacketsRate | integer | Total receive/transmit packets rate is higher than X packets per second in 3 out of 5 samples. |
The NetworkErrorsDetectionConfig
object
Configuration of high number of network errors detection.
Element | Type | Description |
---|---|---|
enabled | boolean | The detection is enabled ( |
customThresholds | Network | Custom thresholds for network errors. If not set, automatic mode is used. All of these conditions must be met to trigger an alert. Can be |
The NetworkErrorsThresholds
object
Custom thresholds for network errors. If not set, automatic mode is used.
All of these conditions must be met to trigger an alert.
Element | Type | Description |
---|---|---|
errorsPercentage | integer | Receive/transmit error packet percentage is higher than X% in 3 out of 5 samples. |
totalPacketsRate | integer | Total receive/transmit packets rate is higher than X packets per second in 3 out of 5 samples. |
The HighNetworkDetectionConfig
object
Configuration of high network utilization detection.
Element | Type | Description |
---|---|---|
enabled | boolean | The detection is enabled ( |
customThresholds | High | Custom thresholds for high network utilization. If not set, automatic mode is used. Can be |
The HighNetworkThresholds
object
Custom thresholds for high network utilization. If not set, automatic mode is used.
Element | Type | Description |
---|---|---|
utilizationPercentage | integer | Alert if sent/received traffic utilization is higher than X% in 3 out of 5 samples. |
The NetworkTcpProblemsDetectionConfig
object
Configuration of TCP connectivity problems detection.
Element | Type | Description |
---|---|---|
enabled | boolean | The detection is enabled ( |
customThresholds | Network | Custom thresholds for TCP connection problems. If not set, automatic mode is used. All of these conditions must be met to trigger an alert. Can be |
The NetworkTcpProblemsThresholds
object
Custom thresholds for TCP connection problems. If not set, automatic mode is used.
All of these conditions must be met to trigger an alert.
Element | Type | Description |
---|---|---|
newConnectionFailuresPercentage | integer | Percentage of new connection failures is higher than X% in 3 out of 5 samples. |
failedConnectionsNumberPerMinute | integer | Number of failed connections is higher than X connections per minute in 3 out of 5 samples. |
The NetworkHighRetransmissionDetectionConfig
object
Configuration of high retransmission rate detection.
Element | Type | Description |
---|---|---|
enabled | boolean | The detection is enabled ( |
customThresholds | Network | Custom thresholds for high retransmission rate. If not set, automatic mode is used. All of these conditions must be met to trigger an alert. Can be |
The NetworkHighRetransmissionThresholds
object
Custom thresholds for high retransmission rate. If not set, automatic mode is used.
All of these conditions must be met to trigger an alert.
Element | Type | Description |
---|---|---|
retransmissionRatePercentage | integer | Retransmission rate is higher than X% in 3 out of 5 samples. |
retransmittedPacketsNumberPerMinute | integer | Number of retransmitted packets is higher than X packets per minute in 3 out of 5 samples. |
The DiskLowSpaceDetectionConfig
object
Configuration of low disk space detection.
Element | Type | Description |
---|---|---|
enabled | boolean | The detection is enabled ( |
customThresholds | Disk | Custom thresholds for low disk space. If not set, automatic mode is used. Can be |
The DiskLowSpaceThresholds
object
Custom thresholds for low disk space. If not set, automatic mode is used.
Element | Type | Description |
---|---|---|
freeSpacePercentage | integer | Alert if free disk space is lower than X% in 3 out of 5 samples. |
The DiskSlowWritesAndReadsDetectionConfig
object
Configuration of slow running disks detection.
Element | Type | Description |
---|---|---|
enabled | boolean | The detection is enabled ( |
customThresholds | Disk | Custom thresholds for slow running disks. If not set, the automatic mode is used. Can be |
The DiskSlowWriteAndReadsThresholds
object
Custom thresholds for slow running disks. If not set, the automatic mode is used.
Element | Type | Description |
---|---|---|
writeAndReadTime | integer | Alert if disk read/write time is higher than X milliseconds in 3 out of 5 samples. |
The DiskLowInodesDetectionConfig
object
Configuration of low disk inodes number detection.
Element | Type | Description |
---|---|---|
enabled | boolean | The detection is enabled ( |
customThresholds | Disk | Custom thresholds for low disk inodes number. If not set, automatic mode is used. Can be |
The DiskLowInodesThresholds
object
Custom thresholds for low disk inodes number. If not set, automatic mode is used.
Element | Type | Description |
---|---|---|
freeInodesPercentage | integer | Alert if percentage of available inodes is lower than X% in 3 out of 5 samples. |
Response body JSON model
{
"metadata": {
"configurationVersions": [
4,
2
],
"clusterVersion": "Mock version"
},
"connectionLostDetection": {
"enabled": true,
"enabledOnGracefulShutdowns": true
},
"highCpuSaturationDetection": {
"enabled": true,
"customThresholds": {
"cpuSaturation": 90
}
},
"highMemoryDetection": {
"enabled": true,
"customThresholds": {
"pageFaultsPerSecondWindows": 50,
"usedMemoryPercentageWindows": 85,
"pageFaultsPerSecondNonWindows": 10,
"usedMemoryPercentageNonWindows": 85
}
},
"highGcActivityDetection": {
"enabled": true,
"customThresholds": {
"gcTimePercentage": 35,
"gcSuspensionPercentage": 20
}
},
"outOfMemoryDetection": {
"enabled": true,
"customThresholds": {
"outOfMemoryExceptionsNumber": 2
}
},
"outOfThreadsDetection": {
"enabled": true,
"customThresholds": {
"outOfThreadsExceptionsNumber": 2
}
},
"networkDroppedPacketsDetection": {
"enabled": true,
"customThresholds": {
"droppedPacketsPercentage": 8,
"totalPacketsRate": 8
}
},
"networkErrorsDetection": {
"enabled": true,
"customThresholds": {
"errorsPercentage": 9,
"totalPacketsRate": 9
}
},
"highNetworkDetection": {
"enabled": true,
"customThresholds": {
"utilizationPercentage": 88
}
},
"networkTcpProblemsDetection": {
"enabled": true,
"customThresholds": {
"newConnectionFailuresPercentage": 5,
"failedConnectionsNumberPerMinute": 5
}
},
"networkHighRetransmissionDetection": {
"enabled": true,
"customThresholds": {
"retransmissionRatePercentage": 15,
"retransmittedPacketsNumberPerMinute": 15
}
},
"diskLowSpaceDetection": {
"enabled": true,
"customThresholds": {
"freeSpacePercentage": 10
}
},
"diskSlowWritesAndReadsDetection": {
"enabled": true,
"customThresholds": {
"writeAndReadTime": 300
}
},
"diskLowInodesDetection": {
"enabled": true,
"customThresholds": {
"freeInodesPercentage": 10
}
}
}
Example
In this example, the request lists the current configuration of anomaly detection for hosts.
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/hosts \
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'
Request URL
https://mySampleEnv.live.dynatrace.com/api/config/v1/anomalyDetection/hosts
Response body
{
"metadata": {
"clusterVersion": "1.163.5.20190201-130834",
"configurationVersions": [
91
]
},
"connectionLostDetection": {
"enabled": true,
"enabledOnGracefulShutdowns": false
},
"highCpuSaturationDetection": {
"enabled": true
},
"highMemoryDetection": {
"enabled": true
},
"highGcActivityDetection": {
"enabled": true
},
"outOfMemoryDetection": {
"enabled": true
},
"outOfThreadsDetection": {
"enabled": true
},
"networkDroppedPacketsDetection": {
"enabled": true
},
"networkErrorsDetection": {
"enabled": true
},
"highNetworkDetection": {
"enabled": true
},
"networkTcpProblemsDetection": {
"enabled": true
},
"networkHighRetransmissionDetection": {
"enabled": true
},
"diskLowSpaceDetection": {
"enabled": true
},
"diskSlowWritesAndReadsDetection": {
"enabled": true
},
"diskLowInodesDetection": {
"enabled": true
}
}
Response code
200