Integración domótica Fast.com, gratuita y de código abierto
La velocidad de tu conexión medida por Fast.com (Netflix): descarga, subida, latencia.
Publicado por William-De71
- Dispositivos
- Versión 0.1.0
- Requiere Gladys >=5.1.0
- ★ 0
Presentación
Esta integración mide tu conexión a Internet con Fast.com, la prueba de velocidad de Netflix, de forma automática o a demanda: velocidad de descarga y de subida, latencia en reposo, fluctuación y latencia con carga. Los valores se guardan en el historial de un dispositivo Fast.com, se muestran en un widget del panel y se pueden usar en escenas (prueba terminada, prueba fallida, conexión restablecida y una acción para lanzar una prueba).
Sin cuenta ni clave: como la página fast.com, la integración pide a Fast.com los servidores de Netflix más cercanos a tu línea, y luego descarga y sube datos cronometrando las respuestas. Fast.com no ofrece una API pública: la integración reproduce lo que hace su página web; Netflix puede cambiarla, y entonces haría falta una actualización de la integración.
Frente a la integración Speedtest.net de la tienda (servidores de Ookla), Fast.com mide hacia los servidores de Netflix que tu proveedor usa para emitir vídeo, a menudo dentro de su propia red, y además da la latencia con carga. Ambas pueden instalarse a la vez.
Transporte: cloud. El tráfico de la prueba va entre tu línea y los servidores de Netflix en Internet, que ven tu dirección IP pública (como con la página fast.com). La integración no guarda ni registra esa dirección.
Requisitos
- Gladys 5.1.0 o posterior.
- Una conexión a Internet. Una prueba mueve muchos datos en una línea rápida: de 1,2 a 1,4 GB a 1 Gbit/s en nuestras mediciones (ambos sentidos), proporcionalmente menos en una línea más lenta. Con una conexión limitada o 4G, elige un intervalo largo o desactiva la subida.
- Gladys mide a través de su propia conexión de red: si funciona por Wi-Fi, o en un puerto de red de 100 Mbit/s, es eso lo que limita el resultado.
Configuración
Nada es obligatorio: los valores por defecto funcionan.
| Campo | Por defecto | Valores |
|---|---|---|
| Prueba automática | Cada 3 horas | Cada 30 min, 1, 2, 3, 6 o 12 horas, una vez al día, o Desactivada |
| Duración máxima por sentido | 15 segundos | 10, 15, 20 o 30 s: cada sentido se detiene antes en cuanto es estable |
| Medir también la subida | Activado | Desactivado: solo descarga y latencia, aproximadamente la mitad de datos |
| Idioma de los nombres de funciones | Automático | El idioma de tu panel, o inglés, francés, alemán, español |
Botones de la pantalla de configuración:
- Iniciar una prueba ahora: lanza una prueba (de 15 a 40 segundos) y muestra su resultado.
- Diagnóstico: escribe el estado de la integración (ajustes, última prueba, caída en curso, memoria) en sus registros, sin dirección IP. Gladys no pasa ninguna variable de depuración al contenedor: usa este botón antes de informar de un problema y copia luego las líneas desde Ajustes → Supervisión.
La primera prueba automática empieza aproximadamente un minuto después del arranque; un reinicio de Gladys o de la integración no lanza una prueba adicional (la siguiente se programa a partir de la última).
Uso
Dispositivo
Abre Integraciones → Fast.com → Descubrimiento y añade el dispositivo Fast.com. Sus cinco valores se guardan en el historial:
| Función | Unidad | Qué es |
|---|---|---|
| Velocidad de descarga | Mbit/s | Velocidad de los últimos segundos de la descarga, tras el arranque |
| Velocidad de subida | Mbit/s | Igual para la subida (no se publica nada si no se mide) |
| Latencia en reposo | ms | Mediana de 12 viajes de ida y vuelta HTTP al servidor más cercano, línea en reposo |
| Fluctuación (jitter) | ms | Diferencia media entre dos viajes consecutivos |
| Latencia con carga | ms | Los mismos viajes mientras la descarga llena la línea (bufferbloat) |
Un umbral es una condición sobre estos valores en una escena («velocidad de descarga por debajo de 100 Mbit/s»), no un disparador.
Widget
El widget Velocidad de Internet muestra el proveedor y la antigüedad de la última prueba, las casillas de descarga, subida y latencia, un gráfico, la latencia con carga, la fluctuación, el servidor de Netflix, los datos usados, la hora de la próxima prueba y un botón Iniciar prueba (el resultado aparece al final, sin esperar ante un indicador de carga). Ajustes: el gráfico (descarga y subida, latencia y fluctuación, o ninguno) y su periodo (de 24 horas a 3 meses). El gráfico lee el historial del dispositivo: añade primero el dispositivo.
Disparadores de escena
- Fast.com: prueba terminada: tras cada prueba correcta, con cada valor como variable (
{{triggerEvent.data.download_mbps}},upload_mbps,latency_ms,jitter_ms,loaded_latency_ms,isp,server_city,data_used_mb,cpu_limited…). Filtro: iniciada por la programación o por una persona. - Fast.com: prueba fallida: Internet inaccesible (
offline), Fast.com rechaza la prueba (service) o no se transfirió nada (measurement), con el número de fallos seguidos. Filtros: motivo, iniciada por. - Fast.com: conexión restablecida: Fast.com vuelve a responder tras pruebas fallidas (se comprueba cada 5 minutos durante la caída, unos pocos kilobytes cada vez), con
outage_minutes.
Acción de escena
Fast.com: iniciar una prueba de velocidad (con o sin subida) espera el resultado (120 s como máximo) y pasa sus valores a las acciones siguientes: descarga, subida, latencia, fluctuación, latencia con carga, proveedor, ciudad del servidor, datos usados, límite del procesador y un resumen (↓ 923.6 Mbit/s · ↑ 717.6 Mbit/s · 10.5 ms). Nunca activa un disparador de Fast.com, y se une a una prueba ya en curso en lugar de lanzar una segunda.
Ejemplos de escenas
- Reiniciar el router: disparador «prueba fallida» con el motivo «Internet inaccesible» → apagar el enchufe inteligente del router, esperar 30 segundos, encenderlo.
- Informe de caída: disparador «conexión restablecida» → enviar el mensaje «Internet de vuelta tras {{triggerEvent.data.outage_minutes}} min».
- Control nocturno: cada día a las 21 h → iniciar una prueba de velocidad → si la velocidad de descarga es inferior a 100 Mbit/s, enviar «Línea lenta: {{…summary}}».
Solución de problemas
- La velocidad es más baja de lo esperado: otro dispositivo estaba descargando o viendo un vídeo durante la prueba (la línea es compartida); Gladys está en Wi-Fi o en un puerto de 100 Mbit/s; o el procesador limitó la prueba (ver abajo). Compara al mismo tiempo con fast.com en un navegador en un ordenador por cable.
- «Limitada por el procesador»: la integración dispone de 0,5 CPU y su bucle de eventos se retrasó durante la prueba: las velocidades pueden estar subestimadas, y la latencia con carga se descarta en lugar de ser errónea. Ocurre en placas pequeñas con líneas muy rápidas (por encima de unos cientos de Mbit/s en una Raspberry Pi 4, que no tiene instrucciones AES). Reduce la carga de la máquina, o toma el resultado como un mínimo.
- «Fast.com rechazó la prueba»: Netflix cambió su página o su token. La integración vuelve a leer el token en cada rechazo y comprueba cada 5 minutos; si persiste, actualiza la integración e informa de ello.
- «Internet o Fast.com inaccesible» aunque Internet funciona: un filtro DNS, un bloqueador de anuncios (Pi-hole, AdGuard) o un cortafuegos puede bloquear
fast.com,api.fast.como*.oca.nflxvideo.net: permítelos. - No hay gráfico en el widget: añade el dispositivo Fast.com desde el Descubrimiento; el historial empieza con la siguiente prueba.
- Los valores difieren de la página fast.com: en unos pocos por ciento, porque la regla de parada y el promedio no son idénticos; lo que cuenta es la evolución en el tiempo.
Limitaciones
- No oficial: Fast.com no tiene API pública; la integración reproduce su cliente web y depende de él.
- El servidor lo elige Fast.com; no se puede forzar IPv4 o IPv6.
- Una sola prueba a la vez; una prueba dura de 15 a 40 segundos, 110 segundos como máximo.
- La subida se cuenta cuando los datos salen de la integración hacia la red: exacta una vez que la transferencia es regular (4,9 Mbit/s medidos en una línea limitada a 5 Mbit/s), lo que espera la regla de parada.
- Medida en condiciones reales en un enlace de 1 Gbit/s desde un ordenador x86, también limitado a 0,5 CPU y 256 MB como en Gladys. No medida en una Raspberry Pi ni por encima de 1 Gbit/s.
Parámetros de configuración
Estos son los parámetros que Fast.com te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Cómo mide | section | No | Sin cuenta ni clave: como la página fast.com, la integración descarga y luego sube datos a los servidores de Netflix más cercanos a tu línea, y cronometra sus respuestas. Una prueba dura de 15 a 40 segundos y consume mucho en una línea rápida (unos 1,3 GB a 1 Gbit/s): mantén un intervalo razonable con una conexión limitada o 4G. Los demás dispositivos que usan la línea durante una prueba bajan el resultado. |
| Prueba automática | select | No | Con qué frecuencia se lanza una prueba sola. «Desactivada»: solo desde el widget, una escena o el botón de abajo. |
| Duración máxima por sentido | select | No | Descarga y luego subida: cada una se detiene en cuanto la velocidad es estable, como mucho tras esta duración. Más corta consume menos, más larga es más regular en líneas inestables. |
| Medir también la subida | boolean | No | Desactivado: solo descarga y latencia, aproximadamente la mitad de datos. |
| Idioma de los nombres de funciones | select | No | Nombres de las funciones del dispositivo al añadirlo. Automático: el idioma de tu panel, en cuanto se haya mostrado el widget. |
Cómo instalar Fast.com en Gladys
- En Gladys, abre Integraciones: Fast.com 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/william-de71/gladys-fast-com:0.1.0), 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/William-De71/gladys-fast-com.
Fast.com 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
Fast.com 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 William-De71, 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