Redis DB Monitoring

Plugin para la monitorización de la base de datos Redis.

Introducción

Plugin para la monitorización de Redis database. Obtención de métricas de rendimiento.

Revisado en Enero de 2019

Matriz de compatibilidad

Desarrollado contra Redis DB 3.2.12

Prerequisitos

Se requiere conexión con el servicio Tentacle asociado a su servidor de Pandora FMS (para ejecuciones locales del plugin) bajo las siguiente condicion:

El despliegue de este plugin por binarios no requiere ningún requisito especial.

En caso de no estar compilado requiere de las siguiente librerias de perl:

Puede descargar la última versión de PandoraFMS::PluginTools.pm:

 https://github.com/pandorafms/pandorafms/blob/develop/pandora_server/lib/PandoraFMS/PluginTools.pm

Configuración

El fichero de configuración del plugin se divide en lineas:

Configuraciones generales del plugin

#================================================================
# Plugin options
#================================================================

server=192.168.80.199:6379
password=pandora_redis
as_agent_plugin=1
as_server_plugin=0
agent_name=RedisDB
temp=/tmp/
mode=tentacle
tentacle_ip=127.0.0.1
tentacle_port=41121
metrics=all
debug=0

server

Dirección del servidor redis.

password

Contraseña para autenticarse si está habilitada la autenticación en el servidor Redis.

metrics

Métricas a obtener con el plugin (all || server || clients || memory || persistence || stats || replication || cpu || commandstats || cluster || keyspace )

as_agent_plugin

Utilizar el plugin en en modo de agente

as_server_plugin

Utilizar el plugin en modo servidor

[agent_name]

Nombre de agente (as_server_plugin)

[temp]

Directorio temporal para almacenar el xml (local)

[mode]

Modo de transferencia (tentacle/local)

[tentacle_ip]

Ip del servidor tentacle

tentacle_port

Puerto del servidor tentacle

debug

Modo debug

Ejecución manual

Para ejecutar el plugin configure el archivo de configuración según las instrucciones precedentes.

Ejecución del plugin:

Versión binaria:

./redis_monitor.64 redis_config.conf

Versión código sin librerías desplegadas:

perl -I PandoraFMS redis_monitor.pl redis_config.conf

Donde, PandoraFMS es un directorio que contiene la librería PluginTools.pm

 

Módulos generados por el plugin

La ejecución estándar de este plugin devolverá los siguientes módulos por defecto (con todos los bloques opcionales habilitados):

 

Monitorización:

Server:

Clients:

Memory:

If AOF is activated, these additional fields will be added:

If a load operation is on-going, these additional fields will be added:

Stats:

Replication:

If the instance is a replica, these additional fields are provided:

If a SYNC operation is on-going, these additional fields are provided:

The following field is always provided:

If the server is configured with the min-slaves-to-write (or starting with Redis 5 with the min-replicas-to-write) directive, an additional field is provided:

For each replica, the following line is added:

CPU:

Comandstats:

Cluster

Keyspace:

dbXXX: keys=XXX,expires=XXX