Directory

Supported OS Linux Mac OS Windows

Intégration1.13.0

Présentation

Capturez des métriques à partir des répertoires et des fichiers de votre choix. L’Agent recueille les éléments suivants :

  • Le nombre de fichiers
  • La taille des fichiers
  • La date de dernière modification
  • La date de création

Configuration

Installation

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

Configuration

  1. Modifiez le fichier directory.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent pour commencer à recueillir vos données de performance Directory. Consultez le fichier d’exemple directory.d/conf.yaml pour découvrir toutes les options de configuration disponibles.

    init_config:
    
    instances:
      ## @param directory - string - required
      ## The directory to monitor. On windows, please make sure you escape back-slashes otherwise the YAML
      ## parser fails (eg. - directory: "C:\\Users\\foo\\Downloads").
      #
      - directory: "<DIRECTORY_PATH>"
    

    Vérifiez que l’utilisateur qui exécute le processus de l’Agent (généralement, datadog-agent) dispose d’un accès en lecture aux répertoires, sous-répertoires et fichiers que vous configurez.

    Remarque : sur Windows, lorsque vous ajoutez votre répertoire, utilisez deux barres obliques (C:\\chemin\\vers\\répertoire) au lieu d’une seule (C:\chemin\vers\répertoire) pour exécuter le check, ceci afin d’éviter que le check Directory échoue et que la traceback se termine par l’erreur found unknown escape character in "<chaîne>" signalant un problème de caractère d’échappement inconnu.

  2. Redémarrez l’Agent.

Validation

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

Données collectées

Métriques

system.disk.directory.bytes
(gauge)
Total size of the directory
Shown as byte
system.disk.directory.file.bytes
(gauge)
Total size of the file
Shown as byte
system.disk.directory.file.created_sec_ago
(gauge)
Duration since creation
Shown as second
system.disk.directory.file.modified_sec_ago
(gauge)
Duration since last modification
Shown as second
system.disk.directory.files
(gauge)
Number of files in the directory
Shown as file
system.disk.directory.folders
(gauge)
Number of folders in the directory
Shown as file

Événements

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

Checks de service

system.disk.directory.exists
Returns WARNING if the Agent is unable to find or access the directory to monitor, OK otherwise.
Statuses: ok, warning

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.

PREVIEWING: may/unit-testing