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.
| Comando | Qué revisa | Cuándo usarlo |
|---|---|---|
| docker top | Procesos del contenedor. | Diagnóstico rápido sin entrar al contenedor. |
| docker ps | Estado general del contenedor. | Confirmar si está running o exited. |
| docker logs | Salida del proceso principal. | Cruzar procesos con errores visibles. |
| docker inspect | Estado y configuración. | Ver PID, restart policy y detalles internos. |
| docker exec ps | Procesos 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-demoCon 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 auxEl 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
- Cómo listar contenedores Docker: identifica objetivos antes de diagnosticar.
- Cómo leer logs de contenedores Docker: cruza procesos con salida real.
- Cómo inspeccionar un contenedor Docker: revisa estado y configuración.
- Contenedores en segundo plano: entiende servicios detached.
- guía completa de Docker: vuelve al índice del curso.
Documentación oficial y recursos
- docker top reference: referencia oficial del comando.
- docker ps reference: listado y filtros de contenedores.
- docker exec reference: ejecutar comandos dentro del contenedor.
- docker inspect reference: inspección detallada del objeto.
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.

