Collect metrics related to disk usage and IO.
The disk check is included in the Datadog Agent package, so you don't need to install anything else on your server.
The Disk check is enabled by default, and the Agent collects metrics on all local partitions. To configure the check with custom options, edit the disk.d/conf.yaml
file, in the conf.d/
folder at the root of your Agent's configuration directory. See the sample disk.d/conf.yaml for all available configuration options.
There are three scenarios where the Disk check can be used:
- Monitoring physical drives
Monitoring physical drives that are represented by a disk letter (for example. C:, D:, etc.) is supported out of the box by the disk check without any special considerations.
- Monitoring nested mount points
Monitoring mounted folders within a filesystem requires Administrator permissions. This is because the underlying Windows function call FindFirstVolumeMountPoint requires administrative permissions. To collect those metrics without granting Administrator permissions to the Agent, use the PDH check to collect mount point metrics from the corresponding perf counters.
- Monitoring file shares
Collecting mount point metrics for file shares on Windows is only supported by using the create_mounts
option in the configuration.
On Windows, each mounted folder is only visible to the user who mounted the share.
Therefore, the create_mounts
option allows the Agent to create the mount points to monitor in the context of the Agent's user.
Run the Agent's status
subcommand and look for disk
under the Checks section.
See metadata.csv for a list of metrics provided by this integration.
The Disk check does not include any events.
See service_checks.json for a list of service checks provided by this integration.
Need help? Contact Datadog support.