Un sistema de monitorización que da falsas alarmas es peor que no tener ninguno. Las reglas de alarma tienen tres ajustes contra el ruido. El debounce obliga a una condición a demostrarse antes de que la alarma se abra o se cierre. La histéresis añade un margen en el lado de cierre. El dampening mantiene abierta una alarma que no deja de oscilar.
Debounce
| Campo (JSON) | Etiqueta del formulario | Rango | Valor predeterminado |
|---|---|---|---|
debounce.mode | Contar en: Lecturas seguidas (count) o Segundos (hora del dispositivo) (duration) | count | |
debounce.raise | Activar tras este número de lecturas seguidas / Activar cuando sea verdadera durante (segundos) | 1 a 86.400 | 1 |
debounce.clear | Cerrar tras este número de lecturas seguidas / Cerrar cuando sea falsa durante (segundos) | 1 a 86.400 | 1 |
Por lecturas
La alarma se abre en la lectura número raise seguida cuya condición es verdadera, y se cierra en la lectura número clear seguida cuya condición es falsa. Una lectura en sentido contrario reinicia la cuenta. Con los valores predeterminados 1 y 1, la alarma sigue cada lectura.
Solo cuentan las lecturas que incluyen alguna de las claves de la regla. Un mensaje con otras claves no es una lectura para esta regla.
Por hora del dispositivo
La alarma se abre cuando la condición ha sido verdadera de forma continua durante raise segundos, medidos según las marcas de tiempo de las lecturas, no según el reloj del servidor. Se cierra de forma simétrica.
Importante
El tiempo solo avanza cuando llega una lectura. Si un dispositivo informa cada 10 minutos, «verdadera durante 60 segundos» se alcanza con la segunda lectura verdadera, 10 minutos después. Si el dispositivo deja de enviar, no se decide nada hasta que vuelva a enviar. Haga que los dispositivos repitan su estado periódicamente, o use una alarma de desconexión para el silencio.
Ejemplo: «puerta abierta durante 120 s» es door_open == true con Segundos (hora del dispositivo), raise 120.
Cambios de severidad
Dentro de una alarma abierta, un cambio de severidad espera el mismo debounce: una subida espera el número o el tiempo de activación, una bajada espera el número o el tiempo de cierre.
Histéresis
hysteresis (formulario: Histéresis (margen de cierre)) es un número absoluto, igual o mayor que 0. Amplía el umbral en el lado de cierre de las comparaciones de orden (>, >=, <, <=):
| Condición | Histéresis | Se abre | Se cierra |
|---|---|---|---|
temperature > 80 | 3 | por encima de 80 | en 77 o menos |
battery < 20 | 5 | por debajo de 20 | en 25 o más |
pressure >= 6 | 0.2 | en 6 o más | por debajo de 5,8 |
La histéresis no se aplica a == ni a !=, y se ignora cuando la regla tiene una condición clear explícita (esa condición decide). Así, un valor que oscila en torno al umbral no abre y cierra la alarma en cada lectura.
Dampening
El dampening se aplica a todas las reglas de umbral. Sin un bloque dampening, se usan los valores predeterminados:
| Campo | Significado | Rango | Valor predeterminado |
|---|---|---|---|
maxTransitions | Aperturas y cierres permitidos dentro de la ventana | 2 a 100 | 4 |
windowSec | La ventana | 10 a 86.400 s | 600 |
holdSec | Cuánto tiempo debe permanecer la condición despejada antes de que se cierre una alarma retenida | 1 a 86.400 s | 300 |
Cuando un cierre supondría más de maxTransitions aperturas y cierres dentro de windowSec, el cierre se retiene: la alarma sigue abierta y se marca como Flapping (cronología: Flapping: cierres retenidos). Solo se cierra después de que su condición haya estado despejada durante holdSec segundos de hora del dispositivo.
Con los valores predeterminados: una alarma que se abrió y se cerró dos veces en 10 minutos y se abre una tercera vez se mantiene abierta en su siguiente cierre hasta que la condición haya estado despejada durante 5 minutos.
Defina sus propios valores en modo JSON:
"dampening": { "maxTransitions": 6, "windowSec": 1800, "holdSec": 600 }
Ejemplos prácticos
Una sonda de temperatura ruidosa. Las lecturas cada 10 s saltan ±1 °C en torno a 80.
"severities": [ { "severity": "MAJOR", "condition": { "key": "temperature", "op": ">", "value": 80 } } ],
"debounce": { "mode": "count", "raise": 3, "clear": 3 },
"hysteresis": 2
Se abre con la tercera lectura seguida por encima de 80, se cierra con la tercera lectura seguida en 78 o menos.
Una puerta que puede quedar abierta brevemente.
"severities": [ { "severity": "WARNING", "condition": { "key": "door_open", "op": "==", "value": true } } ],
"debounce": { "mode": "duration", "raise": 300, "clear": 1 }
Se abre cuando la puerta ha estado abierta 5 minutos según el reloj del dispositivo (el dispositivo debe informar mientras la puerta está abierta). En modo de tiempo, una sola lectura nunca decide: la alarma se cierra con la segunda lectura de puerta cerrada, al menos 1 segundo después de la primera.
Una bomba que hace ciclos a propósito. Una regla sobre una presión que baja en cada ciclo de la bomba oscilaría. Aumente maxTransitions o holdSec para que el ciclo esperado no genere avisos, y mantenga el debounce corto para que una avería real se vea pronto.
Elegir los valores
| El dispositivo informa | Debounce sugerido |
|---|---|
| Cada pocos segundos | count de 3 a 5, o duration de 30 a 60 |
| Cada minuto | count de 2 a 3 |
| Cada 10 a 60 minutos | count de 1 a 2. Una regla duration requiere al menos un intervalo de informe. |
| Solo al cambiar | count 1; use el retardo propio del dispositivo, o un disparador «se mantiene así durante» de la tarjeta Rules |

