Settings API - Disk options schema table
Disk options (builtin:disk.options)
Disk options settings control the visibility of local disks on your hosts.
Schema ID | Schema groups | Scope |
---|---|---|
builtin:disk.options |
| HOST - HostHOST_GROUP - Host Groupenvironment |
GET | Managed | https://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:disk.options |
SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:disk.options | |
Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:disk.options |
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 |
---|---|---|---|
Show all NFS disksnfsShowAll | boolean | When disabled OneAgent will try to deduplicate some of nfs disks. Disabled by default, applies only to Linux hosts. Requires OneAgent 1.209 or later | required |
Disable NFS disk monitoringdisableNfsDiskMonitoring | boolean | Deactivate NFS monitoring on all supported systems | required |
Exclude disksexclusions | DiskComplex[] | OneAgent automatically detects and monitors all your mount points, however you can create exception rules to remove disks from the monitoring list. Certain filesystems are always excluded as monitoring of them is not useful. For example, autofs, proc, cgroup, tmpfs. | required |
The DiskComplex
object
Property | Type | Description | Required |
---|---|---|---|
Operating systemos | enum |
| required |
Disk or mount point pathmountpoint | text | Disk or mount point path field: the path to where the disk to be excluded from monitoring is mounted. Examples:
⚠️ Mount point paths are case sensitive! The wildcard in /staff/* means to exclude every child folder of /staff. The wildcard in /disk* means to exclude every mount point starting with /disk, for example /disk1, /disk99, /diskabc | optional |
File system typefilesystem | text | File system type field: the type of the file system to be excluded from monitoring. Examples:
⚠️ File system types are case sensitive! The wildcard in the last example means to exclude matching file systems such as types ext4 and ext3 | optional |