Disk

Agent Check Check de l'Agent

Supported OS Linux Mac OS Windows

Integrationv4.7.0

Présentation

Recueillez les métriques relatives à l’utilisation du disque et aux E/S.

Configuration

Installation

Le check Disk est inclus avec le package de l’Agent Datadog : vous n’avez donc rien d’autre à installer sur votre serveur.

Configuration

Le check Disk est activé par défaut et l’Agent recueille des métriques sur toutes les partitions locales. Pour configurer le check avec des options personnalisées, modifiez le fichier disk.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent. Consultez le fichier d’exemple disk.d/conf.yaml pour découvrir toutes les options de configuration disponibles.

Remarque concernant les hosts Windows

Le check Disk peut être utilisé dans les trois cas de figure suivants :

  1. Surveillance de lecteurs physiques

Le check Disk prend en charge par défaut la surveillance des lecteurs physiques (qui sont représentés par une lettre, par exemple, C:, D:, etc.). Cette surveillance ne nécessite aucune disposition particulière.

  1. Surveillance de points de montage imbriqués

Pour surveiller des dossiers montés dans un système de fichiers, des autorisations administrateur sont requises. En effet, elles permettent d’effectuer l’appel de la fonction Windows sous-jacente, FindFirstVolumeMountPoint. Pour recueillir ces métriques sans octroyer d’autorisations administrateur à l’Agent, vous pouvez utiliser le check PDH. Cette approche vous permet de recueillir des métriques sur les points de montage à partir des compteurs de performances correspondants.

  1. Surveillances des partages de fichiers

Vous devez impérativement utiliser l’option create_mounts dans la configuration pour recueillir des métriques sur les points de montage pour les partages de fichiers sous Windows. Dans Windows, seul l’utilisateur qui a monté un partage peut consulter le dossier monté. L’option create_mounts permet ainsi à l’Agent de créer des points de montage afin de surveiller le contexte de l’utilisateur de l’Agent.

Validation

Lancez la sous-commande status de l’Agent et cherchez disk dans la section Checks.

Données collectées

Métriques

system.disk.free
(gauge)
The amount of disk space that is free.
Shown as byte
system.disk.in_use
(gauge)
The amount of disk space in use as a fraction of the total.
Shown as fraction
system.disk.read_time
(count)
The time in ms spent reading per device
Shown as millisecond
system.disk.read_time_pct
(gauge)
Percent of time spent reading from disk.
Shown as percent
system.disk.total
(gauge)
The total amount of disk space.
Shown as byte
system.disk.used
(gauge)
The amount of disk space in use.
Shown as byte
system.disk.write_time
(count)
The time in ms spent writing per device.
Shown as millisecond
system.disk.write_time_pct
(gauge)
Percent of time spent writing to disk.
Shown as percent
system.fs.inodes.free
(gauge)
The number of free inodes.
Shown as inode
system.fs.inodes.in_use
(gauge)
The number of inodes in use as a fraction of the total.
Shown as fraction
system.fs.inodes.total
(gauge)
The total number of inodes.
Shown as inode
system.fs.inodes.used
(gauge)
The number of inodes in use.
Shown as inode

Événements

Le check Disk n’inclut aucun événement.

Checks de service

disk.read_write
Renvoie CRITICAL si le système de fichiers est en mode lecture seule.
Statuses: ok, critical, unknown

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.