Integración domótica Speedtest.net & Cloudflare, gratuita y de código abierto
Mida periódicamente la velocidad de su conexión con Speedtest.net o Cloudflare.
Publicado por guim31
- Dispositivos
- Versión 1.6.1
- Requiere Gladys >=5.1.0
- ★ 0
Mida periódicamente su conexión a Internet, directamente desde Gladys, con la red mundial de servidores de Speedtest.net o la prueba de velocidad de Cloudflare. Cada prueba alimenta cuatro sensores que puede mostrar en gráficos en el panel y usar en escenas:
| Sensor | Unidad | Lo que indica |
|---|---|---|
| Download | Mbit/s | La velocidad a la que llegan los datos a su casa |
| Upload | Mbit/s | La velocidad a la que salen los datos de su casa |
| Ping | ms | El tiempo de reacción de la conexión (cuanto menos, mejor) |
| Jitter | ms | La estabilidad de ese tiempo de reacción (cuanto menos, mejor) |
Usos típicos: comprobar lo que su proveedor ofrece realmente, recibir un aviso de una escena cuando la descarga baja de lo que paga, o detectar que una línea de respaldo (conmutación 4G…) ha tomado el relevo.
Cómo funciona una prueba
La integración habla directamente con la infraestructura de Speedtest.net — sin cuenta, sin clave de API, sin software de Ookla instalado. Por defecto, sondea los servidores más cercanos, se queda con el más sano y mide la latencia, la descarga y la subida (unos 25 segundos en total). También puede fijar un servidor: el botón Listar servidores cercanos muestra los ID, que puede pegar en el campo ID del servidor Speedtest.net.
Elegir el motor
El campo Motor de prueba elige contra quién mide. Los dos motores alimentan los mismos cuatro sensores, con la misma programación, las mismas conexiones paralelas y la misma duración de medición: al cambiar de motor conserva el dispositivo, su historial y sus escenas.
- Speedtest.net (por defecto): un servidor cercano de la red Speedtest.net, elegido automáticamente o fijado por su ID.
- Cloudflare: el punto de presencia más cercano de la red de Cloudflare, el de speed.cloudflare.com. Sin servidor que elegir, sin cuenta. El widget lo muestra como Cloudflare seguido del código de aeropuerto de su ciudad (MAD para Madrid, CDG para París…).
El motor Cloudflare también puede mostrar su dirección IP pública, tal como la ve Cloudflare: active Mostrar mi IP pública (Cloudflare). Aparece entonces en el widget y en el resultado de la prueba manual, y se guarda con el último resultado en el almacenamiento de la integración. Nunca se escribe en los registros. Desactivado por defecto.
Cloudflare mide la latencia sobre una petición vacía, menos el tiempo de procesamiento que indica su servidor, y se queda con la mejor de 20 muestras; el jitter es la diferencia media entre muestras sucesivas, como con Speedtest.net. Las cifras de los dos motores son cercanas pero no idénticas: compare una línea consigo misma, con un mismo motor.
Lo que conviene saber
- Una prueba satura la conexión mientras dura. En líneas muy rápidas, los resultados también son algo conservadores, porque la medición comparte la CPU con los límites que Gladys impone a las integraciones.
- Una prueba transfiere datos reales — varios cientos de MB por prueba en una línea rápida, sea cual sea el motor (en una fibra gigabit, hasta unos 1,5 GB por sentido con los ajustes por defecto). Si su tarifa tiene un límite de datos, aumente el intervalo entre pruebas o desactive las pruebas automáticas y use solo el botón manual.
- Cloudflare limita el uso intensivo. Tras mucho tráfico en poco tiempo (dos pruebas gigabit con pocos minutos de diferencia, en nuestros ensayos), rechaza durante un tiempo las descargas grandes con un error HTTP 429: la prueba falla entonces con un mensaje que lo indica, y la siguiente prueba programada lo vuelve a intentar. Una prueba automática nunca se lanza con más frecuencia que cada 10 minutos.
- Las pruebas programadas siguen el ajuste Intervalo entre pruebas (por defecto: una prueba por hora). El botón Iniciar una prueba de velocidad funciona en cualquier momento.
Widget del panel
Con Gladys 5.1 o posterior, la integración añade un widget Velocidad de Internet al editor del panel (Agregar → Speedtest.net & Cloudflare). Muestra:
- dos mosaicos lado a lado, descarga y subida: en Mb/s enteros, o en Gb/s con un decimal a partir de 1000 Mb/s (1,2 Gb/s);
- un gráfico de áreas del historial de dos sensores: Gráfico elige Descarga y subida (por defecto) o Ping y jitter, Periodo del historial las últimas 24 horas, la última semana (por defecto) o el último mes;
- el ping y el jitter de la última prueba, cuándo se hizo y el servidor usado (Speedtest.net: operador y ciudad; Cloudflare: Cloudflare · MAD), su IP pública si la ha pedido, y Prueba en curso mientras una prueba se ejecuta;
- un botón Iniciar prueba. El resultado aparece como notificación al terminar la prueba (alrededor de medio minuto). Pulsarlo mientras ya hay una prueba en curso no lanza otra.
Visualización aligera el widget: Completo (por defecto) es la presentación anterior; Velocidades, ping y gráfico conserva tres casillas (descarga, subida, ping) y el gráfico; Velocidades y ping solo las tres casillas. Estas dos no tienen líneas de estado ni botón: una prueba se sigue iniciando desde la configuración de la integración.
Botón «Iniciar prueba»: Según la visualización (por defecto: solo en la completa), Siempre o Nunca, para cada widget.
Conviene saber:
- El gráfico lee los sensores del dispositivo: añada el dispositivo a Gladys (Integraciones → Speedtest.net & Cloudflare → Descubrir) para que se llene.
- El widget solo redondea lo que muestra: Gladys guarda los valores medidos, con decimales, en los sensores y su historial.
- La integración conserva el último resultado entre reinicios. Antes de la primera prueba, los mosaicos muestran un guion y el widget indica que todavía no hay ningún resultado.
- Los periodos del gráfico y el historial largo siguen sus ajustes de Gladys de conservación de los datos de los dispositivos.
Escenas
- Disparador Prueba automática de velocidad fallida: una prueba automática no pudo realizarse, a menudo porque Internet está caído. Variables: el error y el número de fallos seguidos. Las pruebas se realizan cada hora por defecto (cada 10 minutos como mínimo): un corte breve entre dos pruebas no se ve.
- Acción Iniciar una prueba de velocidad: espera el resultado (unos 30 s) y pasa a las acciones siguientes Prueba correcta, la descarga, la subida, el ping y el jitter, o el error. Una prueba fallida no hace fallar la acción: Prueba correcta lo indica, en un mensaje por ejemplo. La prueba también actualiza los sensores del dispositivo, que una condición puede comprobar. Una prueba iniciada por una escena nunca activa el disparador anterior.
Ejemplo: cuando el ping supera 300 ms (disparador sobre el valor del dispositivo), enviar una notificación, esperar 2 minutos, iniciar una prueba de velocidad y continuar solo si el ping sigue alto.
Solución de problemas
- Resultados más bajos que la aplicación oficial: aumente Conexiones paralelas (las líneas rápidas se llenan mejor con 6–8) o la Duración de medición.
- La prueba falla: puede que el servidor más cercano esté caído — fije otro ID del servidor Speedtest.net, o vacíe el campo para que la selección automática descarte los servidores defectuosos. Con el motor Cloudflare, un error HTTP 429 significa que Cloudflare limita su dirección durante un tiempo: aumente el intervalo o reduzca la duración de medición.
- El ID del servidor no cambia nada: solo sirve para el motor Speedtest.net.
- Registros: en el nivel por defecto, la integración registra su inicio, sus
pruebas manuales y el primer fallo de la prueba automática (y luego una línea
cuando vuelve a funcionar). Para ver cada prueba, su servidor y su
resultado, defina la variable de entorno
LOG_LEVEL=debugen el contenedor.
Esta integración es un proyecto comunitario independiente, sin afiliación ni respaldo de Ookla ni de Cloudflare. Speedtest® es una marca de Ookla, LLC; Cloudflare® es una marca de Cloudflare, Inc.
Parámetros de configuración
Estos son los parámetros que Speedtest.net & Cloudflare te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Funcionamiento | section | No | Una prueba satura la conexión durante unos 25 segundos y puede transferir varios cientos de MB, sea cual sea el motor: tenga en cuenta su límite de datos al elegir el intervalo. Los resultados alimentan cuatro sensores (descarga, subida, ping, jitter) que puede usar en gráficos y escenas. |
| Motor de prueba | select | No | Speedtest.net mide contra un servidor cercano; Cloudflare contra su punto de presencia más cercano, sin elegir servidor. |
| Ejecutar las pruebas automáticamente | boolean | No | Si está desactivado, las pruebas solo se inician con el botón manual de abajo. |
| Intervalo entre pruebas (s) | number | No | Segundos entre dos pruebas automáticas. 3600 = una prueba por hora. |
| ID del servidor Speedtest.net (opcional) | string | No | Deje en blanco para elegir automáticamente el mejor servidor cercano. El botón «Listar servidores cercanos» muestra los ID. |
| Mostrar mi IP pública (Cloudflare) | boolean | No | Solo motor Cloudflare: guarda la dirección IP pública que ve y la muestra en el widget y en el resultado. Nunca se escribe en los registros. |
| Conexiones paralelas | number | No | Conexiones TCP por sentido. Cuantas más haya, mejor se aprovechan las líneas rápidas. |
| Duración de medición por sentido (s) | number | No | Una medición más larga es más estable, pero transfiere más datos. |
Cómo instalar Speedtest.net & Cloudflare en Gladys
- En Gladys, abre Integraciones: Speedtest.net & Cloudflare aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/guim31/gladys-speedtest:1.6.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-speedtest.
Speedtest.net & Cloudflare requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Speedtest.net & Cloudflare es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene guim31, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación