Guide de l'Utilisateur du Module d'Alertes

Introduction

Le Module d'Alertes vous aide à surveiller les métriques clés de vos rapports et à être notifié lorsque des conditions spécifiques sont remplies. Vous pouvez créer des alertes personnalisées basées sur les résultats des requêtes, définir la fréquence des vérifications et choisir où les notifications sont envoyées.

Liste des Alertes

Sur la page Alertes, vous trouverez un tableau avec les colonnes suivantes :

• Nom : Le nom que vous avez donné à l'alerte.
• Dernière Exécution : Date et heure de la dernière vérification de cette alerte par le système.
• Dernier Déclenchement : Date et heure à laquelle l'alerte a rempli pour la dernière fois ses conditions et où des notifications ont été envoyées.

• État : Statut actuel :

  • en attente (aucune condition remplie)
  • déclenchée (conditions remplies lors de la vérification la plus récente)

• Actions :

  • Voir : Ouvre les Détails de l'Alerte.
  • Supprimer : Supprime définitivement l'alerte après confirmation.

Pour créer une nouvelle alerte, cliquez sur Créer une Alerte, entrez un nom, et appuyez sur OK.

Détails et Configuration de l'Alerte

Lorsque vous Voyez ou Créez une alerte, vous verrez un formulaire de configuration divisé en sections.

1. Nom de l'Alerte

• Modifiez le nom à tout moment en éditant le champ Nom de l'Alerte.

2. Sélectionner la Requête

• Choisissez sur quelle requête de rapport baser cette alerte. Chaque requête correspond à une table de données de résultats.

3. Canaux de Notification

• Envoyer l'Alerte à : Sélectionnez un ou plusieurs canaux (par ex., Email, Slack) où les notifications doivent être livrées.
• Les Canaux Disponibles sont définis dans Canaux
• Cliquez sur Ajouter pour attacher un canal à cette alerte.
• Pour supprimer un canal, cliquez sur l'icône × à côté de lui.

4. Planifications

• Les planifications sont spécifiques à la Requête à définir. Pour une planification de Requête, consultez la Planification de Requêtes dans la section Requêtes.

5. Règles (Conditions)

Définissez la logique qui déclenche l'alerte en fonction de points de données individuels.

1. Sélectionnez un Onglet de Requête : Utilisez les onglets en haut pour basculer entre différentes requêtes et voir leurs résultats.
2. Ajoutez une Règle : Cliquez sur n'importe quelle cellule de tableau dont vous souhaitez surveiller la valeur. Une nouvelle ligne apparaît dans la section Règles.

3. Configurez la Règle :

   • Nom de la Colonne et N° de Ligne sont pré-remplis en fonction de votre sélection.
   • Opération : Choisissez parmi <, <=, =, !=, >, >=.
   • Seuil : Entrez la valeur de comparaison.
4. Règles Multiples : Vous pouvez ajouter plusieurs règles. Toutes doivent être remplies pour que l'alerte se déclenche.
5. Supprimer une Règle : Cliquez sur l'icône de la corbeille dans la colonne Actions pour n'importe quelle règle.

6. Période de Réarmement (Cooldown)

Intervalle de Cooldown (Secondes de Réarmement) : Définissez un nombre de secondes à attendre après le déclenchement d'une alerte avant d'autoriser une autre notification.

• Une valeur non nulle signifie que le système traite l'alerte comme si elle avait "changé" après l'expiration du cooldown, déclenchant une nouvelle notification si la condition reste vraie.
• Si la valeur est 0, les notifications sont toujours envoyées immédiatement lorsque la condition d'alerte est remplie.

Relation avec la Planification de la Requête

• Les alertes ne sont vérifiées que lorsque la requête sous-jacente s'exécute. Si une requête s'exécute toutes les heures, vous ne pouvez pas recevoir de notifications plus fréquemment qu'une fois par heure, quelle que soit la valeur du cooldown.
• Lorsque les requêtes s'exécutent plus fréquemment (par ex., toutes les 15 minutes), choisissez un intervalle de cooldown pour éviter les alertes répétitives.

Scénario d'Exemple

Une requête de rapport s'exécute toutes les 30 minutes, et vous définissez l'intervalle de cooldown à 1 800 secondes (30 minutes). La condition d'alerte devient vraie à 10:15 et le reste jusqu'à 11:45.

• Point Clé : Les notifications se produisent au premier déclenchement, puis à chaque intervalle de cooldown si l'alerte est toujours déclenchée, et une fois lorsque l'état revient à OK.

7. Sauvegarder et Annuler

• Cliquez sur Sauvegarder l'Alerte pour appliquer vos modifications.
• Cliquez sur Annuler pour annuler les modifications et revenir à la Liste des Alertes.

Comment Fonctionnent les Alertes

• une tâche de fond s'exécute à chaque intervalle programmé.
• Elle récupère les derniers résultats de la requête et évalue vos règles.
• Si toutes les règles sont respectées et que la période de réarmement est écoulée, une notification est envoyée à chaque canal configuré.

Suppression des Alertes

Pour supprimer une alerte :

1. Sur la Liste des Alertes, cliquez sur Supprimer à côté de l'alerte.
2. Confirmez dans la fenêtre contextuelle.

Conseils et Meilleures Pratiques

• Noms Clairs : Utilisez des noms descriptifs pour pouvoir identifier rapidement les alertes.
• Fréquence Modérée : Définissez des planifications pas plus souvent que nécessaire pour éviter les vérifications excessives.
• Combinez les Règles : Utilisez plusieurs règles pour définir précisément quand vous voulez être notifié.

Support

Pour plus d'assistance, contactez votre administrateur ou visitez le centre d'aide.