Skip to main content

Redis Database

Pack Assets​

Monitored Objects​

The Pack Redis collects metrics for:

  • Clients
  • Commands
  • Connections
  • Cpu
  • Memory
  • Persistence
  • Replication

Collected Metrics​

Metric nameDescriptionUnit
clients.connected.countNumber of client connections (excluding replica connections)
clients.blocked.countNumber of clients pending on a blocking call
clients.longest_output_list.countLongest output list among current client connections
clients.biggest_input_buffer.countBiggest input buffer among current client connections


To control your Redis database, the poller can execute INFO command (Eg:


  1. Install the Centreon Plugin on every Poller:
yum install centreon-plugin-Applications-Databases-Redis
  1. On the Centreon Web interface in Configuration > Monitoring Connector Manager, install the Redis Database Pack

Host configuration​

  • Add a new Host and apply the App-DB-Redis-custom Host Template

Once the template applied, some Macros have to be configured.

With that configuration, the Plugin uses redis-cli executable. tls is supported (redis-cli >= 6.x mandatory).

XREDISCUSTOMMODEName of the backend: cli
REDISPORTPort used (Default: 6379)
REDISUSERNAMERedis username (redis-cli >= 6.x mandatory)
REDISSENTINELSentinel server
REDISSENTINELORTSentinel port (Default: 26379)
REDISSERVICEService parameter (mandatory if REDISENTINEL macro used)
REDISEXTRAOPTIONSAny extra option you may want to add to the command (eg. a --tls --insecure)

How to install redis-cli 6.x ?​

To use tls and/or ACL users, you need redis-cli >= 6.x.

yum install epel-release
yum install
yum --enablerepo=remi install redis

How to test the Plugin and what are the main options for?​

Once the plugin installed, log into your Centreon Poller CLI using the centreon-engine user account and test the Plugin by running the following command:

/usr/lib/centreon/plugins/ \
--plugin=database::redis::plugin \
--custommode=perlmod \
--mode=clients \
--server='' \
--port='6379' \

Expected command output is shown below:

OK: Clients connected: 1, blocked: 0 | 'clients.connected.count'=1;;;0; 'clients.blocked.count'=0;;;0;

The command above monitors client connections (--mode=clients).

It connects to the host (--hostname='') on the port 6379 (--port='6379').

All the options as well as all the available thresholds can be displayed by adding the --help parameter to the command:

/usr/lib/centreon/plugins/ \
--plugin=database::redis::plugin \
--custommode=perlmod \
--mode=clients \


Troubleshooting plugins