Redis DB Monitoring

Plugin for Redis database monitoring.

Introduction

Plugin for Redis database monitoring. Performance metrics obtained.

Reviewed in January 2019

Compatibility matrix

Developed against Redis DB 3.2.12

Requeriments

The plugin requires connection to Tentacle service associated to the Pandora FMS server (for local plugin execution) under the next condition:

The plugin deployment using binary files do not requires any special requirement.

In case of non compiled plugin following perl libraries will be needed:

You can download latest version of PandoraFMS::PluginTools.pm :

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

Configuration

The configuration file is splitted in several lines:

General plugin configuration
#================================================================
# 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

Redis server address.

password

Password for authentication in case this option is enabled in Redis server.

metrics

Metrics to obtain (all || server || clients || memory || persistence || stats || replication || cpu || commandstats || cluster || keyspace )

as_agent_plugin

Use the plugin as agent plugin

as_server_plugin

Use the plugin as server plugin

[agent_name]

Agent name (as_server_plugin)

[temp]

Temporal folder to store XML files (local)

[mode]

Transfer mode (tentacle/local)

[tentacle_ip]

Tentacle server ip

tentacle_port

Tentacle server port

debug

Debug mode

Manual execution

In order to execute the plugin manually configure the plugin configuration file as described previously.

Plugin execution:

Binary version:

./redis_monitor.64 redis_config.conf

Non compiled version without deployed libraries:

perl -I PandoraFMS redis_monitor.pl redis_config.conf

Where, PandoraFMS is a directory that contains the libraries specified above.

Modules generated by the plugin

The standard plugin execution will return the following modules by default (enablig all optional metrics):

 

Monitoring:

Server:

Clients:

Memory:

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: