Redis : dépannage

Premiers réflexes

sudo systemctl status redis-server
sudo journalctl -u redis-server -n 50 --no-pager
sudo tail -n 50 /var/log/redis/redis-server.log
redis-cli ping
sudo ss -tlnp | grep 6379

Messages d’erreur fréquents

Message	Cause et solution
`Could not connect to Redis`	Service arrêté, mauvais port ou mauvaise adresse
`NOAUTH Authentication required`	Mot de passe nécessaire
`WRONGPASS invalid username-password pair`	Identifiants incorrects
`DENIED Redis is running in protected mode`	Connexion distante sans mot de passe : voir Sécurité
`OOM command not allowed`	Limite mémoire atteinte, politique `noeviction` : voir Expiration et mémoire
`MISCONF … unable to persist`	Disque plein ou droits sur `/var/lib/redis`
`LOADING Redis is loading the dataset in memory`	Démarrage en cours : attendre
`WRONGTYPE`	Commande incompatible avec le type de la clé
`max number of clients reached`	Trop de connexions : `maxclients`, fuite de connexions côté application

Lenteurs

redis-cli --latency
redis-cli SLOWLOG GET 10
redis-cli INFO commandstats | head
redis-cli CLIENT LIST | wc -l

Causes courantes : KEYS * sur une grosse base, clés très volumineuses (--bigkeys), sauvegarde en arrière-plan sur un disque lent, mémoire en partie sur disque (swap : free -h).

Mémoire

redis-cli INFO memory | grep -E "used_memory_human|maxmemory_human|mem_fragmentation_ratio"
redis-cli INFO stats | grep -E "evicted_keys|expired_keys"

Voir Expiration et mémoire.

Le service ne démarre pas

sudo journalctl -u redis-server -n 50 --no-pager
sudo redis-server /etc/redis/redis.conf

Lancé à la main, Redis affiche l’erreur de configuration à la ligne indiquée. Vérifier aussi que le port n’est pas déjà utilisé et que /var/lib/redis appartient à l’utilisateur redis.

Réplication

redis-cli INFO replication

Sur une réplique : master_link_status:up doit s’afficher. Configuration minimale d’une réplique (redis.conf) : replicaof 10.0.0.5 6379 et masterauth si le serveur principal exige un mot de passe.

Réinitialiser une instance de test

sudo systemctl stop redis-server
sudo rm -f /var/lib/redis/dump.rdb
sudo rm -rf /var/lib/redis/appendonlydir
sudo systemctl start redis-server

Ubuntu 24.04 et 26.04 : différences à connaître

Les diagnostics sont identiques avec Redis 7.0 et 8.0. Avec Valkey, remplacer redis-server par valkey-server et redis-cli par valkey-cli.

Pour aller plus loin

Dépannage de Redis
Retour : Installation

Dans la même rubrique