Alertas del dispositivo eGauge

Las alertas del dispositivo eGauge permiten que el medidor registre y envíe alertas que pueden activarse ante una variedad de condiciones, como un cambio en la configuración del medidor, una falla del dispositivo SunSpec remoto o alertas personalizadas avanzadas, como un voltaje fuera del rango esperado.

Las alertas se muestran en la interfaz moderna mediante el Visor de alertas y pueden configurarse para enviarse por correo electrónico o HTTP POST con datos en formato JSON.

Acceder a la configuración de alertas

Para acceder a la página de Configuración de alertas, desde el menú principal acceda a Configuración → Alertas :

Secciones de configuración

Hay 3 secciones principales para configurar las alertas:

• Alertas personalizadas: Son alertas personalizadas, personalizadas por el usuario. Por ejemplo, se puede configurar una alerta personalizada para que se active si el consumo total promedio supera los 50 kW durante 15 minutos. Se pueden añadir hasta 32 alertas personalizadas a la configuración.
• Entrega de alertas: si se envían correos electrónicos o datos de alerta a través de HTTP POST, el destino y la configuración se pueden configurar aquí.
• Prioridades de alerta del sistema: hay una serie de alertas del sistema integradas que incluyen cambios de configuración del dispositivo o reinicios del dispositivo.

Amplíe las secciones a continuación para obtener más información:

Alertas personalizadas

Las alertas personalizadas permiten a los usuarios configurar alertas flexibles basadas en los datos del registro y otras funciones del firmware del eGauge. Para consultar la lista completa de alertas disponibles, visite /fundoc.html?alert del medidor (p. ej., https://egaugehq.egauge.io/fundoc.html ).

Se pueden agregar nuevas alertas personalizadas haciendo clic en el botón "agregar" (1) en la parte superior, las alertas existentes se pueden eliminar haciendo clic en el botón "eliminar" (2) a la derecha del mensaje, y cualquier alerta existente se puede modificar haciendo clic en cualquier parte de la línea de alerta personalizada.

Crear o modificar alerta

• ¡Asegúrese de guardar las alertas actualizadas o nuevas haciendo clic en "Guardar" en la esquina inferior derecha de la página!

Al editar una alerta existente o crear una nueva, puede configurar información sobre la alerta y las condiciones necesarias para que se active:

Al crear o modificar una alerta, hay 7 campos obligatorios que se deben ingresar:

• Nombre: El nombre único para una alerta
• Prioridad: Nivel de prioridad de la alerta. En el caso de las alertas de correo electrónico SMTP, una vez notificado el destino de la alerta, solo las alertas de mayor prioridad generan una nueva notificación a ese destino hasta que se confirme o elimine la alerta mediante la página de alertas.
• Frecuencia de verificación: Indica la frecuencia con la que se verifica la condición de alerta. Tenga en cuenta que la frecuencia del intervalo comienza al inicio del intervalo. Por ejemplo, la frecuencia horaria se evalúa al inicio de la hora, la diaria a la medianoche, la mensual a la medianoche del primer día del mes, y así sucesivamente.
• Fórmula izquierda: El lado izquierdo de la fórmula de comparación. Puede utilizar valores de registro, números estáticos, funciones de alerta de eGauge o funciones Lua personalizadas.
• Operador: El operador para comparar las fórmulas izquierda y derecha. Puede consistir en:
  • Menor que (<): Si la fórmula de la izquierda es menor que la fórmula de la derecha
  • Menor o igual que (≤): Si la fórmula de la izquierda es menor o igual que la fórmula de la derecha
  • Igual (=): Si la fórmula de la izquierda es igual a la fórmula de la derecha
  • No es igual a (≠): Si la fórmula de la izquierda no es igual a la fórmula de la derecha
  • Mayor que (>): Si la fórmula de la izquierda es mayor que la fórmula de la derecha
  • Mayor o igual que (≥): Si la fórmula de la izquierda es mayor o igual que la fórmula de la derecha
• Fórmula derecha: El lado derecho de la fórmula de comparación. Puede utilizar valores de registro, números estáticos, funciones de alerta de eGauge o funciones Lua personalizadas.
• Mensaje: El mensaje de alerta que se muestra en los detalles del Visor de Alertas y en cualquier mensaje de alerta por correo electrónico. Se pueden usar varias variables especiales en el mensaje:
  • %l: valor evaluado de la fórmula izquierda
  • %L: fórmula de la condición de fórmula izquierda
  • %r: valor evaluado de la fórmula correcta
  • %R: fórmula de la condición de fórmula correcta
  • %o: operador de comparación de fórmula
  • %%: carácter de porcentaje

Entrega de alertas

Además del Visor de Alertas de la Interfaz Moderna, el medidor eGauge puede enviar alertas por correo electrónico SMTP directo, HTTP POST o correo electrónico a través del Servicio de Alertas eGuard. Esto se configura en la sección "Entrega de alertas" de la Configuración de Alertas.

• Informar alertas a un servidor externo: si esta opción está habilitada, cuando se activa una alerta del dispositivo eGauge, el medidor intentará utilizar el destino configurado aquí.
• Informar alertas a...: Seleccione el servicio correspondiente aquí. Consulte la sección a continuación para obtener más información sobre las diferentes opciones.
• Prioridad mínima de alerta para informar: Solo se informarán las alertas con un nivel de prioridad superior al indicado al activarse. Al utilizar una puerta de enlace de correo electrónico SMTP, esta opción se configura por destino de correo electrónico.

Servicio de alerta eGuard

El servicio de alertas eGuard ofrece una alternativa a la configuración del eGauge con credenciales SMTP. Esto es especialmente útil para usuarios individuales que no dispongan de información de inicio de sesión SMTP, así como para usuarios con una gran cantidad de dispositivos. El medidor debe estar en un grupo eGuard controlado por el usuario.
Cuando se activan las alertas, el medidor realiza un POST HTTPS saliente a eGauge.net con la información de la alerta y, a su vez, eGauge.net registra las alertas y envía un correo electrónico al usuario.

La única opción de configuración es la Prioridad mínima de alerta para el informe, que indica la prioridad mínima de alerta para la que este destino debe recibir alertas. Por ejemplo, si todas las alertas tienen prioridad 0, un destino con una prioridad mínima de alerta 1 no recibirá ningún correo electrónico de alerta.

Puede encontrar más información sobre eGuard aquí . Tenga en cuenta también que eGuard cuenta con alertas integradas, que se describen en este artículo .

Puerta de enlace de correo electrónico (SMTP)

• Se requieren credenciales SMTP válidas e información del servidor para el método de correo electrónico directo. La autenticación multifactor u otras aplicaciones de red de alta seguridad pueden impedir el funcionamiento de las alertas de correo electrónico SMTP, por lo que se recomienda el método de correo electrónico del Servicio de Alertas eGuard.

Hay varias opciones para configurar:

• Dirección "De" personalizada: La dirección de remitente desde la que se enviará el correo electrónico. Si se omite, la dirección de remitente predeterminada es la del "Usuario" configurado a continuación. Esto puede ser necesario si el "Usuario" a continuación no es una dirección de correo electrónico completa.
• Host de retransmisión: El servidor SMTP a través del cual se envía el correo electrónico. Si se deja en blanco, eGauge intentará enviar el correo electrónico directamente al dominio de correo electrónico del destinatario de la alerta. Advertencia: La mayoría de los servidores de correo electrónico rechazarán los correos electrónicos enviados directamente sin un host de retransmisión.
• Usuario: Si se especifica un host de retransmisión, este es el nombre de usuario que se debe enviar al retransmisor para la autenticación. Nota: Algunos servidores requieren el formato completo de usuario de correo electrónico@dominio, mientras que otros solo requieren el formato de usuario de correo electrónico.
• Contraseña: si se especifica un usuario de retransmisión, esta es la contraseña que se debe utilizar para autenticarse.

Tras configurar la información del servidor, se deben configurar los destinos de las alertas. Haga clic en un destino existente para editar la información o haga clic en el botón "Agregar" en la esquina superior derecha de la tabla para agregar un nuevo correo electrónico de destino de alerta.

Al configurar un correo electrónico de destino, hay 3 opciones para configurar:

• Dirección de correo electrónico: La dirección a la que se enviará la información de alerta activada. Puede ser la misma que la información del usuario de retransmisión SMTP configurada previamente.
• Prioridad mínima de alerta: La prioridad mínima de alerta que este destino debe recibir. Por ejemplo, si todas las alertas tienen prioridad 0, un destino con una prioridad mínima de alerta 1 no recibirá ningún correo electrónico de alerta.
• Formato de correo electrónico: La longitud del correo electrónico que se enviará al destinatario. El formato "completo" proporciona un correo electrónico de alerta con todos los detalles, mientras que el formato "corto" solo ofrece el límite de máxima prioridad para no exceder los 140 caracteres, como se usa para direcciones de enlace de correo electrónico a SMS.

El botón "Enviar correo electrónico" permite probar un correo electrónico saliente a ese destino en particular. Si la prueba es correcta, el correo electrónico de destino recibirá un correo electrónico de prueba del medidor. Advertencia: Si no se configuran un host de retransmisión ni credenciales, es posible que los correos electrónicos salientes no funcionen siempre, incluso si la prueba inicial de "Enviar correo electrónico" es correcta.

Entrega de SMS mediante SMTP

• Antes de continuar con la configuración de un destino de correo electrónico SMS, se debe configurar un servidor de correo electrónico SMTP válido como se describe en la sección anterior.
• Si no se configuran ningún host de retransmisión ni credenciales, es posible que los correos electrónicos salientes no funcionen todo el tiempo, incluso si una prueba inicial de "Enviar correo electrónico" es exitosa.

La entrega de alertas SMS no existe como una opción independiente y debe configurarse utilizando la opción Puerta de enlace de correo electrónico SMTP y una dirección de entrega de correo electrónico a SMS en el campo de destino de la dirección de correo electrónico.

Las direcciones de puerta de enlace de correo electrónico a SMS suelen tener el siguiente formato:

[email protected]

y debe verificarse con el operador móvil . Al enviar alertas de eGauge a un destinatario SMS, el formato del correo electrónico debe especificarse como corto .

Ejemplo:

costumbre

Los usuarios avanzados pueden utilizar alertas personalizadas para enviar datos con formato JSON como un HTTP POST a una URL proporcionada por el usuario.

Hay varias opciones de configuración disponibles:

• Prioridad mínima de alerta para informar: La prioridad mínima de alerta para la que este destino debe recibir alertas. Por ejemplo, si todas las alertas tienen prioridad 0, un destino con una prioridad mínima de alerta 1 no recibirá ningún correo electrónico de alerta.
• URL personalizada: la URL para PUBLICAR información de alerta cuando se activa.
• Opciones de alerta: Opciones para enviar alertas. Actualmente, las opciones disponibles son:
  • deflate: utilice la compresión de codificación de contenido "deflate" al publicar alertas.
  • gzip: utilice la compresión de codificación de contenido "gzip" al publicar alertas.
  • seguro: para conexiones HTTPS, falla si no se puede verificar el certificado del servidor proveedor de alertas.

Para ver un ejemplo del formato de datos POST de alerta JSON , consulte este artículo

Prioridades de alerta del sistema

Hay una serie de alertas del sistema integradas que incluyen cambios de configuración del dispositivo o reinicios del dispositivo.

En esta sección, se puede configurar el nivel de prioridad de cada alerta del sistema. Por ejemplo, un usuario podría tener una conexión a internet inestable y no querer recibir alertas cuando se pierda o restablezca la conexión proxy, pero sí sobre un fallo en un dispositivo remoto. En este caso, la prioridad de "Fallo de dispositivo remoto" puede ser 1, mientras que la prioridad de "Conexión proxy establecida" y "Conexión proxy perdida" es 0. Si el destino de la alerta se establece con una prioridad mínima de 1, recibirá alertas por el fallo del dispositivo remoto, pero no por los eventos de conexión proxy.

Alertas personalizadas

Sintaxis general

Las fórmulas de alerta personalizadas siguen un formato de expresión lógica.

$"REG NAME" devuelve el valor instantáneo del registro REG NAME , mientras que "REG NAME" apunta una función a un registro específico (pero no devuelve el valor del registro).

Al utilizar funciones como avg() u otras que se indican en la documentación, asegúrese de usar el formato correcto. Por ejemplo, una función que espera una "cadena" esperará un nombre de registro entre comillas (p. ej., "REG NAME" ), mientras que una función que espera un número (valor instantáneo del registro) esperará el valor actual del registro (p. ej., $"REG NAME" , con el prefijo $).

Ejemplos de sintaxis genérica

Como se muestra en esta tabla, se admiten operaciones aritméticas básicas con reglas de precedencia normales: la multiplicación y la división tienen mayor precedencia que la suma y la resta. Se pueden usar paréntesis para anular las reglas de precedencia normales. También se admiten diversas funciones, como sqrt() (raíz cuadrada). Las funciones exactas admitidas dependen del contexto.

Las funciones básicas se admiten en cualquier expresión, mientras que ciertas funciones de alerta solo están disponibles en condiciones de alerta. El valor de un registro se puede obtener encerrando su nombre entre comillas (") y anteponiéndole un signo de dólar ($). Las expresiones condicionales constan de tres partes: la expresión de control antes del signo de interrogación, el valor "si es verdadero" después del signo de interrogación y el valor "si es falso" después de los dos puntos. Si la expresión de control tiene un valor distinto de cero, la expresión condicional se evalúa como el valor "si es verdadero"; de lo contrario, como el valor "si es falso". Todos los valores numéricos se representan como valores de coma flotante IEEE-754 de precisión simple (32 bits). Se admite la recursión limitada, con una profundidad de la pila de evaluación limitada a 128 entradas.

Voltaje L1 alto

El siguiente ejemplo verifica cada segundo si el registro "Voltaje L1" es mayor o igual a 126. Tenga en cuenta que se trata de un cálculo numérico simple sin funciones, por lo que obtenemos el valor instantáneo del registro Voltaje L1 anteponiéndolo con un $ como $"Voltage L1" .

Máximo diario de la cuadrícula

El siguiente ejemplo verifica cada día si el consumo promedio de la red el día anterior (1440 minutos) fue de 50 kW (50 000 vatios) o más. Tenga en cuenta que la función avg() requiere un nombre de registro, por lo que no se antepone un $ al nombre del registro.

Baja producción solar

El siguiente ejemplo verifica, entre las 9:00 y las 19:00, si la producción solar de la hora anterior (60 minutos) fue en promedio de 150 W o menos. Tenga en cuenta que la función avg() requiere un nombre de registro, por lo que no se antepone un $ al nombre del registro.

Este ejemplo también emplea un operador ternario. La sintaxis del operador ternario "?" (también conocido como condicional o prueba condicional) es condición?valor_si_es_verdadero:valor_si_es_falso y puede anidarse. Este es un componente fundamental de muchas alertas, especialmente de las más complejas.

Fórmula izquierda: ((tiempo()>9)*(tiempo()<19))?avg("inv 2", 60):99999