Configuration des alertes
Guide étape par étape pour configurer les alertes d'événements pour votre réseau sismique.
Accéder à la configuration des alertes
- Connectez-vous à cloud.grillo.io
- Sélectionnez votre organisation et votre réseau
- Accédez à Paramètres → Alertes
Créer une règle d'alerte
Étape 1 : Démarrer une nouvelle règle
- Cliquez sur « Créer une règle d'alerte » ou « + »
- Le formulaire de configuration de la règle s'ouvre
Étape 2 : Nommer votre règle
Donnez à la règle un nom descriptif :
- « Événements ressentis - Email »
- « Tous les événements - Webhook »
- « Alerte d'urgence - M5+ »
Étape 3 : Définir les critères de magnitude
Configurez le seuil de magnitude :
- Activez « Filtre de magnitude »
- Définissez la magnitude minimale (ex. 3.0)
- Définissez optionnellement la magnitude maximale
Exemples de configurations :
| Cas d'utilisation | Mag Min | Mag Max |
|---|---|---|
| Tous les événements ressentis | 3.0 | - |
| Modérés uniquement | 4.0 | 5.9 |
| Événements majeurs | 6.0 | - |
Étape 4 : Définir les critères de localisation
Configurez le filtre géographique :
Option A : Rayon depuis un point
- Activez « Filtre de distance »
- Définissez le point central (lat/long ou recherche)
- Définissez le rayon en km
Option B : Zone géographique
- Activez « Filtre de zone »
- Dessinez un polygone sur la carte
- Ou entrez les coordonnées
Option C : Région nommée
- Activez « Filtre de région »
- Sélectionnez parmi les régions prédéfinies
Étape 5 : Définir les critères de qualité
Filtrez optionnellement par qualité de solution :
| Critère | Objectif |
|---|---|
| Stations min | Exiger plus de stations pour déclencher |
| Incertitude max | Rejeter les événements mal localisés |
| Statut | Événements révisés uniquement |
Étape 6 : Configurer les canaux
Choisissez comment les alertes sont livrées :
- Activez « Email »
- Entrez les adresses des destinataires
- Configurez le modèle d'email (optionnel)
Webhook
- Activez « Webhook »
- Entrez l'URL du webhook
- Configurez le format de la charge utile
- Définissez l'authentification (optionnel)
Tableau de bord
- Activez « Notification du tableau de bord »
- Configurez le son (optionnel)
Étape 7 : Définir la planification
Configurez quand la règle est active :
Toujours active :
- Alertes envoyées 24h/24 et 7j/7
Planifiée :
- Définissez les heures actives
- Définissez les jours actifs
- Utile pour les heures de bureau uniquement
Étape 8 : Enregistrer et activer
- Vérifiez tous les paramètres
- Cliquez sur « Enregistrer la règle »
- Basculez « Activé » pour activer
Gérer les règles d'alerte
Consulter les règles
La liste des règles d'alerte affiche :
- Nom de la règle
- Résumé des critères
- Canaux configurés
- Statut (activé/désactivé)
- Dernier déclenchement
Modifier les règles
- Cliquez sur une règle
- Modifiez les paramètres
- Enregistrez les modifications
Les modifications prennent effet immédiatement.
Activer/Désactiver
Basculez les règles on/off sans les supprimer :
- Cliquez sur le bouton d'activation/désactivation
- Les règles désactivées ne se déclenchent pas
- La configuration est préservée
Supprimer des règles
- Cliquez sur le menu de la règle (⋮)
- Sélectionnez « Supprimer »
- Confirmez la suppression
Les règles supprimées ne peuvent pas être récupérées. Envisagez de désactiver à la place.
Configuration des alertes par email
Gestion des destinataires
Ajouter plusieurs destinataires :
- Entrez l'adresse email
- Cliquez sur « Ajouter »
- Répétez pour les destinataires supplémentaires
Supprimer des destinataires :
- Cliquez sur « X » à côté de l'adresse
- Enregistrez les modifications
Contenu de l'email
L'email par défaut inclut :
- Résumé de l'événement (magnitude, localisation, heure)
- Image de carte
- Lien vers le tableau de bord
Modèle personnalisé (si disponible) :
- Modifier la ligne d'objet
- Personnaliser le contenu du corps
- Ajouter la marque de l'organisation
Configuration du webhook
URL du webhook
Entrez le endpoint pour recevoir les événements :
https://votre-serveur.com/api/grillo-events
Exigences :
- HTTPS recommandé
- Doit répondre dans le délai imparti
- Retourner 2xx pour succès
Authentification
Clé API :
Header: X-API-Key: votre-cle
Bearer token :
Header: Authorization: Bearer votre-token
Format de la charge utile
Charge utile JSON par défaut :
{
"event_id": "evt_123456",
"time": "2024-01-15T14:32:45Z",
"latitude": 37.7749,
"longitude": -122.4194,
"depth_km": 8.5,
"magnitude": 4.2,
"magnitude_type": "ML",
"location_description": "5 km NE de Ville"
}
Documentation complète du webhook →
Comportement de réessai
Échecs de livraison du webhook :
- Réessayer jusqu'à 3 fois
- Backoff exponentiel
- Échecs enregistrés
Tester votre configuration
Alerte de test
- Ouvrez la règle d'alerte
- Cliquez sur « Envoyer un test »
- Sélectionnez le canal
- Vérifiez la réception
Utiliser des événements historiques
- Trouvez l'événement dans le catalogue
- Cliquez sur « Tester les règles d'alerte »
- Voyez quelles règles se déclencheraient
- Envoyez un test aux canaux
Vérifier le webhook
- Utilisez un service de test de webhook
- Ou vérifiez les journaux de votre serveur
- Vérifiez que la charge utile est reçue correctement
Bonnes pratiques
Commencez prudemment
Commencez avec :
- Des seuils de magnitude plus élevés
- Des filtres géographiques plus larges
- Moins de canaux
Puis ajustez en fonction de l'expérience.
Testez minutieusement
Avant de vous fier aux alertes :
- Testez chaque canal
- Testez avec de vrais événements
- Vérifiez la livraison aux destinataires
- Documentez le comportement attendu
Ayez de la redondance
Pour les alertes critiques :
- Plusieurs canaux (email + webhook)
- Plusieurs destinataires
- Systèmes de notification de secours
Surveillez la santé des alertes
Vérifiez régulièrement :
- Les alertes sont-elles reçues ?
- Tous les canaux fonctionnent-ils ?
- Y a-t-il des échecs de livraison ?
Dépannage
La règle ne se déclenche pas
- Vérifiez que la règle est activée
- Vérifiez que les critères correspondent à l'événement
- Vérifiez la planification si configurée
- Consultez l'historique des alertes
Mauvais événements déclencheurs
- Examinez les paramètres de critères
- Vérifiez le seuil de magnitude
- Vérifiez le filtre géographique
- Resserrez les critères
Échecs de livraison
Email :
- Vérifiez les dossiers spam
- Vérifiez les adresses email
- Contactez le support
Webhook :
- Vérifiez que le endpoint est accessible
- Vérifiez l'authentification
- Vérifiez les journaux du serveur
- Examinez le format de la charge utile