===== Gestion des alarmes =====

Les alarmes permettent de surveiller l’état des équipements à partir des métriques remontées par les drivers.

Une alarme compare les valeurs reçues avec des conditions définies par l’utilisateur.

Lorsque la condition configurée est atteinte, Zebrix Control :

  * Déclenche une alarme
  * Modifie le statut de l’équipement
  * Affiche l’alarme dans l’interface

{{ .:pasted:20250814-110842.png?600 }}

==== Principe de fonctionnement ====

Le fonctionnement des alarmes repose sur trois éléments :

  * Un **driver**
  * Une ou plusieurs **métriques**
  * Une ou plusieurs **conditions d’alarme**

Le driver collecte des informations depuis l’équipement et transmet des métriques à Zebrix Control.

Ces métriques sont ensuite analysées afin de déterminer si une anomalie doit être déclenchée.

 Exemple :

  * Le driver Ping remonte la métrique "alive"
  * La valeur reçue est "false"
  * Une règle d’alarme indique que "alive = false"
  * Le terminal passe alors en statut **Critique** ou **Injoignable**

Pour créer une alarme :

  - Ouvrez la configuration de l’équipement
  - Accédez à l’onglet **Alarmes**
  - Cliquez sur **Configuration**
  - Cliquez sur le bouton **➕ Ajouter**

{{ .:pasted:20250814-111510.png?500 }}

Deux types d’alarmes sont disponibles :

  * **Alarme sur mesures** – Basée sur les valeurs remontées par une métrique
  * **Alarme d’absence de données (NoData)** – Déclenchée lorsque Zebrix Control ne reçoit plus aucune donnée d’un driver sélectionné

==== 🚫 Alarmes d’absence de données (NoData) ====

Ce type d’alarme permet de détecter qu’un driver ne remonte plus aucune donnée.

{{ .:pasted:20260515-102645.png?600 }}

Cela signifie généralement :

  * Que l’équipement est injoignable
  * Que le réseau est indisponible
  * Ou que la sonde n’est plus capable de communiquer avec l’équipement

 Exemple :

  * Un écran Samsung utilise un driver MDC
  * Le driver ne remonte plus aucune information
  * Zebrix Control déclenche alors une alarme

=== ⚠️ Recommandation importante ===

Il est déconseillé d’utiliser ce type d’alarme avec le driver Ping.

En effet, un Ping KO reste une donnée valide.

Lorsque l’équipement ne répond pas :

  * Le driver retourne bien une valeur
  * La valeur remontée est simplement "false"

L’alarme NoData ne se déclenchera donc jamais tant que la sonde continue de recevoir les métriques du driver Ping.

=== ⏱️ Attention au polling ===

Le délai configuré dans une alarme NoData doit toujours être :

  * **Supérieur ou égal** au polling minimal du driver

 Exemple :

  * Polling minimal du driver : 10 minutes
  * Alarme NoData : 5 minutes ❌

Dans ce cas, Zebrix Control vérifiera l’absence de données avant même que le driver ait eu le temps de remonter une nouvelle mesure.

Résultat :

  * Des fausses alertes apparaîtront régulièrement

=== ✅ Bonne configuration ===

  * Polling driver : 10 minutes
  * Alarme NoData : 10 minutes ou plus

==== 📊 Alarmes sur mesures ====

Ce type d’alarme permet de comparer directement une métrique avec une valeur ou un seuil.

C’est le mode d’alarme le plus utilisé.

{{ .:pasted:20250814-112543.png?600 }}

Pour une métrique donnée, vous pouvez définir plusieurs seuils correspondant à différents niveaux d’état.

Une alarme se déclenche lorsque la valeur remontée par la sonde correspond aux critères définis.

Par défaut :

  * Si aucune condition ne correspond → le statut reste **OK**
  * Si plusieurs conditions correspondent → le statut le plus critique est appliqué

===  Exemple : volume audio ===

Un équipement remonte une métrique "volume".

Vous pouvez configurer :

  * **Info** si volume = 0
  * **Warning** si volume > 50
  * **Critique** si volume > 80

Le statut de l’équipement évoluera automatiquement selon les valeurs remontées.

===  Exemple : driver Ping ===

Le driver Ping remonte une valeur booléenne :

  * "true"
  * "false"

Configuration recommandée :

  * Niveau : **Injoignable**
  * Condition : "="
  * Valeur : "false"

{{ .:pasted:20260515-104321.png?800 }}

Dans ce cas :

  * "true" → équipement joignable
  * "false" → équipement injoignable