Reglas y automatización
Actúa sobre datos en tiempo real, con un interruptor para detenerlo
Tres herramientas actúan sobre los datos de los dispositivos: reglas de alarma en un perfil de dispositivo, reglas en una tarjeta Rules y flows. Elige la más sencilla que haga el trabajo. Cada lugar tiene un interruptor Manual y Auto, y los flows incluyen protecciones contra automatizaciones descontroladas.
Tres herramientas
Qué herramienta usar
Las tres usan las mismas alarmas, comandos y notificaciones.
| Reglas de alarma | Tarjeta Rules | Flows | |
|---|---|---|---|
| Úsala para | Abrir una alarma cuando un valor supera un límite o un dispositivo deja de responder | Cuando ocurre esto, si se cumple aquello, haz esto, para un emplazamiento o un dispositivo | Cualquier procesamiento que puedas dibujar como bloques: transformar, enriquecer, enrutar, llamar a sistemas externos |
| Dónde vive | El perfil de dispositivo, para cada dispositivo de ese perfil | Una tarjeta Rules en un panel, vinculada a un activo o a un dispositivo | Automatización, en el host IoT o en el host General |
| Ejemplo | temperature por encima de max_temp del dispositivo durante 60 segundos abre una alarma Major | Encender el ventilador cuando la sala se mantiene por encima de 28 °C durante cinco minutos en horario laboral | Convertir el contador de un medidor en consumo por hora y guardarlo como una clave nueva |
| Límites | 50 reglas por perfil, 16 comparaciones por condición | 10 disparadores, 16 condiciones y 20 acciones por regla | Versiones, un ejecutor de pruebas y pausa automática |
| Documentación | Reglas de alarma | El motor de reglas | Flows |
Escribir una regla
Cuándo, solo si, entonces
Las reglas se escriben en el cajón de una tarjeta Rules, sin dibujar un flow. Cada una se ejecuta como un flow en segundo plano.
1
Cuándo
Un valor cruza una línea o permanece en ella durante un tiempo; un dispositivo se conecta, se desconecta o queda inactivo; una alarma se activa o se borra; una hora del día, cada N minutos, amanecer o anochecer, una fecha; o una ejecución manual.
2
Solo si
Otros valores, el estado de un dispositivo, una alarma activa, una ventana horaria, día o noche, una ventana de fechas, el calendario de festivos de tu organización, o una fórmula sobre valores de dispositivos.
3
Entonces
Enviar un comando, cambiar un ajuste de un dispositivo, notificar a usuarios, roles o equipos, activar o borrar una alarma, esperar, esperar hasta que algo se cumpla, elegir entre hasta cinco ramas, o activar o desactivar otra regla.
Manual y Auto
Detén la automatización de un lugar con un solo interruptor
Cada activo y cada dispositivo tiene un modo, y Auto es el predeterminado. En Manual, se detiene cada regla cuyo origen está en ese lugar, las ejecuciones en curso se detienen en su siguiente paso, y ninguna regla de ningún sitio envía un comando o un ajuste a sus dispositivos. Un lugar está en Manual cuando lo está él o cualquier activo por encima de él.
- Manual hasta: 30 minutos, 1 hora, 4 horas, una hora fijada o indefinidamente; a la persona que lo configuró se le avisa cuando vuelve Auto
- También se ejecuta en Manual: una regla con solo acciones de notificar y alarma puede seguir ejecutándose, para que los avisos de seguridad sigan saliendo
- Al volver a Auto se listan las reglas cuyos disparadores se cumplen ahora, y se pueden ejecutar una vez con los valores actuales
- Cada cambio queda auditado y se envía como el evento de webhook
rules.mode_changed
Manual se aplica a las reglas de las tarjetas Rules. Las reglas de alarma en perfiles de dispositivo son una herramienta aparte.
Límites de una regla
- Una acción sobre un tipo de dispositivo se ejecuta una vez para cada dispositivo de ese tipo en el lugar, hasta 200 dispositivos
- Una espera dura como máximo 24 horas; un temporizador de «se mantiene así durante» como máximo 24 horas, y sobrevive a un reinicio
- Las reglas comparan con valores fijos. Los límites por dispositivo corresponden a las reglas de alarma, que pueden leer un atributo del dispositivo como umbral
- Una regla que nombra un dispositivo eliminado pasa a Requiere atención y se detiene hasta que alguien la edite
- Las reglas tienen su propio límite de plan y no cuentan contra tus flows
Flows
Flows con versiones y una parada de emergencia
El flow raíz de tu organización guarda telemetría y atributos y ejecuta las reglas de alarma para cada mensaje de dispositivo. Otros flows añaden cualquier procesamiento que puedas dibujar como bloques. Cada despliegue es una versión nueva a la que puedes volver.
- Un ejecutor de pruebas antes de desplegar
- Pausa automática de un flow que falla o se ejecuta con demasiada frecuencia, con una alerta
- Detección de bucles, límites de comandos por dispositivo y una parada de emergencia
- Mensajes fallidos conservados para reproducir o eliminar
Bloques de flow
Bloques para las tareas habituales
Cada bloque tiene su propia ayuda en el editor. Los flows se exportan e importan como archivos, y las plantillas te dan un punto de partida.
Programaciones y webhooks
Inicia un flow a diario, con una expresión cron, al amanecer o al anochecer, o cuando un sistema externo llama a la dirección del flow.
Contadores y estadísticas
Incrementos de un contador de medidor, gestionando los reinicios; recuentos en una ventana; y cuenta, suma, media, mínimo, máximo y tasa sobre un número de mensajes o hasta 7 días.
Vigilancia y bandas muertas
Detecta una clave que dejó de llegar, y reenvía solo los cambios mayores que una banda muerta, como valor o como porcentaje.
Enriquecer y guardar
Añade los campos y atributos del dispositivo, entidades relacionadas o últimos valores, y guarda las claves derivadas como telemetría del dispositivo del mensaje.
Sistemas externos
Peticiones HTTP con tokens bearer o credenciales de cliente OAuth2, bloqueando direcciones privadas; MQTT saliente hacia otros brokers; avisos por correo electrónico con adjuntos.
Alarmas y comandos
Activa, borra y reconoce alarmas con el ciclo de vida normal, y envía comandos del catálogo al dispositivo del mensaje.
Preguntas frecuentes
Preguntas sobre reglas y flows
¿Necesito escribir código?
No. Las reglas de alarma y las reglas de la tarjeta Rules son formularios. Los flows se dibujan con bloques; hay un bloque de script para los casos que los bloques no cubren.
¿Qué pasa con la automatización mientras alguien trabaja en el sitio?
Cambia el lugar a Manual. Sus reglas se detienen, y ninguna regla envía comandos o ajustes a sus dispositivos hasta que vuelva a Auto. Las reglas de solo notificación marcadas como También se ejecuta en Manual siguen funcionando.
¿Puede una regla escalar una alarma que nadie reconoció?
No como condición de regla: la comprobación de alarmas activas no distingue las alarmas reconocidas de las no reconocidas. Usa en su lugar el recordatorio repetido de la regla de alarma y sus niveles de severidad; una severidad creciente vuelve a notificar.
¿Puede cada dispositivo tener su propio límite?
En las reglas de alarma, sí: el umbral puede ser un atributo del dispositivo, como max_temp. Las reglas de la tarjeta Rules comparan con valores fijos, y una regla se dirige a un dispositivo o a todos los dispositivos de un perfil en su lugar, así que usa perfiles separados cuando los dispositivos deban comportarse de forma distinta.
¿Pueden los flows llegar a nuestros otros sistemas?
Sí: peticiones HTTP, MQTT saliente y flows iniciados por una llamada webhook. Los webhooks salientes firmados también informan de eventos de dispositivos, alarmas, comandos, firmware y reglas.
¿Automatizas un sitio?
Cuéntanos qué debe pasar y cuándo. Te decimos si encaja una regla, una alarma o un flow, y configuramos la primera contigo.