Skip to main content
SRE

Redis

Redis down

critical

Overview

What does this alert mean?

redis_up == 0. Redis is not responding to the exporter.

Contributing factors

  • Process crashed or was OOM-killed
  • maxmemory reached with policy noeviction
  • AOF or RDB write failure causing crash

Affected components

  • All services using Redis for caching, sessions, or queues

Expected action

Restore the Redis process. If maxmemory is the cause, review eviction policy before restarting.

Services

Metrics

Metric

redis_up

Description & unit

Binary gauge from redis_exporter. 1 = reachable, 0 = down.

Unit: boolean (0 or 1)

Threshold rationale

Any 0 means Redis is unreachable.

Normal behavior

Always 1.

Screenshots

Dashboard when redis_up == 0
Dashboard when redis_up == 0
Dashboard after recovery
Dashboard after recovery

Alert Behavior

Silencing

Silence during planned maintenance.

Expected frequency

Rare.

Severities

Severity guidance

Critical. Impact depends on whether Redis is used for caching only (degraded performance) or for sessions/queues (data loss risk).

Impacted users

All users of services backed by this Redis instance.

Things to check to determine severity

  • Is Redis used for sessions? If so, users may be logged out.
  • Is Redis used as a queue? Check for message loss.

Verification

Prometheus query

redis_up == 0

Dashboards

  • Redis Overview — Fill in: dashboard URL

Log queries

  • Redis logs — Fill in: log query URL

Troubleshooting

Steps

  1. 1Check Redis logs: /var/log/redis/redis-server.log
  2. 2Check process: systemctl status redis
  3. 3Check system memory: free -h
  4. 4Check Redis maxmemory config: redis-cli CONFIG GET maxmemory
  5. 5Attempt restart: systemctl restart redis

Useful commands

systemctl status redisredis-cli CONFIG GET maxmemoryredis-cli CONFIG GET maxmemory-policy

Possible Resolutions

  • maxmemory reached with noeviction policy. Switched to allkeys-lru and restarted.

Dependencies

  • Application services (cache, sessions, queues)
  • redis_exporter

Escalation

Guidance

Escalate immediately if Redis is used for sessions or job queues.

Slack channels

  • #infrastructure-oncall — Fill in: channel URL

Definitions

Alert rule

Fill in: link to the alert rule in _data/rules.yml on GitHub

Tuning notes

Add `for: 1m` to tolerate a single restart.

Related Links

Related alerts

Documentation

Template adapted from https://runbooks.gitlab.com/template-alert-playbook/