Red Hat Gluster Storage

Supported OS

Versión de la integración3.0.1

Información general

Este check monitoriza la situación, el volumen y el estado de ladrillos del clúster Red Hat Gluster Storage a través del Datadog Agent. Esta integración GlusterFS es compatible con las versiones de código abierto y vendidas por Red Hat de GlusterFS.

Configuración

Sigue las instrucciones a continuación para instalar y configurar este check para un Agent que se ejecuta en un host. Para entornos en contenedores, consulta las plantillas de integración de Autodiscovery para obtener orientación sobre la aplicación de estas instrucciones.

Instalación

El check de GlusterFS está incluido en el paquete del Datadog Agent . No es necesaria ninguna instalación adicional en tu servidor.

Configuración

  1. Edita el archivo glusterfs.d/conf.yaml, que se encuentra en la carpeta conf.d/ en la raíz del directorio de configuración de tu Agent, para empezar a recopilar los datos de rendimiento de tu GlusterFS. Para conocer todas las opciones de configuración disponibles, consulta el glusterfs.d/conf.yaml de ejemplo.

    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
    

    NOTA: Por defecto, gstatus llama internamente al comando gluster que requiere ser ejecutado como superusuario. Añade una línea como la siguiente a tu archivo sudoers:

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

    Si tu entorno GlusterFS no requiere raíz, define la opción de configuración use_sudo como false.

  2. Reinicia el Agent.

Recopilación de logs

  1. La recopilación de logs se encuentra deshabilitada de manera predeterminada en el Datadog Agent. Habilítala en tu archivo datadog.yaml:

    logs_enabled: true
    
  2. Edita este bloque de configuración en tu archivo glusterfs.d/conf.yaml para empezar a recopilar tus logs de GlusterFS:

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

Cambia el valor del parámetro path en función de tu entorno. Para ver todas las opciones de configuración disponibles, consulta el conf.yaml de ejemplo.

  1. Reinicia el Agent.

Para obtener más información sobre cómo configurar el Agent para la recopilación de logs en entornos Kubernetes, consulta Recopilación de logs de Kubernetes.

Validación

Ejecuta el subcomando de estado del Agent y busca glusterfs en la sección Checks.

Datos recopilados

Métricas

glusterfs.brick.block_size
(gauge)
Block Size of brick
Shown as byte
glusterfs.brick.inodes.free
(gauge)
Free inodes in brick
Shown as byte
glusterfs.brick.inodes.total
(gauge)
Total inodes in brick
Shown as byte
glusterfs.brick.inodes.used
(gauge)
Inode used in brick
Shown as byte
glusterfs.brick.online
(gauge)
Number of bricks online
Shown as unit
glusterfs.brick.size.free
(gauge)
Brick size free
Shown as byte
glusterfs.brick.size.total
(gauge)
Total brick size
Shown as byte
glusterfs.brick.size.used
(gauge)
Current bytes used in brick
Shown as byte
glusterfs.cluster.nodes.active
(gauge)
Current active nodes
Shown as node
glusterfs.cluster.nodes.count
(gauge)
Total number of nodes in cluster
Shown as node
glusterfs.cluster.volumes.count
(gauge)
Number of volumes in cluster
Shown as unit
glusterfs.cluster.volumes.started
(gauge)
Number of volumes started in cluster
Shown as unit
glusterfs.subvol.disperse
(gauge)
Disperse count of subvolume
Shown as unit
glusterfs.subvol.disperse_redundancy
(gauge)
Disperse redundancy of subvolume
Shown as unit
glusterfs.subvol.replica
(gauge)
Replicas in subvolume
Shown as unit
glusterfs.volume.bricks.count
(gauge)
Number of bricks in volume
Shown as unit
glusterfs.volume.disperse
(gauge)
Number of dispersed in volume
Shown as unit
glusterfs.volume.disperse_redundancy
(gauge)
Number of disperse redundancy in volume
Shown as unit
glusterfs.volume.distribute
(gauge)
Number of distributed
Shown as unit
glusterfs.volume.inodes.free
(gauge)
Inodes free in volume
Shown as byte
glusterfs.volume.inodes.total
(gauge)
Total size inodes in volume
Shown as byte
glusterfs.volume.inodes.used
(gauge)
Used bytes of inodes in volume
Shown as byte
glusterfs.volume.online
(gauge)
Number of volumes online
Shown as unit
glusterfs.volume.replica
(gauge)
Replicas in volumes
Shown as unit
glusterfs.volume.size.free
(gauge)
Bytes free in volume
Shown as byte
glusterfs.volume.size.total
(gauge)
Bytes total in volume
Shown as byte
glusterfs.volume.size.used
(gauge)
Bytes used in volume
Shown as byte
glusterfs.volume.snapshot.count
(gauge)
number of snapshots of volume
Shown as byte
glusterfs.volume.used.percent
(gauge)
percentage of volume used
Shown as percent

Eventos

GlusterFS no incluye eventos.

Checks de servicio

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

Solucionar problemas

¿Necesitas ayuda? Contacta con el equipo de asistencia de Datadog.