Settings API - Anomaly detection for infrastructure- Host schema table

Anomaly detection for infrastructure: Host (builtin:anomaly-detection.infrastructure-hosts)

Dynatrace automatically detects infrastructure-related performance anomalies such as high CPU saturation and memory outages. Use these settings to configure detection sensitivity, set alert thresholds, or disable alerting for hosts.

Schema ID
Schema groups
Scope
builtin:anomaly-detection.infrastructure-hosts
  • group:anomaly-detection.infrastructure
  • group:anomaly-detection
HOST - Host
HOST_GROUP - Host Group
environment
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:anomaly-detection.infrastructure-hosts
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:anomaly-detection.infrastructure-hosts
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:anomaly-detection.infrastructure-hosts

Authentication

To execute this request, you need an access token with Read settings (settings.read) scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

Property
Type
Description
Required
Hosts
host
-
required
Network
network
-
required
The host object
Property
Type
Description
Required
connectionLostDetection
-
required
highCpuSaturationDetection
-
required
highSystemLoadDetection
-
required
highMemoryDetection
-
required
highGcActivityDetection
-
required
outOfMemoryDetection
-
required
outOfThreadsDetection
-
required
The network object
Property
Type
Description
Required
networkDroppedPacketsDetection
-
required
networkErrorsDetection
-
required
highNetworkDetection
-
required
networkTcpProblemsDetection
-
required
networkHighRetransmissionDetection
-
required
The connectionLostDetection object
Property
Type
Description
Required
Detect host or monitoring connection lost problems
enabled
boolean
-
required
Graceful host shutdowns
onGracefulShutdowns
enum
  • DONT_ALERT_ON_GRACEFUL_SHUTDOWN
  • ALERT_ON_GRACEFUL_SHUTDOWN
required
The highCpuSaturationDetection object
Property
Type
Description
Required
Detect CPU saturation on host
enabled
boolean

Detection of high CPU saturation is not available on AIX hosts

required
Detection mode for CPU saturation
detectionMode
enum
  • auto
  • custom
required
customThresholds
-
required
The highSystemLoadDetection object
Property
Type
Description
Required
Detect High System Load on host
enabled
boolean

Detection High System Load is available only on AIX hosts.

required
Detection mode for High System Load
detectionMode
enum
  • auto
  • custom
required
customThresholds
-
required
The highMemoryDetection object
Property
Type
Description
Required
Detect high memory usage on host
enabled
boolean
-
required
Detection mode for high memory usage
detectionMode
enum
  • auto
  • custom
required
customThresholds

Alert if both the memory usage and the memory page fault rate thresholds are exceeded on Windows or on Unix systems

required
The highGcActivityDetection object
Property
Type
Description
Required
Detect high GC activity
enabled
boolean

You may also configure high GC activity alerting for .NET processes on extensions events page (<your-dynatrace-url>//#settings/anomalydetection/extensionevents).

required
Detection mode for high GC activity
detectionMode
enum
  • auto
  • custom
required
customThresholds

Alert if the GC time or the GC suspension is exceeded

required
The outOfMemoryDetection object
Property
Type
Description
Required
Detect Java out of memory problem
enabled
boolean
-
required
Detection mode for Java out of memory problem
detectionMode
enum
  • auto
  • custom
required
customThresholds
-
required
The outOfThreadsDetection object
Property
Type
Description
Required
Detect Java out of threads problem
enabled
boolean
-
required
Detection mode for Java out of threads problem
detectionMode
enum
  • auto
  • custom
required
customThresholds
-
required
The networkDroppedPacketsDetection object
Property
Type
Description
Required
Detect high number of dropped packets
enabled
boolean
-
required
Detection mode for high number of dropped packets
detectionMode
enum
  • auto
  • custom
required
customThresholds

Alert if the dropped packet percentage is higher than the specified threshold and the total packets rate is higher than the defined threshold for the defined amount of samples

required
The networkErrorsDetection object
Property
Type
Description
Required
Detect high number of network errors
enabled
boolean
-
required
Detection mode for high number of network errors
detectionMode
enum
  • auto
  • custom
required
customThresholds

Alert if the receive/transmit error packet percentage is higher than the specified threshold and the total packets rate is higher than the defined threshold for the defined amount of samples

required
The highNetworkDetection object
Property
Type
Description
Required
Detect high network utilization
enabled
boolean
-
required
Detection mode for high network utilization
detectionMode
enum
  • auto
  • custom
required
customThresholds
-
required
The networkTcpProblemsDetection object
Property
Type
Description
Required
Detect TCP connectivity problems for process
enabled
boolean
-
required
Detection mode for TCP connectivity problems
detectionMode
enum
  • auto
  • custom
required
customThresholds

Alert if the percentage of new connection failures is higher than the specified threshold and the number of failed connections is higher than the defined threshold for the defined amount of samples

required
The networkHighRetransmissionDetection object
Property
Type
Description
Required
Detect high retransmission rate
enabled
boolean
-
required
Detection mode for high retransmission rate
detectionMode
enum
  • auto
  • custom
required
customThresholds

Alert if the retransmission rate is higher than the specified threshold and the number of retransmitted packets is higher than the defined threshold for the defined amount of samples

required
The highCpuSaturationDetectionThresholds object
Property
Type
Description
Required
Alert if the CPU usage is higher than this threshold for the defined amount of samples
cpuSaturation
integer
-
required
eventThresholds
-
required
The highSystemLoadDetectionThresholds object
Property
Type
Description
Required
Alert if the System Load divided by the number of logical CPU cores is higher than this threshold for the defined amount of samples.
systemLoad
float
-
required
eventThresholds
-
required
The highMemoryDetectionThresholds object
Property
Type
Description
Required
Alert if the memory usage on Windows is higher than this threshold
usedMemoryPercentageWindows
integer
-
required
Alert if the memory usage on Unix systems is higher than this threshold
usedMemoryPercentageNonWindows
integer
-
required
Alert if the memory page fault rate on Windows is higher than this threshold for the defined amount of samples
pageFaultsPerSecondWindows
integer
-
required
Alert if the memory page fault rate on Unix systems is higher than this threshold for the defined amount of samples
pageFaultsPerSecondNonWindows
integer
-
required
eventThresholds
-
required
The highGcActivityDetectionThresholds object
Property
Type
Description
Required
Alert if GC time is higher than this threshold
gcTimePercentage
integer
-
required
Alert if the GC suspension is higher than this threshold
gcSuspensionPercentage
integer
-
required
eventThresholds
-
required
The outOfMemoryDetectionThresholds object
Property
Type
Description
Required
Alert if the number of Java out-of-memory exceptions is at least this value
outOfMemoryExceptionsNumber
integer
-
required
eventThresholds
-
required
The outOfThreadsDetectionThresholds object
Property
Type
Description
Required
Alert if the number of Java out-of-threads exceptions is at least this value
outOfThreadsExceptionsNumber
integer
-
required
eventThresholds
-
required
The networkDroppedPacketsDetectionThresholds object
Property
Type
Description
Required
Receive/transmit dropped packet percentage threshold
droppedPacketsPercentage
integer
-
required
Total packets rate threshold
totalPacketsRate
integer
-
required
eventThresholds
-
required
The networkErrorsDetectionThresholds object
Property
Type
Description
Required
Receive/transmit error packet percentage threshold
errorsPercentage
integer
-
required
Total packets rate threshold
totalPacketsRate
integer
-
required
eventThresholds
-
required
The highNetworkDetectionThresholds object
Property
Type
Description
Required
Alert if sent/received traffic utilization is higher than this threshold for the defined amount of samples
errorsPercentage
integer
-
required
eventThresholds
-
required
The networkTcpProblemsDetectionThresholds object
Property
Type
Description
Required
New connection failure threshold
newConnectionFailuresPercentage
integer
-
required
Number of failed connections threshold
failedConnectionsNumberPerMinute
integer
-
required
eventThresholds
-
required
The networkHighRetransmissionDetectionThresholds object
Property
Type
Description
Required
Retransmission rate threshold
retransmissionRatePercentage
integer
-
required
Number of retransmitted packets threshold
retransmittedPacketsNumberPerMinute
integer
-
required
eventThresholds
-
required
The eventThresholds object
Property
Type
Description
Required
Violating samples
violatingSamples
integer

The number of 10-second samples within the evaluation window that must exceed the threshold to trigger an event

required
Evaluation window size for violating samples
violatingEvaluationWindow
integer

The number of 10-second samples that form the sliding evaluation window to detect violating samples.

required
Dealerting samples
dealertingSamples
integer

The number of 10-second samples within the evaluation window that must be lower than the threshold to close an event

required
Evaluation window size for dealerting samples
dealertingEvaluationWindow
integer

The number of 10-second samples that form the sliding evaluation window for dealerting.

required
The strictEventThresholds object
Property
Type
Description
Required
Violating samples
violatingSamples
integer

The number of 10-second samples within the evaluation window that must exceed the threshold to trigger an event

required
Evaluation window size for violating samples
violatingEvaluationWindow
integer

The number of 10-second samples that form the sliding evaluation window to detect violating samples.

required
Dealerting samples
dealertingSamples
integer

The number of 10-second samples within the evaluation window that must be lower than the threshold to close an event

required
Evaluation window size for dealerting samples
dealertingEvaluationWindow
integer

The number of 10-second samples that form the sliding evaluation window for dealerting.

required