internet-check: sabe cuándo se cae tu conexión

·

Also available in English: read in English.

Iba a estar un buen tiempo fuera de casa. En casa, un pequeño ejército de dispositivos de domótica depende de la conexión a Internet, y la idea de que la línea se cayera en silencio mientras yo estaba lejos, sin forma de saberlo, me inquietaba más de lo que esperaba. No quería enterarme al volver. Quería saberlo en el momento en que ocurriera, y de nuevo en el momento en que volviera.

Así que construí internet-check: un monitor de conexión a Internet para una Orange Pi Zero 2 (y cualquier Debian con systemd) que vigila la línea a todas horas y te habla a través de un bot de Telegram.

Qué hace

  • Te avisa cuando vuelve Internet, con la hora de la caída y cuánto duró.
  • Distingue una caída de un apagón y de un reinicio, y calcula tu disponibilidad del último día, semana y mes.
  • Un bot con menú de botones: estado, test de velocidad, IP pública, historiales, dispositivos de tu red, Wake-on-LAN y reinicio remoto, con administradores y usuarios de solo consulta.
  • Calidad, no solo arriba o abajo: latencia, jitter, pérdida de paquetes y DNS, además de la salud de la propia Pi (temperatura, memoria, disco).
  • Avisos automáticos: tests de velocidad programados, cambio de IP pública, dispositivos nuevos en la red, conexión degradada, fallo de DNS y alarmas de salud.
  • Informes diarios y semanales, gráficas PNG y exportación a CSV.
  • Una interfaz de terminal al estilo Turbo Vision, con ventanas sombreadas y menús desplegables.

Usa solo la librería estándar de Python 3: sin dependencias, sin pip y sin root para comprobar la conexión.

El problema y el truco

Hay un problema con el que se topa cualquiera que construye esto. Con Internet caído, la Pi no puede escribir a Telegram, así que solo puede contarte una caída cuando la línea ya ha vuelto. Eso es útil, pero no es una alarma.

La solución es darle la vuelta. La Pi avisa cada minuto a un servicio externo, un latido, y es ese servicio quien te manda la alarma cuando los latidos dejan de llegar. También funciona si la Pi se queda sin corriente o se cuelga. Con Healthchecks.io, que es gratuito y de código abierto, se monta en unos minutos. Incluso puedes probar la alarma sin tocar un cable: un solo comando al bot pausa los latidos unos minutos.

Pruébalo

Crea un bot con @BotFather en Telegram, descarga el .deb de la página de releases e instálalo en tu Pi:

sudo apt install ./internet-check_1.7.1_all.deb
sudo nano /etc/internet-check/bot.env      # token y chat id
sudo systemctl restart internet-check

Después desconecta el cable de red un minuto y vuelve a conectarlo. El primer aviso no tardará.

Privado por defecto

El token vive en un fichero que solo root puede leer y nunca aparece en los logs. El bot ignora cualquier chat que no hayas autorizado, y el reinicio remoto exige una confirmación que caduca, de modo que un botón antiguo no pueda reiniciar tu equipo. No hay telemetría de ningún tipo, y el escaneo de la red no sale de la Pi.

A hombros de gigantes

internet-check habla con la API de bots de Telegram, toma prestados servidores de test de velocidad de LibreSpeed, se apoya en Healthchecks.io para la alarma del latido, y pone nombre a los dispositivos que ve con el registro público de la IEEE. Su interfaz de terminal es un homenaje al Turbo Vision de Borland. Gracias a todos ellos.

El código está en GitHub con licencia GPL-3.0. Para ver toda tu red doméstica desde la terminal, prueba a su hermano lanwatch, y mantén a raya los logs de la Pi con logguard.