Cómo revisar los procesos de un contenedor Docker

procesos-contenedor-docker-portada
procesos-contenedor-docker-portada

Saber cómo revisar los procesos de un contenedor te ayuda a diagnosticar qué está ejecutándose dentro de Docker sin entrar a ciegas ni confundir el estado del contenedor con el estado real de la aplicación.

En esta lección vas a usar docker top, ps, logs e inspect para comprobar procesos activos, detectar comandos inesperados y entender cuándo conviene entrar al contenedor solo para una revisión puntual.

👉 Y recuerda, si quieres aprender más de Linux, visita el curso de Linux gratis.

🐳 Si quieres aprender más de Docker, visita el curso de Docker gratis.

Cómo revisar los procesos de un contenedor

El comando principal para esta tarea es docker top. Muestra los procesos que se están ejecutando dentro de un contenedor desde el punto de vista del host, sin necesidad de abrir una shell interactiva.

ComandoQué revisaCuándo usarlo
docker topProcesos del contenedor.Diagnóstico rápido sin entrar al contenedor.
docker psEstado general del contenedor.Confirmar si está running o exited.
docker logsSalida del proceso principal.Cruzar procesos con errores visibles.
docker inspectEstado y configuración.Ver PID, restart policy y detalles internos.
docker exec psProcesos desde dentro.Solo si la imagen incluye herramientas suficientes.

Preparar un laboratorio seguro

Para practicar, crea un contenedor temporal con Nginx. Los comandos siguientes no modifican servicios reales y al final eliminan el contenedor de laboratorio.

docker run -d --name procesos-demo nginx:alpine
docker ps --filter name=procesos-demo
docker top procesos-demo

Con docker top deberías ver el proceso principal de Nginx y sus procesos auxiliares. No hace falta inventar una salida concreta: lo importante es aprender a leer el comando, usuario, PID y argumentos cuando Docker los muestre.

Cruzar procesos con estado y logs

Revisar procesos aislados no siempre basta. Si el contenedor está en ejecución pero la aplicación no responde, combina procesos, logs y estado para entender mejor el problema.

docker logs --tail 30 procesos-demo
docker inspect procesos-demo --format '{{.State.Status}} {{.State.Pid}} {{.State.ExitCode}}'
docker exec procesos-demo ps aux

El comando docker exec ps aux puede fallar si la imagen no trae ps instalado. En ese caso, docker top sigue siendo una opción útil porque no depende de las herramientas internas del contenedor.

Qué señales debes observar

  • Si no aparece el proceso esperado, quizá el entrypoint terminó o la aplicación no arrancó.
  • Si hay muchos procesos hijos, revisa si son normales para esa aplicación o si hay tareas inesperadas.
  • Si el contenedor reinicia continuamente, mira logs y política de reinicio antes de tocar nada.
  • Si el PID del host cambia tras un restart, no asumas que sigues mirando el mismo proceso.

Errores comunes

  • Confundir un contenedor running con una aplicación saludable.
  • Entrar siempre con una shell cuando bastaba con docker top.
  • Depender de ps dentro de imágenes mínimas que no incluyen procps.
  • Borrar o reiniciar antes de guardar evidencia útil.
  • Interpretar procesos sin cruzarlos con logs, healthchecks o configuración.

Buenas prácticas de diagnóstico

Antes de actuar en producción, identifica el contenedor exacto con docker ps, revisa procesos con docker top y guarda logs relevantes. Reiniciar puede recuperar un servicio, pero también puede borrar pistas temporales.

En laboratorios, limpiar el contenedor al final está bien. En entornos reales, evita docker rm -f salvo que sepas exactamente qué servicio estás cortando y qué datos dependen de ese contenedor.

Lecciones relacionadas del curso Docker

Documentación oficial y recursos

Dominar cómo revisar los procesos de un contenedor te da una lectura más precisa de lo que ocurre dentro de Docker. Primero mira procesos, luego logs y estado, y solo después decide si necesitas reiniciar, entrar o recrear.

Comentarios

No hay comentarios aún. ¿Por qué no comienzas el debate?

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *