Présentation

Ce check permet de surveiller la santé du cluster, le volume et le statut des briques de Red Hat Gluster Storage avec l’Agent Datadog. Cette intégration GlusterFS est compatible avec les versions de GlusterFS open source ou issues de vendoring.

Configuration

Suivez les instructions ci-dessous pour installer et configurer ce check lorsque l’Agent est exécuté sur un host. Consultez la documentation relative aux modèles d’intégration Autodiscovery pour découvrir comment appliquer ces instructions à des environnements conteneurisés.

Installation

Le check GlusterFS est inclus avec le package de l’Agent Datadog. Vous n’avez rien d’autre à installer sur votre serveur.

Configuration

1. Modifiez le fichier glusterfs.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 GlusterFS. Consultez le fichier d’exemple glusterfs.d/conf.yaml pour découvrir toutes les options de configuration disponibles.

   init_config:
   
    ## @param gstatus_path - string - optional - default: /opt/datadog-agent/embedded/sbin/gstatus
    ## Path to the gstatus command.
    ##
    ## A version of the gstatus is shipped with the Agent binary.
    ## If you are using a source install, specify the location of gstatus.
    #
    # gstatus_path: /opt/datadog-agent/embedded/sbin/gstatus
   
    instances:
      -
        ## @param min_collection_interval - number - optional - default: 60
        ## The GlusterFS integration collects cluster-wide metrics which can put additional workload on the server.
        ## Increase the collection interval to reduce the frequency.
        ##
        ## This changes the collection interval of the check. For more information, see:
        ## https://docs.datadoghq.com/developers/write_agent_check/#collection-interval
        #
        min_collection_interval: 60
   

   REMARQUE : par défaut, gstatus appelle la commande gluster en interne, ce qui nécessite une exécution en tant que superuser. Ajoutez une ligne semblable à ce qui suit dans votre fichier sudoers :

    dd-agent ALL=(ALL) NOPASSWD:/path/to/your/gstatus
   

   Si votre environnement GlusterFS ne nécessite pas de root, définissez l’option de configuration use_sudo sur false.

2. Redémarrez l’Agent.

Collecte de logs

1. La collecte de logs est désactivée par défaut dans l’Agent Datadog. Vous devez l’activer dans datadog.yaml :

   logs_enabled: true
   

2. Modifiez ce bloc de configuration dans votre fichier glusterfs.d/conf.yaml pour commencer à recueillir vos logs GlusterFS :

   logs:
     - type: file
       path: /var/log/glusterfs/glusterd.log
       source: glusterfs
     - type: file
       path: /var/log/glusterfs/cli.log
       source: glusterfs
   

Modifiez la valeur du paramètre path en fonction de votre environnement. Consultez le fichier d’exemple conf.yaml pour découvrir toutes les options de configuration disponibles.

3. Redémarrez l’Agent.

Pour découvrir comment configurer l’Agent afin de recueillir des logs dans des environnements Kubernetes, consultez la section Collecte de logs Kubernetes.

Validation

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

Données collectées

Métriques

Événements

GlusterFS n’inclut aucun événement.

Checks de service

glusterfs.brick.health
Returns CRITICAL if the sub volume is ‘degraded’. Returns OK if ‘up’.
Statuses: ok, critical, warning

glusterfs.volume.health
Returns CRITICAL if the volume is ‘degraded’. Returns OK if ‘up’.
Statuses: ok, critical, warning

glusterfs.cluster.health
Returns CRITICAL if the volume is ‘degraded’. Returns OK otherwise.
Statuses: ok, critical, warning

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.