Diagnosticar «No queda espacio en el dispositivo» cuando df muestra espacio libre

Objetivo

Determinar cuál de las cuatro causas de un fallo de escritura con ENOSPC es la aplicable, y liberar entonces el recurso correcto en lugar de eliminar archivos al azar.

Requisitos previos

Acceso root o sudo en el host afectado, el mensaje de error con la ruta que falló, y acceso a df, du, lsof o /proc.

Pasos

1. Localizar el sistema de archivos: df -h /path/that/failed muestra el punto de montaje; un /var/log lleno en su propia partición se ve, para la aplicación, igual que una raíz llena.
2. Comprobar bytes e inodos por separado: df -h y df -i (--inodes) sobre ese punto de montaje. Un sistema de archivos ext4 se crea con un número fijo de inodos derivado de bytes-per-inode (mke2fs(8)); un directorio con millones de archivos diminutos (sesiones, fragmentos de caché, colas de correo) puede agotar los inodos aunque la mayoría de los bytes sigan libres. Si IUse% es 100, buscar el directorio con find /mount -xdev -type d -exec sh -c 'echo $(ls -1A "$1" | wc -l) "$1"' _ {} \; | sort -n | tail.
3. Comprobar si hay archivos eliminados pero abiertos: unlink(2) indica que un archivo cuyo último nombre se ha eliminado, pero que sigue abierto, permanece en existencia hasta que se cierra el último descriptor. lsof +L1 o find /proc/*/fd -lname '*(deleted)' los enumera; quien suele retenerlos es un proceso de logging o una base de datos con un archivo rotado. Reiniciar ese proceso o enviarle una señal (kill -HUP para los demonios que reabren sus logs) en lugar de seguir eliminando archivos.
4. Comprobar la reserva: los sistemas de archivos ext mantienen un reserved-blocks-percentage (5 % por defecto según mke2fs(8)) utilizable solo por root, de modo que los procesos sin privilegios fallan mientras df sigue mostrando unos pocos puntos porcentuales libres. tune2fs -m 1 la reduce en volúmenes de datos; conviene mantenerla en el sistema de archivos raíz.
5. Si el espacio está realmente en uso, localizarlo con du -xh --max-depth=1 /mount | sort -h (-x se queda en un único sistema de archivos) y preferir la limpieza propia de cada responsable (journalctl --vacuum-size, poda de imágenes de contenedor, rotación de logs) antes que rm.
6. Registrar la causa y la solución; si se observa una tendencia de crecimiento, añadir una alerta sobre el uso de inodos y de bytes por punto de montaje, no solo en el sistema de archivos raíz.

Resultado esperado

La escritura vuelve a tener éxito, la causa queda identificada (inodos, archivo retenido, reserva o uso real) y la monitorización cubre la dimensión que falló.

Límites y base de verificación

El comportamiento de sistema de archivos citado corresponde a la familia ext; XFS y btrfs asignan los inodos de otra forma y tienen sus propias herramientas de contabilización. Los sistemas de archivos overlay de contenedores y los montajes tmpfs añaden otros límites (tamaño de tmpfs, cuotas de contenedor) que no se tratan aquí. No se afirma ninguna medición ni observación de campo.