Documentación de ELX-HealthMonitor — instalación y avisos

Instalación

Instalar

sudo install -m 755 elx-healthmonitor-linux-amd64 /usr/local/bin/elx-healthmonitor
sudo /usr/local/bin/elx-healthmonitor --install-service
sudo systemctl enable --now elx-healthmonitor
# interfaz web: http://<servidor>:8555

Recomendado, no obligatorio

sudo apt-get install -y smartmontools

Ruta	Qué es
`/usr/local/bin/elx-healthmonitor`	El ejecutable
`/etc/elx-healthmonitor/config.json`	Ajustes, permisos 0600
`/var/lib/elx-healthmonitor/history.db`	Historial de medidas y registro de sucesos
`/etc/systemd/system/elx-healthmonitor.service`	La unidad

Opciones de línea de órdenes

--config <ruta>        archivo de configuración
--listen <dirección>   dirección de la interfaz web, p. ej. :8555
--log-level <nivel>    debug | info | warn | error
--version              versión y fecha de compilación

Elegir qué se recoge

La sección «Ajustes» decide qué se interroga, con qué frecuencia y qué queda excluido; la sección «Avisos» decide cuándo se entera usted. Los cambios surten efecto enseguida, sin reiniciar. Editar config.json y reiniciar el servicio da el mismo resultado.

Qué excluir primeroLos dispositivos loop y virtuales en la sección de sistemas de archivos. Si se dejan, llenan la tabla de entradas que nadie ha necesitado mirar nunca.

Avisos

Una regla es una condición, un umbral y un tiempo de espera. El tiempo de espera es la parte que importa: sin él, un sistema de supervisión avisa de cada pico pasajero, y en una semana ya nadie lee su correo.

Qué vigilar	Un umbral que aguanta
Sistema de archivos que se llena	85 por ciento — aviso suficiente para actuar sin prisas
Carga del procesador	Por encima del 90 por ciento sostenida diez minutos, no diez segundos
Temperatura de disco	Por encima de 50 °C de forma sostenida; un pico breve durante una copia de seguridad es normal
SMART	Cualquier cambio en los sectores reasignados o pendientes — sin espera, avisar enseguida
RAID	Matriz degradada, o discrepancias distintas de cero — siempre
Servicio	Una unidad que debería estar funcionando y no lo está

El correo admite tres modos de cifrado: SMTPS, en el que el TLS arranca con la conexión, normalmente en el puerto 465; STARTTLS, en el que se negocia, normalmente en el 587; y sin cifrar, que solo encaja con un relé de correo dentro de su propia red.

Historial

raw_retention_days — cuánto tiempo las medidas se conservan tal como se tomaron; tres días por omisión.
rollup_interval_sec — el tamaño de los tramos a partir de entonces; cinco minutos, con media, mínimo y máximo de cada uno.
retention_days — cuándo se borra todo; un mes por omisión.

El aclarado avanza en ventanas de seis horas, para que nunca retenga la base el tiempo suficiente como para notarse.

Por qué se guardan mínimo y máximoUna media por sí sola oculta justo el suceso que buscaba: un disco que subió a 60 °C durante un minuto dentro de un tramo de cinco se promedia en algo anodino.

Cuando algo no va

Síntoma	Dónde mirar
La interfaz no se abre	`systemctl status elx-healthmonitor` y si el puerto ya está ocupado
La sección SMART está vacía	smartmontools no está instalado, o los discos están tras una controladora que no deja pasar el SMART
No hay ninguna temperatura	Una máquina virtual — allí no hay sensores físicos
El correo no llega	El modo de cifrado equivocado para el puerto: 465 es SMTPS, 587 es STARTTLS
Los avisos llegan sin parar	El tiempo de espera es demasiado corto, o el umbral está dentro del intervalo normal de esa máquina
El historial se corta a los pocos días	La conservación es más corta de lo que cree, o el disco de la base está lleno