Alertes du dispositif eGauge

Les alertes de l'appareil eGauge permettent au compteur d'enregistrer et d'envoyer des alertes qui peuvent être déclenchées par diverses conditions, telles que la modification de la configuration du compteur, un défaut de l'appareil SunSpec distant ou des alertes personnalisées avancées telles qu'une tension hors de la plage attendue.

Les alertes sont affichées dans l'interface moderne à l'aide du visualiseur d'alertes et peuvent être configurées pour être envoyées par e-mail ou par requête HTTP POST avec des données au format JSON.

Accès à la configuration des alertes

Pour accéder à la page de configuration des alertes, depuis le menu principal, accédez à Configuration → Alertes :

Sections de configuration

Il y a 3 sections principales à configurer pour les alertes :

• Alertes personnalisées : il s’agit d’alertes personnalisées, définies par l’utilisateur. Par exemple, une alerte personnalisée peut être configurée pour se déclencher si la consommation totale moyenne dépasse 50 kW pendant 15 minutes. Jusqu’à 32 alertes personnalisées peuvent être ajoutées à la configuration.
• Diffusion des alertes : si vous envoyez des données d’alerte par e-mail ou via HTTP POST, la destination et la configuration peuvent être définies ici.
• Priorités des alertes système : Il existe un certain nombre d’alertes système intégrées, notamment les modifications de configuration de l’appareil ou les redémarrages de l’appareil.

Développez les sections ci-dessous pour en savoir plus :

Alertes personnalisées

La fonction d'alertes personnalisées permet aux utilisateurs de configurer des alertes flexibles basées sur les données d'enregistrement et d'autres fonctions fournies par le micrologiciel eGauge. Pour obtenir la liste complète des fonctions d'alerte disponibles, consultez la page /fundoc.html?alert du compteur concerné (par exemple : https://egaugehq-test.egauge.io/fundoc.html ).

De nouvelles alertes personnalisées peuvent être ajoutées en cliquant sur le bouton « ajouter » (1) en haut, les alertes existantes peuvent être supprimées en cliquant sur le bouton « supprimer » (2) à droite du message, et toutes les alertes existantes peuvent être modifiées en cliquant n'importe où sur la ligne d'alerte personnalisée.

Créer ou modifier une alerte

• N'oubliez pas d'enregistrer les alertes mises à jour ou nouvelles en cliquant sur « Enregistrer » dans le coin inférieur droit de la page !

Lors de la modification d'une alerte existante ou de la création d'une nouvelle alerte, vous pouvez définir des informations concernant l'alerte et les conditions nécessaires à son déclenchement :

Lors de la création ou de la modification d'une alerte, 7 champs obligatoires doivent être renseignés :

• Nom : Le nom unique d’une alerte
• Priorité : Niveau de priorité de l’alerte. Pour les alertes par e-mail SMTP, une fois qu’un destinataire a été notifié, seules les alertes de priorité supérieure entraînent une nouvelle notification à ce destinataire jusqu’à ce que l’alerte ait été acquittée ou supprimée via la page des alertes.
• Fréquence de vérification : à quelle fréquence vérifier l’état d’alerte ? Notez que la fréquence de vérification commence au début de l’intervalle. Par exemple, une vérification horaire est effectuée à l’heure pile, une vérification quotidienne à minuit, une vérification mensuelle à minuit le premier jour du mois, etc.
• Formule de gauche : La partie gauche de la formule de comparaison. Elle peut utiliser des valeurs de registre, des nombres statiques, des fonctions d’alerte eGauge ou des fonctions Lua personnalisées.
• Opérateur : L’opérateur permettant de comparer les formules de gauche et de droite. Il peut s’agir de :
  • Inférieur à (<) : Si la formule de gauche est inférieure à la formule de droite
  • Inférieur ou égal à (≤) : Si la formule de gauche est inférieure ou égale à la formule de droite
  • Égal (=) : Si la formule de gauche est égale à la formule de droite
  • Différent de (≠) : Si la formule de gauche n’est pas égale à la formule de droite
  • Supérieur à (>) : Si la formule de gauche est supérieure à la formule de droite
  • Supérieur ou égal à (≥) : Si la formule de gauche est supérieure ou égale à la formule de droite
• Formule de droite : La partie droite de la formule de comparaison. Elle peut utiliser des valeurs de registre, des nombres statiques, des fonctions d’alerte eGauge ou des fonctions Lua personnalisées.
• Message : Message d’alerte affiché dans les détails de l’Observateur d’alertes et dans les messages d’alerte par courriel. Plusieurs variables spéciales peuvent être utilisées dans le message :
  • %l : valeur évaluée de la formule de gauche
  • %L : formule de la condition de formule gauche
  • %r : valeur évaluée de la formule de droite
  • %R : formule de la bonne condition de formule
  • %o : opérateur de comparaison de formule
  • %% : caractère de pourcentage

Livraison d'alertes

Outre le visualiseur d'alertes de l'interface moderne, le compteur eGauge peut envoyer des alertes par e-mail (SMTP), par requête HTTP POST ou par le service d'alerte eGuard. Cette configuration s'effectue dans la section « Distribution des alertes » des paramètres d'alerte.

• Envoyer les alertes à un serveur externe : si cette option est activée, lorsqu’une alerte est déclenchée par un appareil eGauge, le compteur tentera d’utiliser la destination configurée ici.
• Signaler les alertes à… : Sélectionnez le service approprié ici. Consultez la section ci-dessous pour plus de détails sur les différentes options.
• Niveau de priorité minimal des alertes : seules les alertes de priorité supérieure à ce niveau seront signalées. Lors de l’utilisation d’une passerelle de messagerie SMTP, cette option est définie pour chaque destination de messagerie.

Service d'alerte eGuard

Le service d'alerte eGuard offre une alternative à la configuration de l'eGauge par identifiants SMTP. Cette solution est particulièrement utile pour les utilisateurs individuels ne disposant pas de leurs informations de connexion SMTP, ainsi que pour ceux possédant un grand nombre d'appareils. Le compteur doit appartenir à un groupe eGuard géré par l'utilisateur.
Lorsqu'une alerte est déclenchée, le compteur envoie une requête HTTPS POST sortante à eGauge.net avec les informations d'alerte, et eGauge.net enregistre à son tour les alertes et envoie un courriel à l'utilisateur.

La seule option de configuration est la priorité minimale des alertes à signaler, qui correspond au niveau de priorité minimal pour lequel cette destination doit recevoir des alertes. Par exemple, si toutes les alertes sont définies sur la priorité 0, une destination d'alerte dont la priorité minimale est de 1 ne recevra aucun e-mail d'alerte.

Vous trouverez plus d'informations sur eGuard ici . Notez également qu'eGuard intègre des alertes, décrites dans cet article .

Passerelle de messagerie (SMTP)

• Pour l'envoi direct par e-mail, des identifiants SMTP et des informations de serveur valides sont requis. L'authentification multifacteurs ou d'autres applications réseau à haute sécurité peuvent empêcher le bon fonctionnement des alertes par e-mail SMTP ; par conséquent, l'envoi par e-mail via le service d'alerte eGuard est recommandé.

Plusieurs options de configuration sont disponibles :

• Adresse d'envoi personnalisée : l'adresse à partir de laquelle l'e-mail sera envoyé. Si cette adresse est omise, l'adresse d'envoi sera par défaut celle de l'utilisateur configuré ci-dessous. Cela peut être nécessaire si l'utilisateur indiqué ci-dessous ne possède pas une adresse e-mail complète.
• Serveur relais : serveur SMTP utilisé pour l’envoi du courriel. Si ce champ est laissé vide, l’eGauge tentera d’envoyer directement le courriel au domaine de messagerie du destinataire de l’alerte. Attention : la plupart des serveurs de messagerie rejettent les courriels envoyés directement sans serveur relais.
• Utilisateur : Si un serveur relais est spécifié, il s’agit du nom d’utilisateur à envoyer au relais pour authentification. Remarque : certains serveurs exigent le format complet email@domaine, tandis que d’autres n’exigent que le format email.
• Mot de passe : si un utilisateur relais est spécifié, il s’agit du mot de passe qui doit être utilisé pour l’authentification.

Après avoir configuré les informations du serveur, vous devez configurer les destinations des alertes. Cliquez sur une destination existante pour modifier ses informations, ou cliquez sur le bouton « Ajouter » en haut à droite du tableau pour ajouter une nouvelle adresse e-mail de destination d'alerte.

Lors de la configuration d'un e-mail de destination, trois options sont disponibles :

• Adresse électronique : Adresse électronique à laquelle envoyer les informations d’alerte déclenchées. Cette adresse peut être identique ou différente de celle configurée précédemment pour le relais SMTP.
• Priorité minimale d'alerte : niveau de priorité minimal pour lequel cette destination doit recevoir des alertes. Par exemple, si toutes les alertes sont définies sur la priorité 0, une destination d'alerte dont la priorité minimale est de 1 ne recevra aucun courriel d'alerte.
• Format de l'e-mail : longueur de l'e-mail à envoyer au destinataire. Le format « complet » permet d'envoyer une alerte détaillée, tandis que le format « court » limite les informations prioritaires à 140 caractères maximum, par exemple pour les passerelles e-mail vers SMS.

Le bouton « Envoyer un e-mail » permet de tester l'envoi d'un e-mail vers la destination spécifiée. En cas de succès, le destinataire recevra un e-mail de test. Attention : si aucun serveur relais ni identifiants ne sont configurés, l'envoi d'e-mails peut ne pas fonctionner correctement, même si le test initial est concluant.

Livraison de SMS via SMTP

• Avant de procéder à la configuration d'une destination de messagerie SMS, un serveur de messagerie SMTP valide doit être configuré comme indiqué dans la section précédente.
• Si aucun serveur relais ni identifiants ne sont configurés, l'envoi de courriels sortants peut ne pas fonctionner correctement, même si un test initial d'envoi de courriel est concluant.

La réception d'alertes SMS n'existe pas en tant qu'option autonome et doit être configurée à l'aide de l'option Passerelle de messagerie SMTP et d'une adresse de livraison e-mail vers SMS dans le champ de destination de l'adresse e-mail.

Les adresses des passerelles de messagerie électronique vers SMS se présentent généralement sous la forme suivante :

[email protected]

et doit être vérifié auprès de l'opérateur mobile . Lors de l'envoi d'alertes eGauge par SMS, le format de l'e-mail doit être spécifié comme court .

Exemple:

coutume

Les alertes personnalisées peuvent être utilisées par les utilisateurs avancés pour envoyer des données au format JSON via une requête HTTP POST à une URL fournie par l'utilisateur.

Plusieurs options de configuration sont disponibles :

• Niveau de priorité minimal des alertes : niveau de priorité minimal pour lequel cette destination doit recevoir des alertes. Par exemple, si toutes les alertes sont définies sur la priorité 0, une destination d’alerte dont le niveau de priorité minimal est de 1 ne recevra aucun courriel d’alerte.
• URL personnalisée : URL à laquelle envoyer les informations d’alerte lorsqu’elle est déclenchée.
• Options d'alerte : toutes les options à utiliser lors de l'envoi d'alertes. Les options disponibles sont actuellement :
  • deflate : Utilisez la compression de contenu « deflate » lors de la publication d’alertes.
  • gzip : Utilisez la compression de contenu « gzip » lors de la publication d’alertes.
  • sécurisé : pour les connexions HTTPS, échouer si le certificat du serveur fournisseur d'alertes ne peut pas être vérifié.

Pour un exemple de format de données POST d'alerte JSON, veuillez consulter cet article.

Priorités des alertes système

Le système comporte plusieurs alertes intégrées, notamment en cas de modification de la configuration de l'appareil ou de redémarrage de celui-ci.

Dans cette section, vous pouvez configurer le niveau de priorité de chaque alerte système. Par exemple, un utilisateur disposant d'une connexion Internet instable peut ne pas souhaiter être alerté en cas de perte ou de rétablissement de la connexion proxy, mais souhaiter être averti en cas de panne d'un périphérique distant. Dans ce cas, l'alerte « Panne du périphérique distant » peut être définie sur la priorité 1, tandis que les alertes « Connexion proxy établie » et « Perte de connexion proxy » sont définies sur la priorité 0. Si la priorité minimale de l'alerte est définie sur 1, la destination de l'alerte recevra les alertes relatives aux pannes de périphériques distants, mais pas celles concernant les événements de connexion proxy.

Alertes personnalisées

Syntaxe générale

Les formules d'alerte personnalisées suivent un format d'expression logique.

$"REG NAME" renvoie la valeur instantanée du registre REG NAME , tandis que "REG NAME" pointe une fonction vers un registre spécifique (mais ne renvoie pas la valeur du registre).

Lorsque vous utilisez des fonctions telles que avg() ou d'autres fonctions mentionnées dans la documentation, veillez à respecter le format correct. Par exemple, une fonction qui attend une chaîne de caractères attendra le nom du registre entre guillemets (par exemple, "REG NAME" ), tandis qu'une fonction qui attend un nombre (valeur instantanée du registre) attendra la valeur actuelle du registre (par exemple, $"REG NAME" , avec le symbole $ en préfixe).

Exemples de syntaxe générique

Comme le montre ce tableau, les opérations arithmétiques de base, avec leurs règles de priorité habituelles, sont prises en charge : la multiplication et la division sont prioritaires sur l’addition et la soustraction. L’utilisation de parenthèses permet de modifier ces règles. Diverses fonctions, telles que la racine carrée (sqrt()), sont également prises en charge. Les fonctions exactes prises en charge dépendent du contexte.

Les fonctions de base sont prises en charge dans toute expression, tandis que certaines fonctions d'alerte ne sont disponibles que dans les conditions d'alerte. La valeur d'un registre s'obtient en plaçant son nom entre guillemets (") et en le faisant précéder du signe dollar ($). Les expressions conditionnelles se composent de trois parties : l'expression de contrôle avant le point d'interrogation, la valeur de retour (si vrai) après le point d'interrogation et la valeur de retour (si faux) après les deux-points. Si l'expression de contrôle a une valeur différente de zéro, l'expression conditionnelle est évaluée à la valeur de retour (si vrai), sinon à la valeur de retour (si faux). Toutes les valeurs numériques sont représentées en tant que nombres à virgule flottante simple précision (32 bits) conformes à la norme IEEE-754. La récursivité est limitée, la profondeur de la pile d'évaluation étant limitée à 128 entrées.

L1 Tension élevée

L'exemple suivant vérifie toutes les secondes si le registre « Voltage L1 » est supérieur ou égal à 126. Notez qu'il s'agit d'un simple calcul numérique sans aucune fonction, nous obtenons donc la valeur instantanée du registre Voltage L1 en la faisant précéder d'un $ comme $"Voltage L1" .

Daily Grid High

L'exemple suivant vérifie quotidiennement si la consommation moyenne du réseau la veille (1440 minutes) était supérieure ou égale à 50 kW (50 000 watts). Notez que la fonction avg() requiert un nom de registre ; nous n'utilisons donc pas le symbole $ pour le faire précéder.

Faible production solaire

L'exemple suivant vérifie, entre 9 h et 19 h, si la production solaire de l'heure précédente (60 minutes) a été en moyenne inférieure ou égale à 150 W. Notez que la fonction avg() requiert un nom de registre ; nous n'utilisons donc pas le symbole $ pour le faire précéder.

Cet exemple utilise également un opérateur ternaire. La syntaxe de l'opérateur ternaire « ? » (aussi appelé condition ou test conditionnel) est : condition?valeur_si_vrai:valeur_si_faux et il peut être imbriqué. Il s'agit d'un élément fondamental de nombreuses alertes, notamment les plus complexes.

Formule de gauche : ((time()>9)*(time()<19))?avg("inv 2", 60):99999