Settings API - Disk anomaly detection rules schema table

  • Published Dec 05, 2023

Disk anomaly detection rules (builtin:anomaly-detection.disk-rules)

Dynatrace automatically detects infrastructure-related performance anomalies such as low disk-space conditions. Use these settings (and the Infrastructure settings (<your-dynatrace-url>//ui/settings/builtin:anomaly-detection.infrastructure-disks "Visit Infrastructure anomaly detection settings")) to configure detection sensitivity, set alert thresholds, or disable alerting for disks.

Schema IDSchema groupsScope
builtin:anomaly-detection.disk-rules
  • group:anomaly-detection.infrastructure
  • group:anomaly-detection
HOST_GROUP - Host Group
environment
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:anomaly-detection.disk-rules
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:anomaly-detection.disk-rules
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:anomaly-detection.disk-rules

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

PropertyTypeDescriptionRequired
Name
name		text-required
Enabled
enabled		boolean-required
Metric to alert on
metric		enum
  • LOW_DISK_SPACE
  • LOW_INODES
  • READ_TIME_EXCEEDING
  • WRITE_TIME_EXCEEDING
required
Alert if lower than
thresholdPercent		float-required
Alert if higher than
thresholdMilliseconds		float-required
Sample limit
sampleLimit		SampleLimit

Only alert if the threshold was violated in at least n of the last m samples

required
Disk name filter
diskNameFilter		DiskNameFilter

Only apply to disks whose name matches

required
Host filter
tagFilters		set

Only apply to hosts that have the following tags

required
The SampleLimit object
PropertyTypeDescriptionRequired
Minimum number of violating samples
violatingSamples		integer-required
... within the last
samples		integer-required
The DiskNameFilter object
PropertyTypeDescriptionRequired
Operator
operator		enum
  • CONTAINS
  • DOES_NOT_CONTAIN
  • EQUALS
  • DOES_NOT_EQUAL
  • STARTS_WITH
  • DOES_NOT_START_WITH
required
Matching text
value		text-optional