Aller au contenu principal

Redis Sentinel

Contenu du Pack​

Modèles​

Le Pack Centreon Redis Sentinel apporte 1 modèle d'hôte :

  • App-Redis-Sentinel-custom

Il apporte les Modèles de Service suivants :

Service AliasService TemplateDefaultDiscovery
Redis-ClustersApp-Redis-Sentinel-Redis-ClustersXX
Sentinel-ClustersApp-Redis-Sentinel-Sentinel-ClustersXX

Règles de découverte​

Rule nameDescription
App-Redis-Sentinel-Redis-Cluster-NameDécouvre les clusters et supervise le statut et l'utilisation des Redis
App-Redis-Sentinel-Sentinel-Cluster-NameDécouvre les clusters et supervise le statut et l'utilisation des Sentinel

Métriques & statuts collectés​

Metric nameDescriptionUnit
cluster.redis.slaves.detected.countNumber of detected slaves
cluster.redis.subjectively_down.countNumber of subjectively down redis instances
cluster.redis.objectively_down.countNumber of objectively down redis instances
cluster.redis.slave_replication_offset.stddev.countSlave replication offset standard deviation (between all slaves)
statusStatus of redis instance
cluster_name~redis_address:redis_port#cluster.redis.ping_ok.latency.millisecondsLast ok ping latencyms

Prérequis​

Afin de superviser Redis Sentinel, le collecteur doit pouvoir réaliser des requêtes avec l'utilitaire redis-cli sur le port TCP/26379 (par défaut). Voici la liste des commandes utilisées:

  • sentinel ckquorum <cluster_name>
  • sentinel masters
  • sentinel replicas <cluster_name>
  • sentinel sentinels <cluster_name>

Installation​

  1. Installer le Plugin Centreon sur tous les collecteurs Centreon devant superviser des resources Redis Sentinel:
yum install centreon-plugin-Applications-Redis-Sentinel
  1. Sur l'interface Web de Centreon, installer le Pack Redis Sentinel depuis la page Configuration > Packs de plugins.

Configuration​

Hôte​

  • Ajoutez un Hôte à Centreon depuis la page Configuration > Hôtes

  • Complétez les champs Nom, Alias & IP Address / DNS correspondant à votre serveur Redis Sentinel.

  • Appliquez le Modèle d'Hôte applications-redis-sentinel-custom

  • Une fois le modèle appliqué, renseignez les macros correspondantes. Attention, certaines macros sont obligatoires ("mandatory").

MandatoryNameDescription
SENTINELPORT(Default: '26379')
SENTINELUSERNAMESentinel username (redis-cli >= 6.x mandatory)
SENTINELPASSWORDSentinel password
EXTRAOPTIONSAny extra option you may want to add to the command (eg. a --tls --insecure)

Comment installer redis-cli 6.x ?​

Pour le support TLS et des utilisateurs ACLs, une version 6.x minimum de redis-cli est nécessaire.

yum install epel-release
yum install http://rpms.remirepo.net/enterprise/remi-release-7.rpm 
yum --enablerepo=remi install redis

Comment puis-je tester le Plugin et que signifient les options des commandes ?​

Une fois le Plugin installé, vous pouvez tester celui-ci directement en ligne de commande depuis votre collecteur Centreon en vous connectant avec l'utilisateur centreon-engine:

/usr/lib/centreon/plugins/centreon_redis_sentinel.pl \
    --plugin=apps::redis::sentinel::plugin \
    --server='10.0.0.1' \
    --port='26379' \
    --mode=redis-clusters \
    --filter-cluster-name='' \
    --verbose

La commande devrait retourner un message de sortie similaire à :

OK: cluster 'mymaster' number of detected slaves: 2, subjectively down instances: 0, objectively down instances: 0 - slave replication offset standard deviation: 843.00 - All redis instances are ok | 'mymaster#cluster.redis.slaves.detected.count'=2;;;0; 'mymaster#cluster.redis.subjectively_down.count'=0;;;0; 'mymaster#cluster.redis.objectively_down.count'=0;;;0; 'cluster.redis.slave_replication_offset.stddev.count'=843.00;;;; 'mymaster~10.25.52.107:6379#cluster.redis.ping_ok.latency.milliseconds'=1024s;;;0; 'mymaster~10.25.52.90:6379#cluster.redis.ping_ok.latency.milliseconds'=185s;;;0; 'mymaster~10.25.52.98:6379#cluster.redis.ping_ok.latency.milliseconds'=355s;;;0;
checking cluster 'mymaster'
    number of detected slaves: 2, subjectively down instances: 0, objectively down instances: 0
    slave replication offset standard deviation: 843.00
    instance '10.25.52.107:6379' status: master [role: master], last ok ping: 1024 ms
    instance '10.25.52.90:6379' status: slave [role: slave], last ok ping: 185 ms
    instance '10.25.52.98:6379' status: slave [role: slave], last ok ping: 355 ms

La liste de toutes les options complémentaires et leur signification peut être affichée en ajoutant le paramètre --help à la commande:

/usr/lib/centreon/plugins/centreon_redis_sentinel.pl \
    --plugin=apps::redis::sentinel::plugin \
    --mode=redis-clusters \
    --help

Tous les modes disponibles peuvent être affichés en ajoutant le paramètre --list-mode à la commande:

/usr/lib/centreon/plugins/centreon_redis_sentinel.pl \
    --plugin=apps::redis::sentinel::plugin \
    --list-mode

Diagnostic des erreurs communes​

Rendez-vous sur la documentation dédiée pour le diagnostic des erreurs communes des Plugins Centreon.