Cómo solucionar el error OOM command not allowed cuando Redis alcanza la memoria máxima

✨ Respuesta Rápida

El error OOM command not allowed when used memory > 'maxmemory' ocurre en instancias de Redis cuando el uso de memoria RAM alcanza el límite estipulado en el parámetro maxmemory y la política de desalojo (eviction policy) por defecto está configurada como noeviction. Bajo estas condiciones, Redis rechaza cualquier comando que intente agregar o modificar datos (SET, HSET, LPUSH), respondiendo con una excepción de falta de memoria (Out of Memory).

El error OOM command not allowed when used memory > 'maxmemory' ocurre en instancias de Redis cuando el uso de memoria RAM alcanza el límite estipulado en el parámetro maxmemory y la política de desalojo (eviction policy) por defecto está configurada como noeviction. Bajo estas condiciones, Redis rechaza cualquier comando que intente agregar o modificar datos (SET, HSET, LPUSH), respondiendo con una excepción de falta de memoria (Out of Memory).

El Diagnóstico Rápido

Causa

Comandos de escritura fallan con OOM command not allowed: La memoria alcanzó el límite maxmemory bajo la política por defecto noeviction

Solución

Configurar una política de desalojo automática (allkeys-lru o volatile-lru) o aumentar maxmemory

Causa

El proceso de Redis es eliminado por el Kernel (Linux OOM Killer): El archivo redis.conf no define un límite maxmemory, consumiendo toda la RAM del host

Solución

Establecer un tope en maxmemory equivalente al 70-80% de la RAM del servidor

Causa

Alto ratio de fragmentación de memoria (mem_fragmentation_ratio > 1.5): El asignador de memoria Jemalloc conserva páginas liberadas tras borrar claves masivas

Solución

Habilitar la desfragmentación activa en Redis (activedefrag yes)

La Solución Paso a Paso

1. 1

   Paso 1: Diagnosticar el estado de memoria en Redis CLI

   Conéctate a tu instancia de Redis y ejecuta el comando de información de memoria para auditar la memoria consumida y la política actual:

   BASH Copiar

   # Conectar mediante redis-cli
   redis-cli -h 127.0.0.1 -p 6379
   
   # Consultar métricas de memoria
   127.0.0.1:6379> INFO memory
   
   # Salida relevante a verificar:
   # used_memory_human:1.95G
   # maxmemory_human:2.00G
   # maxmemory_policy:noeviction
   

2. 2

   Paso 2: Cambiar la política de desalojo (maxmemory-policy) en caliente

   Para restaurar el servicio inmediatamente sin reiniciar el servidor Redis, aplica una política de desalojo (eviction policy) en tiempo de ejecución:

   BASH Copiar

   # Configurar la política para desahuciar las claves menos utilizadas (LRU)
   127.0.0.1:6379> CONFIG SET maxmemory-policy allkeys-lru
   
   # Opcional: Aumentar el límite de memoria asignada a la instancia si dispones de RAM libre
   127.0.0.1:6379> CONFIG SET maxmemory 3gb
   

   Las políticas principales de desalojo disponibles son:

   • allkeys-lru: Elimina las claves menos recientemente usadas (Least Recently Used) entre todos los registros. Ideal para caché web.
   • volatile-lru: Elimina solo las claves que tienen un tiempo de expiración (TTL) configurado.
   • allkeys-lfu: Elimina las claves usadas con menor frecuencia (Least Frequently Used).
   • noeviction: Retorna error en comandos de escritura (comportamiento predeterminado).
3. 3

   Paso 3: Persistir los cambios en la configuración (redis.conf)

   Para evitar que los ajustes se pierdan al reiniciar la instancia o el contenedor Docker, actualiza el archivo de configuración principal de Redis:

   INI Copiar

   # En /etc/redis/redis.conf o redis.conf del contenedor:
   
   # Límite máximo de memoria (ejemplo: 2 Gigabytes)
   maxmemory 2048mb
   
   # Política de desalojo recomendada para cachés de producción
   maxmemory-policy allkeys-lru
   
   # Activar la desfragmentación automática en segundo plano
   activedefrag yes
   

   Guarda los cambios y aplica una relectura limpia o reinicio del servicio:

   BASH Copiar

   sudo systemctl restart redis-server