Surveillance

Ce chapitre couvre la section Monitoring de l’interface web : vérification des hôtes et services externes, et lecture des entrées/sorties numériques.

Moniteur réseau

Fonction de cette fonctionnalité

Le Moniteur réseau transforme votre SMSEagle en petite station de surveillance. Il vérifie les serveurs, appareils et services selon un calendrier et envoie un SMS lorsque quelque chose cesse de répondre, revient en ligne ou signale une valeur en dehors de la plage attendue.

Il comporte trois parties :

Page	Fonction
Tâches	Les règles de surveillance : ce qu’il faut vérifier, à quelle fréquence, qui alerter.
Rapports	Un historique des temps d’arrêt, filtré par plage de dates et tâche, exportable en CSV.
Traps SNMP	Les règles qui convertissent les traps SNMP envoyés vers l’appareil en messages SMS.

Cas d’usage typiques : alerter l’ingénieur de garde lorsqu’un serveur de production cesse de répondre aux pings, avertir d’une lecture de température à partir d’un capteur SNMP, ou transférer un trap UPS à un téléphone.

Avant de commencer

L’appareil doit pouvoir atteindre les hôtes que vous souhaitez surveiller. Vérifiez d’abord les paramètres réseau sous Settings > Network.
Les destinataires doivent être marqués comme Public dans le Carnet d’adresses si vous souhaitez alerter un groupe. Sinon, vous pouvez saisir des numéros de téléphone ordinaires dans la tâche.
Pour les vérifications SNMP, vous avez besoin de la chaîne de communauté et de l’identificateur d’objet (OID) que vous souhaitez lire. Pour les vérifications Modbus, vous avez besoin de l’ID d’unité, du registre et du code de fonction.

Partie 1 : Tâches

Étape 1 : Ouvrir la page Tâches

Dans la barre latérale, allez à Monitoring > Network Monitoring > Tasks.

Page des tâches du Moniteur réseau listant trois tâches avec leur hôte, type, calendrier et destinataires, et la boîte Paramètres sur la droite — Tâches du Moniteur réseau

Chaque tâche de la liste affiche son hôte, son calendrier, son type de tâche, ce sur quoi elle alerte, quand il a été dernièrement indisponible et qui elle notifie. Un marqueur vert ou rouge indique si l’hôte répond actuellement.

Étape 2 : Définir la période de surveillance

La boîte Settings à droite de la page Tâches contient un paramètre qui s’applique à toutes les tâches : Monitoring period, en minutes. C’est la fréquence à laquelle l’appareil exécute les vérifications.

Entrez une valeur et cliquez sur Save.

Boîte de paramètres sur la page Tâches avec le champ de période de surveillance en minutes — Période de surveillance

Étape 3 : Créer une tâche

Cliquez sur Créer nouveau dans le coin supérieur droit. Le formulaire de tâche s’ouvre en page entière, divisée en cinq sections.

Définition de la tâche

Champ	Ce qu’il faut entrer
Nom de la tâche	Un nom descriptif, maximum 100 caractères, par exemple `Mail server`.
Hôte - Adresse IP ou nom d’hôte	Ce qu’il faut vérifier, par exemple `192.168.1.10` ou `mail.example.com`.
Lien vers la tâche parente	Cochez cette case pour que la tâche dépende d’une autre.
Nom de la tâche (parent)	Affiché une fois la case cochée : la tâche dont celle-ci dépend.

Une tâche liée s’exécute uniquement si sa tâche parente est opérationnelle. Utilisez-la pour éviter les tempêtes d’alertes : si le routeur devant dix serveurs tombe en panne, seule la tâche du routeur génère une alerte, et les dix tâches de serveur restent silencieuses.

Section de définition de tâche avec le nom de la tâche et l'hôte remplis et Lien vers la tâche parente coché — Définition de la tâche

Méthode de surveillance

Choisissez le Type de test, puis remplissez les paramètres qui s’affichent pour celui-ci :

Type de test	Paramètres
ICMP (ping)	Nombre de requêtes - combien de pings envoyer par vérification.
port TCP	Port - le port TCP qui doit accepter une connexion.
port UDP	Port - le port UDP à vérifier.
SNMP	Version du protocole (1 ou 2), Object ID, Community, Type de valeur de retour (Nombre ou Chaîne).
Modbus TCP	Port, Unit ID, Register, Code de fonction (Lire les bobines, Lire les entrées discrètes, Lire les registres de maintien, Lire les registres d’entrée).

Délai de connexion - secondes s’applique à chaque type de test. Augmentez-le pour les serveurs occupés qui répondent lentement ; la valeur par défaut est 30 secondes.

Cliquez sur Test connection pour essayer la vérification immédiatement. Le résultat apparaît à côté du bouton, vous pouvez donc confirmer que l’hôte répond avant d’enregistrer la tâche.

Section Méthode de surveillance avec SNMP sélectionné, affichant la version du protocole, l'identifiant d'objet, la communauté, le type de valeur de retour et le bouton Test connection — Méthode de surveillance

Calendrier

Choisissez Always on si la tâche doit s’exécuter en continu, ou Disable between specified hours et définissez From et To pour créer une fenêtre de silence, par exemple pendant une sauvegarde nocturne qui met toujours le service hors ligne.

Déclencheurs d’alerte

Choisissez d’abord qui reçoit l’alerte :

Option	Ce qu’il faut entrer
Phonebook groups	Sélectionnez les groupes publics. Seuls les groupes publics sont acceptés.
Phone numbers	Tapez les numéros directement, séparés par des virgules. Maximum 100 caractères au total.

Ensuite, cochez au moins une condition Send SMS when. Sans cela, la tâche ne peut pas être enregistrée :

Host / Service goes down
Host / Service goes up after failure
If SNMP return value is - uniquement pour les tâches SNMP. Choisissez un Operator (Equal to, Not equal to, Greater than, Less than, Contains, Does not contain) et une Value.
If Modbus return value is - uniquement pour les tâches Modbus, avec les mêmes champs d’opérateur et de valeur.

Deux autres paramètres ferment la section :

Call after sending SMS - placez également un appel vocal. Les options sont No, Ring only, Yes - text to speech et Yes - text to speech (advanced), selon votre modèle d’appareil. Avec l’option avancée, vous choisissez également un Voice model.
Repeat every - renvoyez l’alerte toutes les X minutes pendant que le problème persiste. 0 signifie l’envoyer une fois et rester silencieux.

Section Déclencheurs d'alerte avec un groupe de carnet d'adresses sélectionné et les deux cases goes down et goes up cochées — Déclencheurs d’alerte

Modèles de message

Écrivez le texte pour chaque alerte que vous avez activée. Chaque message peut comporter jusqu’à 1300 caractères et peut utiliser des espaces réservés :

Message	Espaces réservés disponibles
Service is down	`{TASKNAME}`, `{HOST}`, `{RESPONSE}`, `{TIMESTAMP}`
Service is up after failure	`{TASKNAME}`, `{HOST}`, `{TIMESTAMP}`
Texte SMS (SNMP)	`{TASKNAME}`, `{VALUE}`, `{TIMESTAMP}`
Texte SMS (Modbus)	`{TASKNAME}`, `{VALUE}`, `{TIMESTAMP}`

Par exemple, DOWN: {TASKNAME} ({HOST}) at {TIMESTAMP} produit un message indiquant ce qui a échoué, où et quand.

Section des modèles de message avec les messages de panne et de rétablissement et les espaces réservés disponibles listés en dessous — Modèles de message

Cliquez sur Create task. La tâche commence à être vérifiée à la prochaine exécution de surveillance.

Partie 2 : Rapports

Allez à Monitoring > Network Monitoring > Reports.

Générer un rapport

Dans la boîte Report config choisissez :

Champ	Fonction
Data for	Une plage de dates prédéfinie. En en choisissant une, les dates ci-dessous sont remplies.
Date from / Date to	La plage exacte. La modification de ces champs bascule Data for à une plage personnalisée.
Task	Une seule tâche, ou All tasks.

Cliquez sur Generate report. Les résultats apparaissent ci-dessous, listant le temps d’arrêt, le nom de la tâche et l’erreur enregistrée pour chaque incident.

Cliquez sur Export to CSV au-dessus des résultats pour les télécharger.

Page des rapports avec une plage de dates et une tâche sélectionnées et un tableau de temps d'arrêt généré ci-dessous — Rapport généré

Rétention des rapports

La boîte sur la droite contient une option, Automatically delete reports older than 3 months. Activez-la pour empêcher l’historique des rapports de croître indéfiniment, puis cliquez sur Save.

Boîte de paramètres de rapports avec l'option de suppression automatique des rapports de plus de trois mois — Rétention des rapports

Partie 3 : Interruptions SNMP

Les tâches sortent et vérifient les choses. Les règles de trappe SNMP fonctionnent dans l’autre sens : un autre appareil envoie une trappe à SMSEagle, et la règle la transforme en SMS.

Étape 1 : Ouvrir la page des interruptions SNMP

Allez à Monitoring > Network Monitoring > SNMP Traps.

Page des règles de trappe SNMP avec un exemple de règle — Règles de trappe SNMP

Étape 2 : Créer une règle

Cliquez sur Create new dans le coin supérieur droit. Un panneau latéral s’ouvre.

Nommer la règle

Dans Rule name, tapez quelque chose de descriptif, par exemple UPS battery trap. Maximum 100 caractères.

Décider quels pièges gérer

Choisissez Send message :

Option	Ce que cela signifie
Always send	Chaque piège reçu par l’appareil déclenche cette règle.
For specified IP / when trap contains	Seuls les pièges correspondant aux conditions ci-dessous la déclenchent.

Si vous avez choisi la deuxième option, deux conditions deviennent disponibles. Vous pouvez en utiliser une ou les deux, et un piège doit satisfaire à chaque condition que vous activez.

When incoming trap comes from IP Cochez cette case et tapez l’adresse IP de l’appareil qui envoie.

When incoming trap contains Object ID Cochez cette case et tapez l’OID qui doit être présent dans le piège.

Règle SNMP trap avec For specified IP / when trap contains sélectionné et les deux conditions d'adresse IP source et d'ID objet remplies — Une règle SNMP trap avec conditions

Choisir les destinataires et rédiger le message

Send SMS to - sélectionnez les contacts ou les groupes. Seuls les contacts et groupes public sont acceptés.

Message content - le texte à envoyer, maximum 1300 caractères. Vous pouvez utiliser ces placeholders :

Placeholder	Remplacé par
`{TASKNAME}`	Le nom de la règle
`{IP}`	L’adresse IP d’où provient le piège
`{TRAP}`	Le contenu du piège

Paramètres optionnels

Modem (appareils multi-modem uniquement) - envoyer via une carte SIM spécifique au lieu de la carte par défaut.
Call after sending SMS - placer également un appel vocal, avec les mêmes options que dans les tâches.

Cliquez sur Save. La règle s’applique aux trappes reçues à partir de maintenant.

Comportement du Network Monitor

Les tâches sont vérifiées sur la Monitoring period partagée, de sorte qu’une tâche ne peut pas alerter plus rapidement que cet intervalle ne le permet.
Une alerte « down » est envoyée une fois lorsque l’état change, puis répétée uniquement si vous définissez Repeat every.
Une tâche liée à un parent est entièrement ignorée pendant que le parent est down, donc ses propres alertes restent silencieuses jusqu’à ce que le parent se rétablisse.
Si plusieurs règles de trap SNMP correspondent au même trap, chacune d’entre elles envoie son propre SMS.

Entrée/Sortie numérique

Page Digital I/O Rules, onglet Inputs, état vide, avec le panneau d'explication de fonctionnalité — Aperçu des Entrées/Sorties numériques

Fonction de cette fonctionnalité

Les entrées et sorties numériques sont le connecteur physique sur l’appareil qui permet à SMSEagle de communiquer avec le monde extérieur au réseau :

Direction	Fonction
Input	Un changement de tension sur un port d’entrée (fermeture d’un contact de porte, déclenchement d’un relais d’alarme, signalement d’une défaillance par un UPS) fait envoyer un SMS par l’appareil.
Output	Un SMS entrant fait basculer un port de sortie on ou off par l’appareil, de sorte qu’il peut démarrer une sirène, ouvrir un portail ou réinitialiser une machine.

Vous configurez cela avec des règles. Une règle Input dit « quand le port 2 passe à high, envoyer un texte à l’équipe de maintenance ». Une règle Output dit « quand un SMS contenant OPEN arrive, mettre le port 1 à high pendant 5 secondes ».

À côté des règles, il y a deux pages qui affichent les ports eux-mêmes : Internal pins (les ports intégrés à l’appareil) et External pins (ports supplémentaires ajoutés via un module io-bridge).

Avant de commencer

Vérifiez le nombre de ports d’entrée et de sortie que votre modèle d’appareil possède, et branchez votre équipement sur ces ports. Les listes de ports dans les formulaires de règles sont construites à partir de votre modèle d’appareil, de sorte qu’elles ne proposent que les ports qui existent physiquement.
L’appareil doit être capable d’envoyer des SMS. Vérifiez qu’au moins un modem est connecté et enregistré sur le réseau.
Les destinataires des règles Input doivent être marqués comme Public dans le Phonebook.

Où le trouver

Dans la barre latérale, allez à Monitoring > Digital input / output. Elle comporte trois pages :

Page	À quoi ça sert
Rules	Créez les règles Input et Output. C’est ici que vous passez la plupart de votre temps.
Internal pins	Consultez l’état en direct des ports intégrés et activez ou désactivez le service.
External pins	Définissez et contrôlez les ports supplémentaires fournis par un module io-bridge.

Barre latérale Monitoring avec Digital input / output développée, montrant Rules, Internal pins et External pins — Où trouver les pages Entrée/Sortie numérique

Partie 1 : Règles d’entrée (signal d’entrée vers SMS)

Étape 1 : Ouvrir la page des règles

Allez à Monitoring > Digital input / output > Rules et assurez-vous que l’onglet Inputs est sélectionné.

Page Digital I/O Rules sur l'onglet Inputs avec deux règles listées, chacune affichant son signal, port, message et destinataires — Règles d’entrée numérique

Étape 2 : Créer une règle d’entrée

Cliquez sur Create new dans le coin supérieur droit. Un panneau latéral s’ouvre.

Le panneau latéral Add Digital Input rule tel qu'il s'ouvre, avec des champs vides — Une nouvelle règle d’entrée numérique

Nommer la règle

Dans Rule name, tapez quelque chose de descriptif, par exemple Server room door opened. Maximum 100 caractères.

Choisir le port et le signal

Champ	Ce qu’il faut entrer
Port number	Le port d’entrée auquel l’équipement est câblé. Les ports externes (io-bridge) apparaissent dans la liste marqués `(Ext)`.
When input signal	`0 (Low)` ou `1 (High)`. C’est l’état qui déclenche la règle.

Choisissez la valeur qui représente la condition d’alarme sur votre équipement. Un contact normalement fermé qui s’ouvre en cas d’alarme nécessite généralement 1 (High) ; un contact normalement ouvert nécessite généralement 0 (Low).

Choisir les destinataires

Dans Send to, sélectionnez les contacts ou groupes qui doivent recevoir le SMS. Seuls les contacts et groupes publics peuvent être sélectionnés ici. Ce champ est obligatoire.

Écrire le texte du SMS

SMS Message est le texte envoyé quand la règle se déclenche. Maximum 1000 caractères. Le même texte va à tous les destinataires, donc indiquez l’emplacement ou la machine, par exemple ALARM: server room door opened.

Panneau de règle d'entrée numérique avec le port, le signal d'entrée, les destinataires et le message SMS remplis — Une règle d’entrée complétée

Options avancées

Cliquez sur Advanced options pour développer cette section. Vous n’en avez pas besoin pour une configuration basique.

Call after sending SMS - placer également un appel vocal aux mêmes destinataires. Les options sont No, Ring, Text-to-speech (TTS) et Text-to-speech (advanced), selon ce que votre modèle d’appareil supporte. Avec l’option avancée, vous choisissez également un Voice model.
Alert timeout - le nombre de minutes qui doivent s’écouler avant que la même règle puisse alerter à nouveau. 0 signifie pas de limite, donc chaque changement de signal envoie un SMS.

Options avancées de règle d'entrée développées, affichant l'option d'appel après SMS et le champ de délai d'alerte — Options avancées de règle d’entrée

Définissez un délai d’alerte pour les entrées bruyantes. Un contact qui papillote, ou un équipement qui se déclenche de manière répétée, peut produire une rafale de messages. Un délai de quelques minutes garde un événement réel à un SMS.

Cliquez sur Save. La règle commence à fonctionner sur les changements de signal à partir de maintenant.

Partie 2 : Règles de sortie (SMS en signal de sortie)

Étape 1 : Ouvrir la page des règles

Allez à Monitoring > Digital input / output > Rules et choisissez l’onglet Outputs.

Page Digital I/O Rules sur l'onglet Outputs avec une règle listée — Règles de sortie numérique

Étape 2 : Créer une règle de sortie

Cliquez sur Create new dans le coin supérieur droit. Un panneau latéral s’ouvre.

Nommez la règle et choisissez le port

Dans Rule name, saisissez une description, par exemple Open gate on SMS. Maximum 100 caractères. Dans Port number, choisissez le port de sortie auquel votre équipement est câblé. Les ports externes (io-bridge) apparaissent marqués (Ext).

Décidez quels messages SMS déclenchent la règle

Choisissez Set for :

Option	Ce que cela signifie
All incoming messages	Chaque SMS entrant commute la sortie.
Specified sender / message	Seuls les messages correspondant aux conditions que vous définissez ci-dessous la commutent.

Si vous avez choisi Specified sender / message, deux conditions deviennent disponibles. Vous pouvez en utiliser une ou les deux. Lorsque vous utilisez les deux, un message doit satisfaire aux deux.

When incoming SMS comes from Cochez cette case et sélectionnez les contacts ou groupes d’expéditeurs.

When incoming SMS text contains Cochez cette case et saisissez la phrase dans Text, par exemple OPEN. Cochez Case sensitive si open et OPEN doivent être traités comme différents.

Règle de sortie numérique avec Specified sender / message sélectionné et les deux conditions d'expéditeur et de texte remplies — Conditions de règle de sortie

Restreindre les règles de sortie par expéditeur. Une règle de sortie commute l’équipement physique. Sans condition d’expéditeur, n’importe qui connaissant votre numéro peut l’actionner.

Décidez ce que la sortie fait

Champ	Ce que cela signifie
Set signal to	`Low \| 0` ou `High \| 1`. L’état dans lequel le port est commuté.
Signal time	Le nombre de secondes pendant lesquelles le port reste dans cet état avant de revenir. `0` signifie qu’il y reste indéfiniment.
Signal delay	Le nombre de secondes à attendre après l’arrivée du SMS avant de commuter le port.

Options avancées

Cliquez sur Advanced options pour développer cette section.

Send confirmation Cochez cette case pour envoyer un SMS en retour à l’expéditeur après que la sortie ait été commutée. Le champ Message format apparaît, maximum 1300 caractères. Vous pouvez construire le texte à partir des espaces réservés :

Placeholder	Remplacé par
`{RULENAME}`	Le nom de la règle qui s’est déclenchée
`{PORT}`	Le numéro du port de sortie
`{SIGTYPE}`	Le signal auquel le port a été défini
`{SIGTIME}`	Le temps du signal en secondes
`{SIGDELAY}`	Le délai du signal en secondes

Par exemple, {RULENAME}: port {PORT} set to {SIGTYPE} for {SIGTIME}s produit un accusé de réception clair pour la personne qui a envoyé la commande.

Appel après envoi de SMS Placez également un appel vocal, exactement comme décrit pour les règles d’entrée ci-dessus.

Options avancées de la règle de sortie développées, affichant le message de confirmation et les espaces réservés qui peuvent y être insérés — Message de confirmation de la règle de sortie

Cliquez sur Save. La règle commence à fonctionner sur les messages reçus à partir de maintenant.

Partie 3 : Broches internes

Allez à Monitoring > Digital input / output > Internal pins.

La page affiche deux tableaux, Inputs et Outputs, répertoriant tous les ports intégrés avec leur état actuel (0 Bas ou 1 Haut). C’est une lecture en direct du matériel, utile pour vérifier votre câblage avant d’écrire une règle.

En haut de la page se trouve un commutateur Service enabled. Il démarre et arrête le service qui lit et contrôle les ports intégrés. Tant qu’il est éteint, les règles d’entrée et de sortie sur les ports internes ne fonctionnent pas.

Page des broches internes avec le service activé et chaque entrée et sortie affichant 0 Bas — Broches internes avec le service en cours d’exécution. Chaque port ici affiche `0` Bas car rien n’y est câblé

Partie 4 : Broches externes

Les broches externes sont des ports supplémentaires fournis par un module io-bridge connecté à l’appareil.

Allez à Monitoring > Digital input / output > External pins. La page dispose d’un onglet Inputs et d’un onglet Outputs, ainsi qu’un commutateur Service enabled qui démarre et arrête le service io-bridge.

Ajouter une broche externe

Cliquez sur Create new. Un panneau latéral s’ouvre.

Champ	Ce qu’il faut entrer
Pin number	Le numéro du port sur le module io-bridge, par exemple `1`. Chaque numéro ne peut être configuré qu’une seule fois.
Pin description	Un nom court, maximum 64 caractères. Seules les lettres, les chiffres et les espaces sont autorisés.
Direction	In pour un port que vous lisez, Out pour un port que vous contrôlez.
État	Affiché uniquement pour les broches Out : l’état initial du port, `1 \| High` ou `0 \| Low`.

Cliquez sur Save.

Le panneau latéral Add external pin avec le numéro de broche, la description, la direction et l'état remplis — Ajout d’une broche externe

Utiliser les broches

Dans l’onglet Outputs, vous pouvez basculer directement l’état d’une broche à partir de la liste.
Dans l’onglet Inputs, l’état est en lecture seule, car la valeur est déterminée par ce qui est connecté à la broche.
Une fois définies, les broches externes apparaissent également dans les listes Port number des règles Input et Output, marquées (Ext), afin que les règles puissent les utiliser exactement comme les ports intégrés.

Comportement des règles Digital I/O

Les règles n’agissent que sur les événements qui se produisent après la création et l’activation de la règle. Utilisez l’interrupteur à côté d’une règle pour la suspendre sans la supprimer.
Si plusieurs règles correspondent au même événement, chacune d’elles s’exécute, ainsi un signal d’entrée peut envoyer plusieurs messages et un SMS peut basculer plusieurs ports.
La condition de texte sur les règles Output est une correspondance contains, pas une correspondance exacte.
Les règles qui utilisent des ports internes nécessitent que le service Internal pins soit activé ; les règles qui utilisent les ports (Ext) nécessitent que le service External pins soit activé.