Redis Monitoring

Overview

Monitor Redis performance and health using the OpenTelemetry Collector with the Redis receiver. Track memory usage, hit rates, connection counts, and command throughput.

OpenTelemetry Collector Setup

Use the OpenTelemetry Collector with the Redis receiver to collect metrics.

1. Configure the Collector

# otel-collector-config.yaml
receivers:
  redis:
    endpoint: "localhost:6379"
    collection_interval: 30s
    # If Redis requires authentication:
    password: ${REDIS_PASSWORD}
    # For Redis Cluster:
    # endpoint: "redis-cluster:6379"

exporters:
  otlphttp:
    endpoint: https://qorrelate.io
    headers:
      Authorization: "Bearer ${QORRELATE_API_KEY}"
      X-Organization-Id: "${QORRELATE_ORG_ID}"

service:
  pipelines:
    metrics:
      receivers: [redis]
      exporters: [otlphttp]

2. Run the Collector

# Docker
docker run -v ./otel-collector-config.yaml:/etc/otel/config.yaml \
  -e REDIS_PASSWORD=your_redis_password \
  -e QORRELATE_API_KEY=your_api_key \
  -e QORRELATE_ORG_ID=your_org_id \
  otel/opentelemetry-collector-contrib:latest \
  --config=/etc/otel/config.yaml

Kubernetes Deployment

apiVersion: v1
kind: ConfigMap
metadata:
  name: otel-collector-config
data:
  config.yaml: |
    receivers:
      redis:
        endpoint: "redis-master.default.svc:6379"
        collection_interval: 30s
    exporters:
      otlphttp:
        endpoint: https://qorrelate.io
        headers:
          Authorization: "Bearer ${QORRELATE_API_KEY}"
          X-Organization-Id: "${QORRELATE_ORG_ID}"
    service:
      pipelines:
        metrics:
          receivers: [redis]
          exporters: [otlphttp]

Available Metrics

Application-Level Command Tracing

To trace individual Redis commands from your application, use OpenTelemetry SDK instrumentation.

Python (redis-py)

pip install opentelemetry-instrumentation-redis

from opentelemetry.instrumentation.redis import RedisInstrumentor

# Auto-instrument all redis connections
RedisInstrumentor().instrument()

# Your Redis commands are now traced
import redis
r = redis.Redis()
r.get("my_key")  # Creates a span for this command

Node.js (ioredis/redis)

npm install @opentelemetry/instrumentation-ioredis
# or
npm install @opentelemetry/instrumentation-redis

const { IORedisInstrumentation } = require('@opentelemetry/instrumentation-ioredis');

// Add to your instrumentation setup
instrumentations: [
  new IORedisInstrumentation({
    dbStatementSerializer: (cmdName, cmdArgs) => {
      return `${cmdName} ${cmdArgs.join(' ')}`;
    }
  })
]

Go

import "go.opentelemetry.io/contrib/instrumentation/github.com/go-redis/redis/otelredis"

// Wrap your Redis client
rdb := redis.NewClient(&redis.Options{Addr: "localhost:6379"})
rdb.AddHook(otelredis.NewTracingHook())

Redis Slow Log

Redis has a built-in slow log. Configure and collect it:

1. Configure Slow Log in Redis

# Log commands taking longer than 10ms
redis-cli CONFIG SET slowlog-log-slower-than 10000

# Keep 1000 slow log entries
redis-cli CONFIG SET slowlog-max-len 1000

2. View Slow Log

# Get last 10 slow log entries
redis-cli SLOWLOG GET 10

Pre-built Dashboard Queries

Use these PromQL queries to build your Redis dashboard:

100 * rate(redis_keyspace_hits[5m]) / 
  (rate(redis_keyspace_hits[5m]) + rate(redis_keyspace_misses[5m]))

rate(redis_commands[5m])

100 * redis_memory_used / redis_memory_max

rate(redis_keys_evicted[5m])

redis_clients_connected

Recommended Alerts

redis_memory_used / redis_memory_max > 0.9

rate(redis_keys_evicted[5m]) > 100

100 * rate(redis_keyspace_hits[5m]) / 
  (rate(redis_keyspace_hits[5m]) + rate(redis_keyspace_misses[5m])) < 80

redis_clients_connected > 1000

redis_memory_fragmentation_ratio > 1.5