Versión de la integración3.0.1
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
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
.
Reinicia el Agent.
Recopilación de logs
La recopilación de logs se encuentra deshabilitada de manera predeterminada en el Datadog Agent. Habilítala en tu archivo datadog.yaml
:
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.
- 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.