Integración domótica NetAlertX, gratuita y de código abierto
Quién está en su red: presencia de cada dispositivo y una alerta cuando se conecta uno desconocido.
Publicado por guim31
- Dispositivos
- Versión 1.0.0
- Requiere Gladys >=5.1.0
- ★ 0
Sepa desde Gladys quién está en su red. NetAlertX (antes Pi.Alert) escanea su red y mantiene la lista de todos los dispositivos que ha visto. Esta integración lleva esa lista a Gladys: la presencia de los móviles, ordenadores y otros dispositivos que usted elija seguir, contadores para toda la red y, sobre todo, un activador de escena cuando se conecta un dispositivo desconocido.
Usos típicos: recibir un aviso en el móvil cuando un dispositivo que nadie conoce se une al wifi, marcar a alguien en casa cuando su móvil está en la red, recibir una alerta cuando el NAS o una cámara desaparece de la red, ver de un vistazo en el panel qué dispositivos nuevos quedan por confirmar.
Probada con un NetAlertX real (26.10.0, en Docker), aún no en una instalación real: sus comentarios son bienvenidos. La integración se comprobó con la API real de NetAlertX (dispositivos que llegan, que se van, un dispositivo nuevo, «marcar como conocido»), pero aún no con un Gladys real y una red doméstica real. Cuéntenos en el foro de Gladys cómo se comporta en su casa.
Lo que obtiene
-
Un dispositivo Red NetAlertX, el resumen de toda la red:
Función Tipo en Gladys Muestra Dispositivos en línea contador (entero) dispositivos presentes en el último escaneo de NetAlertX Dispositivos sin conexión contador (entero) dispositivos ausentes del último escaneo Dispositivos nuevos contador (entero) dispositivos que NetAlertX marca como nuevos (aún no confirmados) Alertas de caída contador (entero) dispositivos sin conexión con Alert Down activado en NetAlertX -
Un dispositivo por cada dispositivo de red que elija seguir (todos los dispositivos de NetAlertX se proponen en la pestaña Descubrir, salvo los archivados):
Función Tipo en Gladys Muestra Presencia sensor de presencia (sí/no) «Presencia detectada» mientras NetAlertX lo ve en la red Dirección IP texto su última dirección IP Visto por última vez texto la última vez que NetAlertX lo vio, en la hora de Gladys -
Un widget de panel, Vigilancia de la red: dispositivos en línea, dispositivos nuevos y dispositivos caídos, con un botón Conocido para los nuevos.
-
Cuatro activadores de escena (Un dispositivo nuevo se une a la red, Un dispositivo deja la red, Un dispositivo vuelve a la red, Un dispositivo vigilado está caído) y una acción de escena, Marcar un dispositivo como conocido (NetAlertX).
Requisitos
- Gladys Assistant 5.1.0 o posterior (widgets, activadores y acciones de escena).
- Un NetAlertX en funcionamiento que Gladys pueda alcanzar en la red local. La integración lee
su API (el servidor «GraphQL», puerto 20212 por defecto, ajuste
GRAPHQL_PORT), no la interfaz web (puerto 20211). Se probó NetAlertX 26.x; cualquier versión con token de API y API GraphQL (2024 y posteriores) debería funcionar. - El token de API de NetAlertX: en su interfaz web, Settings → General → API token
(ajuste
API_TOKEN, empieza port_). - Nada más: ni nube, ni cuenta. NetAlertX hace los escaneos, la integración solo lee sus resultados.
Configuración
Ajustes
- Instale la integración (Integraciones → Instalar desde GitHub, dirección
https://github.com/guim31/gladys-netalertx) y, después, abra su pestaña Configuración. - Dirección de la API: la dirección IP o el nombre del servidor NetAlertX, p. ej.
192.168.1.10. Sin puerto, se usa20212; añada:puertosi cambióGRAPHQL_PORT, yhttps://si la API está detrás de un proxy inverso. - Token de API: pegue el
API_TOKENde NetAlertX. - Intervalo de lectura: con qué frecuencia la integración lee la lista de dispositivos
(1 minuto por defecto). NetAlertX escanea por sí mismo cada 5 minutos por defecto
(
ARPSCAN_RUN_SCHD): leer más a menudo solo ve un escaneo antes. - Idioma de los nombres: idioma de los nombres de los nuevos dispositivos y de sus funciones, de los mensajes y de las fechas (francés por defecto).
- Guarde. El estado de conexión se pone en verde y los dispositivos aparecen en la pestaña Descubrir.
Acciones de configuración
- Probar la conexión: lee NetAlertX una vez e indica cuántos dispositivos conoce, cuántos están en línea y cuántos son nuevos.
- Marcar todos los dispositivos nuevos como conocidos: justo después de instalar NetAlertX, todos los dispositivos son «nuevos». Esta acción quita la marca a todos de una vez, para que solo los dispositivos que lleguen después cuenten como nuevos (en el contador, el widget y el activador).
Elegir los dispositivos
En la pestaña Descubrir, añada el dispositivo Red NetAlertX para los contadores, y los dispositivos que quiera seguir uno a uno (móviles, ordenadores, servidores, cámaras…). Los demás se quedan en NetAlertX: los activadores funcionan para todos los dispositivos de NetAlertX, creados en Gladys o no.
Dispositivos
- Presencia sigue el «presente en el último escaneo» de NetAlertX: cambia en el escaneo que ve el dispositivo irse o volver, sin retraso añadido por la integración. Mientras el dispositivo está presente, «presente» se vuelve a publicar en cada escaneo de NetAlertX, para que la acción de escena Comprobar presencia del usuario de Gladys vea el dispositivo como visto recientemente (vea los ejemplos de escenas).
- Dirección IP y Visto por última vez son textos, actualizados cuando cambian. La fecha viene de NetAlertX y se muestra en la zona horaria de Gladys.
- Los nombres son los que muestra NetAlertX (configúrelos en NetAlertX antes de añadir el dispositivo: el nombre queda fijado al crearlo en Gladys). Un dispositivo sin nombre muestra su fabricante y el final de su dirección MAC, o su dirección MAC.
- Los cuatro contadores de Red NetAlertX guardan historial: un gráfico muestra cuántos dispositivos estaban en línea a lo largo del día.
Widget de panel
Vigilancia de la red muestra tres mosaicos (dispositivos en línea, nuevos y caídos) y, después, la lista de los dispositivos nuevos (con su dirección IP, o «sin conexión») y de los dispositivos caídos, diez filas como máximo. Cada uno de los cuatro primeros dispositivos nuevos recibe un botón Conocido, que lo marca como conocido en NetAlertX. Cuando no hay nada que señalar, una línea corta lo indica.
Activadores de escena
| Activador | Se activa cuando | Filtro | Información transmitida |
|---|---|---|---|
| Un dispositivo nuevo se une a la red | NetAlertX ve un dispositivo por primera vez, marcado como nuevo | ninguno | nombre, dirección MAC, fabricante, dirección IP |
| Un dispositivo deja la red | un dispositivo visto en el escaneo anterior falta en el último | dispositivo (vacío: cualquiera) | nombre, dirección MAC, dirección IP |
| Un dispositivo vuelve a la red | un dispositivo ausente del escaneo anterior se vuelve a ver | dispositivo (vacío: cualquiera) | nombre, dirección MAC, dirección IP |
| Un dispositivo vigilado está caído | un dispositivo con Alert Down activado en NetAlertX se desconecta | dispositivo (vacío: cualquiera) | nombre, dirección MAC, dirección IP, visto por última vez |
La primerísima lectura tras la instalación solo registra la red: ningún activador para los
dispositivos que ya estaban. La integración recuerda la última lista leída (en /data): un
reinicio no vuelve a anunciar todos los dispositivos ni se pierde lo que cambió mientras estaba
parada. Se envían como máximo 20 eventos por lectura, los siguientes en las lecturas posteriores; un evento que Gladys no pudo recibir (durante su reinicio) se vuelve a enviar en la lectura siguiente.
Acciones de escena
- Marcar un dispositivo como conocido (NetAlertX): quita la marca «nuevo» de un dispositivo en NetAlertX, como la casilla New Device de su ficha. El campo Dirección MAC acepta variables de escena: tras el activador Un dispositivo nuevo se une a la red, inserte su Dirección MAC. Devuelve Hecho (1 = sí); con un dispositivo desconocido o NetAlertX inaccesible, la acción falla y la escena continúa.
Ejemplos de escenas
- Dispositivo desconocido en el wifi: activador Un dispositivo nuevo se une a la red → acción Enviar un mensaje: «Nuevo dispositivo en la red: {nombre} ({fabricante}, {IP})». Añada Marcar un dispositivo como conocido con la dirección MAC al final si lo confirma directamente (de lo contrario, solo se avisa una vez de todos modos: el activador solo salta en su primera aparición).
- Alguien está en casa: activador «un dispositivo cambia de estado» en la Presencia de su móvil (igual a 1) → acción Usuario visto en casa. Una segunda escena, ejecutada cada 10 minutos, hace Comprobar presencia del usuario con su móvil y 15 minutos: Gladys lo marca ausente en cuanto NetAlertX deja de verlo.
- El NAS se ha caído: active Alert Down en el NAS en NetAlertX y, después, activador Un dispositivo vigilado está caído (dispositivo: el NAS) → mensaje «El NAS ha dejado la red (visto por última vez {visto por última vez})».
Solución de problemas
- «NetAlertX rechaza el token de API»: copie de nuevo el token desde Settings → General → API token. Si genera un token nuevo en NetAlertX, actualícelo aquí.
- «Esta dirección no responde como la API de NetAlertX»: la dirección apunta a la interfaz web
(20211) o a otro servicio. Use el puerto de la API, 20212 por defecto (
GRAPHQL_PORT). - «NetAlertX no responde»: compruebe que Gladys puede alcanzar el servidor NetAlertX y su puerto (cortafuegos, puerto Docker publicado). Con NetAlertX en Docker en la red del host, la API escucha en la dirección del host.
- Un móvil aparece sin conexión estando en casa: los móviles en reposo wifi no siempre responden al escaneo ARP, y los móviles recientes usan una dirección MAC privada (aleatoria) por red. Desactive la dirección privada para el wifi de casa y consulte los ajustes de dispositivos en reposo de NetAlertX.
- Todos los dispositivos son «nuevos»: así arranca NetAlertX. Ejecute una vez Marcar todos los dispositivos nuevos como conocidos.
- Registros: la integración solo escribe los eventos importantes (NetAlertX perdido y
recuperado, dispositivos que se van, que vuelven, nuevos). Ponga
LOG_LEVEL=debugen el contenedor para ver cada lectura.
Límites
- La integración lee NetAlertX; no escanea nada por sí misma. La presencia solo es tan reciente como los escaneos de NetAlertX (cada 5 minutos por defecto).
- Visto por última vez supone que las fechas de NetAlertX están en UTC, como en NetAlertX 26.x. Las versiones anteriores guardaban la hora local: la hora puede salir desplazada.
- Un dispositivo con «Alert Down» que NetAlertX deja dormir («Can sleep») activa igualmente Un dispositivo vigilado está caído cuando desaparece: la integración no lee la ventana de reposo.
- Se proponen como máximo 500 dispositivos en la pestaña Descubrir. Los dispositivos archivados se ignoran.
- El filtro de dispositivo de los activadores lista los dispositivos creados en Gladys; déjelo vacío para reaccionar a cualquier dispositivo de NetAlertX.
- Sin relación con NetAlertX.
Parámetros de configuración
Estos son los parámetros que NetAlertX te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Su NetAlertX | section | No | NetAlertX escanea su red y mantiene la lista de sus dispositivos. En NetAlertX, copie el token de API desde Ajustes → General (API token). La integración lee la API, en el puerto 20212 por defecto (GRAPHQL_PORT), no la interfaz web en el 20211. |
| Dirección de la API | string | Sí | Dirección IP o nombre del servidor NetAlertX, con :puerto si la API no está en el 20212, y https:// detrás de un proxy inverso. |
| Token de API | secret | Sí | El ajuste API_TOKEN de NetAlertX (empieza por t_). |
| Intervalo de lectura | select | No | Con qué frecuencia se lee la lista de dispositivos de NetAlertX. NetAlertX escanea por sí mismo cada 5 minutos por defecto. |
| Idioma de los nombres | select | No | Nombres dados a los nuevos dispositivos y a sus funciones (Presencia, Dirección IP…), e idioma de los mensajes y las fechas. |
Cómo instalar NetAlertX en Gladys
- En Gladys, abre Integraciones: NetAlertX 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-netalertx:1.0.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/guim31/gladys-netalertx.
NetAlertX 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
NetAlertX 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