Red Hat Gluster Storage

Supported OS

Versión de la integración3.0.2

Información general

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

Configuración

Sigue las instrucciones a continuación para instalar y configurar este check para un Agent que se ejecute 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, en la carpeta conf.d/ en la raíz del directorio de configuración de tu Agent para comenzar a recopilar tus datos de rendimiento de GlusterFS. Consulta el [glusterfs.d/conf.yaml](https://github.com/DataDog/integrations-core/blob/master/glusterfs/datadog_checks/glusterfs/data/conf.yaml.example de ejemplo) para todas las opciones de configuración 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
    

    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 está desactivada en forma predeterminada en el Datadog Agent, actívala 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. Consulta el conf.yaml de ejemplo para conocer todas las opciones de configuración disponibles.

  1. Reinicia el Agent.

Para obtener información sobre la configuración del Agent para la recopilación de logs en entornos de Kubernetes, consulta Recopilación de logs de Kubernetes.

Validación

[Ejecuta el subcomando de estado del Agent(https://docs.datadoghq.com/agent/guide/agent-commands/#agent-status-and-information) y busca glusterfs en la sección Checks.

Datos recopilados

Métricas

glusterfs.brick.block_size
(gauge)
Tamaño de bloque del bloque
Se muestra como byte
glusterfs.brick.inodes.free
(gauge)
Inodos libres en el bloque
Se muestra como byte
glusterfs.brick.inodes.total
(gauge)
Total de inodos en el bloque
Se muestra como byte
glusterfs.brick.inodes.used
(gauge)
Inode utilizado en el bloque
Se muestra como byte
glusterfs.brick.online
(gauge)
Número de bloques en línea
Se muestra como unidad
glusterfs.brick.size.free
(gauge)
Tamaño del bloque libre
Se muestra como byte
glusterfs.brick.size.total
(gauge)
Tamaño total del bloque
Se muestra como byte
glusterfs.brick.size.used
(gauge)
Bytes actuales utilizados en el bloque
Se muestra como byte
glusterfs.cluster.nodes.active
(gauge)
Nodos activos actuales
Se muestra como nodo
glusterfs.cluster.nodes.count
(gauge)
Número total de nodos en el clúster
Se muestra como nodo
glusterfs.cluster.volumes.count
(gauge)
Número de volúmenes en el clúster
Se muestra como unidad
glusterfs.cluster.volumes.started
(gauge)
Número de volúmenes iniciados en el clúster
Se muestra como unidad
glusterfs.subvol.disperse
(gauge)
Recuento disperso del subvolumen
Se muestra como unidad
glusterfs.subvol.disperse_redundancy
(gauge)
Redundancia dispersa del subvolumen
Se muestra como unidad
glusterfs.subvol.replica
(gauge)
Réplicas en subvolumen
Se muestra como unidad
glusterfs.volume.bricks.count
(gauge)
Número de bloques en el volumen
Se muestra como unidad
glusterfs.volume.disperse
(gauge)
Número de dispersos en el volumen
Se muestra como unidad
glusterfs.volume.disperse_redundancy
(gauge)
Número de redundancia dispersa en el volumen
Se muestra como unidad
glusterfs.volume.distribute
(gauge)
Número de distribuidos
Se muestra como unidad
glusterfs.volume.inodes.free
(gauge)
Inodos libres en el volumen
Se muestra como byte
glusterfs.volume.inodes.total
(gauge)
Tamaño total de inodos en el volumen
Se muestra como byte
glusterfs.volume.inodes.used
(gauge)
Bytes usados de inodos en el volumen
Se muestra como byte
glusterfs.volume.online
(gauge)
Número de volúmenes en línea
Se muestra como unidad
glusterfs.volume.replica
(gauge)
Réplicas en volúmenes
Se muestra como unidad
glusterfs.volume.size.free
(gauge)
Bytes libres en el volumen
Se muestra como byte
glusterfs.volume.size.total
(gauge)
Bytes totales en el volumen
Se muestra como byte
glusterfs.volume.size.used
(gauge)
Bytes utilizados en el volumen
Se muestra como byte
glusterfs.volume.snapshot.count
(gauge)
Número de snapshots del volumen
Se muestra como byte
glusterfs.volume.used.percent
(gauge)
Porcentaje de volumen utilizado
Se muestra en porcentaje

Eventos

GlusterFS no incluye eventos.

Checks de servicio

glusterfs.brick.health

Devuelve CRITICAL si el subvolumen es ‘degraded’. Devuelve OK si es ‘up’.

Estados: ok, critical, warning

glusterfs.volume.health

Devuelve CRITICAL si el volumen es ‘degraded’. Devuelve OK si es ‘up’.

Estados: ok, critical, warning

glusterfs.cluster.health

Devuelve CRITICAL si el volumen es ‘degraded’. Devuelve OK en caso contrario.

Estados: ok, critical, warning

Solucionar problemas

¿Necesitas ayuda? Ponte en contacto con el soporte de Datadog.