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 the 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	Description
200	Success

Response body

Response parametersJSON model

The HostsAnomalyDetectionConfig object

Configuration of anomaly detection for hosts.

Element	Type	Description
metadata	ConfigurationMetadata
connectionLostDetection	ConnectionLostDetectionConfig
highCpuSaturationDetection	HighCpuSaturationDetectionConfig
highMemoryDetection	HighMemoryDetectionConfig
highGcActivityDetection	HighGcActivityDetectionConfig
outOfMemoryDetection	OutOfMemoryDetectionConfig
outOfThreadsDetection	OutOfThreadsDetectionConfig
networkDroppedPacketsDetection	NetworkDroppedPacketsDetectionConfig
networkErrorsDetection	NetworkErrorsDetectionConfig
highNetworkDetection	HighNetworkDetectionConfig
networkTcpProblemsDetection	NetworkTcpProblemsDetectionConfig
networkHighRetransmissionDetection	NetworkHighRetransmissionDetectionConfig
diskLowSpaceDetection	DiskLowSpaceDetectionConfig
diskSlowWritesAndReadsDetection	DiskSlowWritesAndReadsDetectionConfig
diskLowInodesDetection	DiskLowInodesDetectionConfig

The DiskLowInodesDetectionConfig object

Configuration of low disk inodes number detection.

Element	Type	Description
enabled	boolean	The detection is enabled (`true`) or disabled (`false`).
customThresholds	DiskLowInodesThresholds

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.

The DiskSlowWritesAndReadsDetectionConfig object

Configuration of slow running disks detection.

Element	Type	Description
enabled	boolean	The detection is enabled (`true`) or disabled (`false`).
customThresholds	DiskSlowWriteAndReadsThresholds

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 DiskLowSpaceDetectionConfig object

Configuration of low disk space detection.

Element	Type	Description
enabled	boolean	The detection is enabled (`true`) or disabled (`false`).
customThresholds	DiskLowSpaceThresholds

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 NetworkHighRetransmissionDetectionConfig object

Configuration of high retransmission rate detection.

Element	Type	Description
enabled	boolean	The detection is enabled (`true`) or disabled (`false`).
customThresholds	NetworkHighRetransmissionThresholds

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 NetworkTcpProblemsDetectionConfig object

Configuration of TCP connectivity problems detection.

Element	Type	Description
enabled	boolean	The detection is enabled (`true`) or disabled (`false`).
customThresholds	NetworkTcpProblemsThresholds

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 HighNetworkDetectionConfig object

Configuration of high network utilization detection.

Element	Type	Description
enabled	boolean	The detection is enabled (`true`) or disabled (`false`).
customThresholds	HighNetworkThresholds

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 NetworkErrorsDetectionConfig object

Configuration of high number of network errors detection.

Element	Type	Description
enabled	boolean	The detection is enabled (`true`) or disabled (`false`).
customThresholds	NetworkErrorsThresholds

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 NetworkDroppedPacketsDetectionConfig object

Configuration of high number of dropped packets detection.

Element	Type	Description
enabled	boolean	The detection is enabled (`true`) or disabled (`false`).
customThresholds	NetworkDroppedPacketsThresholds

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 OutOfThreadsDetectionConfig object

Configuration of Java out of threads problems detection.

Element	Type	Description
enabled	boolean	The detection is enabled (`true`) or disabled (`false`).
customThresholds	OutOfThreadsThresholds

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 OutOfMemoryDetectionConfig object

Configuration of Java out of memory problems detection.

Element	Type	Description
enabled	boolean	The detection is enabled (`true`) or disabled (`false`).
customThresholds	OutOfMemoryThresholds

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 HighGcActivityDetectionConfig object

Configuration of high Garbage Collector activity detection.

Element	Type	Description
enabled	boolean	The detection is enabled (`true`) or disabled (`false`).
customThresholds	HighGcActivityThresholds

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 HighMemoryDetectionConfig object

Configuration of high memory usage detection.

Element	Type	Description
enabled	boolean	The detection is enabled (`true`) or disabled (`false`).
customThresholds	HighMemoryThresholds

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 HighCpuSaturationDetectionConfig object

Configuration of high CPU saturation detection

Element	Type	Description
enabled	boolean	The detection is enabled (`true`) or disabled (`false`).
customThresholds	HighCpuSaturationThresholds

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 ConnectionLostDetectionConfig object

Configuration of lost connection detection.

Element	Type	Description
enabled	boolean	The detection is enabled (`true`) or disabled (`false`).
enabledOnGracefulShutdowns	boolean	Alert (`true`) on graceful host shutdowns.

The ConfigurationMetadata object

Metadata useful for debugging

Element	Type	Description
configurationVersions	integer[]	A sorted list of the version numbers of the configuration.
currentConfigurationVersions	string[]	A sorted list of version numbers of the configuration.
clusterVersion	string	Dynatrace version.

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

Anomaly detection config - hosts

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