Gestión de Procesos y Recursos

ps, htop, señales, nohup y límites de recursos en Linux: gestiona workers web de Python, procesos Celery y scripts de larga ejecución sin zombies huérfanos ni cierres por falta de memoria (OOM kills).

Receta

pgrep -af "uvicorn|celery|gunicorn"
kill -TERM <pid>
sleep 5
kill -KILL <pid>   # solo si todavía está en ejecución
htop -p <pid>

Cuándo usar esto:

• Despliegue de uvicorn duplicado en el mismo puerto
• Fuga de memoria del worker necesita reinicio
• Apagado elegante antes de una ventana de mantenimiento
• Diagnosticar un pico de CPU por un bucle descontrolado

Ejemplo Práctico

# Buscar el maestro y los workers de billing-api
pgrep -af gunicorn
 
# Recarga elegante (si está configurado USR2/HUP) o TERM
sudo kill -TERM "$(pgrep -f 'gunicorn.*billing-api' | head -1)"
sleep 10
sudo ss -tlnp | grep 8000
 
# Comprobar archivos abiertos por fuga de conexiones
PID=$(pgrep -f 'uvicorn app.main:app' | head -1)
ls -l /proc/$PID/fd | wc -l
cat /proc/$PID/limits | grep "open files"

Lo que esto demuestra:

• pgrep -af muestra la línea de comandos completa para procesos de Python
• TERM permite un cierre elegante de FastAPI/Gunicorn
• KILL solo después del tiempo de espera
• Inspección de /proc para fugas de descriptores de archivo (fd)

Profundización

Cómo Funciona

• Señales - SIGTERM para un apagado educado; SIGKILL inmediato; SIGUSR1/2 específicos de la aplicación.
• Padre/hijo - El maestro de Gunicorn genera workers; matar al maestro para reciclarlos a todos.
• Asesino OOM - Linux mata el proceso con mayor RSS bajo presión de memoria.
• cgroups - Límites de memoria/CPU de contenedores en Docker/K8s.

Hoja de Referencia de Señales

Notas de Python

# La aplicación registra un manejador SIGTERM para la limpieza
import signal
 
def handle_term(signum, frame):
    close_db_pool()
 
signal.signal(signal.SIGTERM, handle_term)

Errores Comunes

• SIGKILL primero - Descarta transacciones HTTP y de base de datos en curso. Solución: TERM, esperar, luego KILL.
• Matar PID incorrecto desde pgrep - El patrón es demasiado amplio y coincide con dos aplicaciones. Solución: verificar la línea de comandos en ps -fp.
• nohup en producción - Crea procesos huérfanos al desconectar SSH sin rotación de logs. Solución: unidad systemd.
• Procesos Zombie - El padre no está recolectando a los hijos. Solución: reiniciar el supervisor padre.
• Ignorar dmesg de OOM - Reinicios misteriosos. Solución: dmesg -T | rg -i oom.
• ulimit demasiado bajo - "Demasiados archivos abiertos" bajo carga. Solución: LimitNOFILE en systemd.

Alternativas

Preguntas Frecuentes

Relacionado

• Fundamentos de Sysadmin - systemd
• SSH y Trabajo Remoto - matar remotamente
• Despliegue de FastAPI - diseño de gunicorn
• Fundamentos de Rendimiento - profiling

Versiones de Stack: Esta página fue escrita para Python 3.14.0 (estable 3.14, mantenimiento 3.13), FastAPI 0.115+, Django 5.2, Flask 3.1, Pydantic 2, PyTorch 2.6+, pandas 2.2+, Polars 1.x, ruff 0.9+, y uv 0.6+.