Cómo evitar que los registros de Home Assistant llenen el disco del sistema

Eva Wong es la redactora técnica y manitas residente en ZimaSpace. Es una geek de toda la vida apasionada por los laboratorios domésticos y el software de código abierto, y se especializa en traducir conceptos técnicos complejos en guías prácticas y fáciles de seguir. Eva cree que alojar servicios propios debería ser divertido, no intimidante. A través de sus tutoriales, ayuda a la comunidad a desmitificar la configuración del hardware, desde montar su primer NAS hasta dominar los contenedores Docker.

Evita que los registros de Home Assistant llenen el disco identificando primero el archivo exacto que está creciendo, corrigiendo el evento que se repite y aplicando la retención en la capa responsable de ese registro.

En un pequeño servidor doméstico, los registros de Home Assistant Core, los registros de Docker, los de Supervisor o los complementos y el diario del sistema anfitrión pueden consumir el mismo disco del sistema, pero requieren soluciones distintas. Mide el crecimiento durante un breve intervalo controlado, conserva suficientes pruebas para identificar quién escribe, aplica límites reversibles y detén las escrituras no esenciales si queda muy poco espacio para reiniciar o hacer una copia de seguridad de forma segura.

Identifica qué registro está consumiendo espacio

Anota el espacio libre total y, sin borrar nada, enumera los archivos y directorios más grandes del sistema de archivos afectado. Vuelve a comparar los tamaños tras cinco o diez minutos mientras Home Assistant funciona con normalidad. El archivo cuyo tamaño cambia es más útil que una lista estática de archivos antiguos y grandes.

Los casos de Home Assistant muestran que el agotamiento del espacio puede deberse a distintas capas, incluidos los registros del sistema, y no solo a la base de datos de Recorder. En una discusión sobre un caso resuelto, se rastreó el crecimiento hasta el diario de systemd, así que lo primero es distinguir qué directorio sigue creciendo, no si Home Assistant parece estar ocupado.

Si crece un registro de Core, revisa el componente y el mensaje que se repiten. Si crecen los registros JSON de Docker, revisa el controlador de registros del contenedor. Si crece el diario, revisa el servicio que los genera. Si el espacio libre ya es críticamente bajo, detén el contenedor no esencial más ruidoso o el propio Home Assistant antes de que más escrituras dificulten la recuperación.

Corrige los errores repetidos antes de reducir la visibilidad

Cuenta el mensaje predominante y compara sus marcas de tiempo con las de un dispositivo, una integración, una automatización, un complemento o un evento de red. Una advertencia repetida miles de veces suele aportar más información para prevenir problemas que decenas de entradas aisladas y sin relación. Guarda una muestra breve con la versión y el desencadenante antes de cambiar la configuración.

Un problema de Home Assistant Core documentado describía un error de Tradfri que hizo crecer un registro hasta superar los 10 GB y agotó el disco del sistema. Es un ejemplo específico de una versión de una integración saturando un registro; sirve para aislar el origen, no para dar por sentado que Tradfri o la rotación sean siempre la causa.

Desactiva el registro de depuración cuando termine la captura. Después, vuelve a cargar o desactiva solo la integración ruidosa confirmada y repite el desencadenante original. Si la tasa de mensajes cae en picado, repara esa integración o su dependencia. Si no cae, restablece el ajuste y pasa al siguiente proceso emisor confirmado en lugar de silenciar todas las advertencias.

Define la retención en la capa responsable del registro

Define una política con límites para el registro del host, el controlador de registros de Docker, el proxy inverso y cada complemento por separado. El nivel de registro de Core no limita el almacenamiento del diario de systemd, y una opción de tamaño de Docker no rota un archivo escrito directamente en un directorio de configuración montado.

Elige límites que conserven suficiente historial para cubrir el intervalo entre revisiones y, a la vez, reserven espacio para copias de seguridad, actualizaciones, operaciones con la base de datos y recuperación. El artículo relacionado de ZimaSpace sobre el espacio de almacenamiento libre en Home Assistant explica por qué agotar el margen restante puede impedir tareas que necesitan temporalmente espacio adicional en disco.

Documenta cada política en la configuración que persiste tras la recreación. Reinicia o recrea solo el servicio afectado, confirma que el ajuste esté activo y ten a mano el valor anterior para revertirlo. No uses un borrado general programado como sustituto de la búsqueda de un proceso de escritura anómalo.

Verifica que el crecimiento se mantenga acotado con el desencadenante original

Reproduce el evento que provocó la avalancha, como la desconexión de un dispositivo, un reintento de una integración, una copia de seguridad o una interrupción de la red. Durante más tiempo que el período de crecimiento anterior, sigue el tamaño del mismo archivo, la tasa de mensajes, el espacio libre, el estado del servicio y la respuesta de la automatización.

Un resultado satisfactorio presenta un espacio de registro estable o rotativo, no pierde los diagnósticos necesarios, escribe el historial con normalidad y conserva suficiente espacio libre para la siguiente copia de seguridad y actualización. Reinicia el host una vez y repite el desencadenante para comprobar que los límites siguen vigentes después de recrear el servicio.

Revierte un cambio de retención si elimina las pruebas necesarias para diagnosticar una falla persistente. Si el registro sigue creciendo después de aislar la fuente confirmada, escala el problema con el mensaje repetido, el componente que lo genera, la versión, la tasa de crecimiento y la ruta de almacenamiento; detén las escrituras de nuevo si el disco está a punto de llenarse.

Soporte y consejos

Más para leer

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.