• Home
  • Dynatrace API
  • Environment
  • Settings
  • Schemas
  • Anomaly detection for infrastructure - host

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 IDSchema groupsScope
builtin:anomaly-detection.infrastructure-hosts
  • group:anomaly-detection.infrastructure
  • group:anomaly-detection
HOST - Host
HOST_GROUP - Host Group
environment
Retrieve schema via Settings API
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

PropertyLabelTypeDescriptionRequired
hostHostshost-required
networkNetworknetwork-required

Request body objects

The strictEventThresholds object
PropertyLabelTypeDescriptionRequired
violatingSamplesViolating samplesinteger

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

required
violatingEvaluationWindowEvaluation window size for violating samplesinteger

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

required
dealertingSamplesDealerting samplesinteger

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

required
dealertingEvaluationWindowEvaluation window size for dealerting samplesinteger

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

required
The eventThresholds object
PropertyLabelTypeDescriptionRequired
violatingSamplesViolating samplesinteger

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

required
violatingEvaluationWindowEvaluation window size for violating samplesinteger

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

required
dealertingSamplesDealerting samplesinteger

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

required
dealertingEvaluationWindowEvaluation window size for dealerting samplesinteger

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

required
The connectionLostDetection object
PropertyLabelTypeDescriptionRequired
enabledDetect host or monitoring connection lost problemsboolean-required
onGracefulShutdownsGraceful host shutdownsenum-required
The highCpuSaturationDetectionThresholds object
PropertyLabelTypeDescriptionRequired
cpuSaturationAlert if the CPU usage is higher than this threshold for the defined amount of samplesinteger-required
eventThresholds-eventThresholds-required
The highCpuSaturationDetection object
PropertyLabelTypeDescriptionRequired
enabledDetect CPU saturation on hostboolean-required
detectionModeDetection mode for CPU saturationenum-required
customThresholds-highCpuSaturationDetectionThresholds-required
The highMemoryDetectionThresholds object
PropertyLabelTypeDescriptionRequired
usedMemoryPercentageWindowsAlert if the memory usage on Windows is higher than this thresholdinteger-required
usedMemoryPercentageNonWindowsAlert if the memory usage on Unix systems is higher than this thresholdinteger-required
pageFaultsPerSecondWindowsAlert if the memory page fault rate on Windows is higher than this threshold for the defined amount of samplesinteger-required
pageFaultsPerSecondNonWindowsAlert if the memory page fault rate on Unix systems is higher than this threshold for the defined amount of samplesinteger-required
eventThresholds-eventThresholds-required
The highMemoryDetection object
PropertyLabelTypeDescriptionRequired
enabledDetect high memory usage on hostboolean-required
detectionModeDetection mode for high memory usageenum-required
customThresholds-highMemoryDetectionThresholds

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

required
The highGcActivityDetectionThresholds object
PropertyLabelTypeDescriptionRequired
gcTimePercentageAlert if GC time is higher than this thresholdinteger-required
gcSuspensionPercentageAlert if the GC suspension is higher than this thresholdinteger-required
eventThresholds-eventThresholds-required
The highGcActivityDetection object
PropertyLabelTypeDescriptionRequired
enabledDetect high GC activityboolean

You may also configure high GC activity alerting for .NET processes on extensions events page.

required
detectionModeDetection mode for high GC activityenum-required
customThresholds-highGcActivityDetectionThresholds

Alert if the GC time or the GC suspension is exceeded

required
The outOfMemoryDetectionThresholds object
PropertyLabelTypeDescriptionRequired
outOfMemoryExceptionsNumberAlert if the number of Java out-of-memory exceptions is at least this valueinteger-required
eventThresholds-strictEventThresholds-required
The outOfMemoryDetection object
PropertyLabelTypeDescriptionRequired
enabledDetect Java out of memory problemboolean-required
detectionModeDetection mode for Java out of memory problemenum-required
customThresholds-outOfMemoryDetectionThresholds-required
The outOfThreadsDetectionThresholds object
PropertyLabelTypeDescriptionRequired
outOfThreadsExceptionsNumberAlert if the number of Java out-of-threads exceptions is at least this valueinteger-required
eventThresholds-strictEventThresholds-required
The outOfThreadsDetection object
PropertyLabelTypeDescriptionRequired
enabledDetect Java out of threads problemboolean-required
detectionModeDetection mode for Java out of threads problemenum-required
customThresholds-outOfThreadsDetectionThresholds-required
The networkDroppedPacketsDetectionThresholds object
PropertyLabelTypeDescriptionRequired
droppedPacketsPercentageReceive/transmit dropped packet percentage thresholdinteger-required
totalPacketsRateTotal packets rate thresholdinteger-required
eventThresholds-eventThresholds-required
The networkDroppedPacketsDetection object
PropertyLabelTypeDescriptionRequired
enabledDetect high number of dropped packetsboolean-required
detectionModeDetection mode for high number of dropped packetsenum-required
customThresholds-networkDroppedPacketsDetectionThresholds

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 networkErrorsDetectionThresholds object
PropertyLabelTypeDescriptionRequired
errorsPercentageReceive/transmit error packet percentage thresholdinteger-required
totalPacketsRateTotal packets rate thresholdinteger-required
eventThresholds-eventThresholds-required
The networkErrorsDetection object
PropertyLabelTypeDescriptionRequired
enabledDetect high number of network errorsboolean-required
detectionModeDetection mode for high number of network errorsenum-required
customThresholds-networkErrorsDetectionThresholds

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 highNetworkDetectionThresholds object
PropertyLabelTypeDescriptionRequired
errorsPercentageAlert if sent/received traffic utilization is higher than this threshold for the defined amount of samplesinteger-required
eventThresholds-eventThresholds-required
The highNetworkDetection object
PropertyLabelTypeDescriptionRequired
enabledDetect high network utilizationboolean-required
detectionModeDetection mode for high network utilizationenum-required
customThresholds-highNetworkDetectionThresholds-required
The networkTcpProblemsDetectionThresholds object
PropertyLabelTypeDescriptionRequired
newConnectionFailuresPercentageNew connection failure thresholdinteger-required
failedConnectionsNumberPerMinuteNumber of failed connections thresholdinteger-required
eventThresholds-eventThresholds-required
The networkTcpProblemsDetection object
PropertyLabelTypeDescriptionRequired
enabledDetect TCP connectivity problems for processboolean-required
detectionModeDetection mode for TCP connectivity problemsenum-required
customThresholds-networkTcpProblemsDetectionThresholds

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 networkHighRetransmissionDetectionThresholds object
PropertyLabelTypeDescriptionRequired
retransmissionRatePercentageRetransmission rate thresholdinteger-required
retransmittedPacketsNumberPerMinuteNumber of retransmitted packets thresholdinteger-required
eventThresholds-eventThresholds-required
The networkHighRetransmissionDetection object
PropertyLabelTypeDescriptionRequired
enabledDetect high retransmission rateboolean-required
detectionModeDetection mode for high retransmission rateenum-required
customThresholds-networkHighRetransmissionDetectionThresholds

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 highSystemLoadDetectionThresholds object
PropertyLabelTypeDescriptionRequired
systemLoadAlert if the System Load / Logical cpu core is higher than this threshold for the defined amount of samplesfloat-required
eventThresholds-eventThresholds-required
The highSystemLoadDetection object
PropertyLabelTypeDescriptionRequired
enabledDetect High System Load on hostboolean

Detection High System Load is available only on AIX hosts.

required
detectionModeDetection mode for High System Loadenum-required
customThresholds-highSystemLoadDetectionThresholds-required
The host object
PropertyLabelTypeDescriptionRequired
connectionLostDetection-connectionLostDetection-required
highCpuSaturationDetection-highCpuSaturationDetection-required
highSystemLoadDetection-highSystemLoadDetection-required
highMemoryDetection-highMemoryDetection-required
highGcActivityDetection-highGcActivityDetection-required
outOfMemoryDetection-outOfMemoryDetection-required
outOfThreadsDetection-outOfThreadsDetection-required
The network object
PropertyLabelTypeDescriptionRequired
networkDroppedPacketsDetection-networkDroppedPacketsDetection-required
networkErrorsDetection-networkErrorsDetection-required
highNetworkDetection-highNetworkDetection-required
networkTcpProblemsDetection-networkTcpProblemsDetection-required
networkHighRetransmissionDetection-networkHighRetransmissionDetection-required