Alertes sur événements
Les alertes sur événements se déclenchent **instantanément** quand des événements correspondants sont reçus de votre serveur. Contrairement aux alertes métriques (qui vérifient selon un planning), les alertes événements envoient les notifications en quelques millisecondes.
Fonctionnement
Le plugin détecte une chute de TPS
→ POST sur Voxelbench.com
→ Voxelbench.com stocke l'événement
→ Vérifie toutes les règles d'alerte événement activées
→ Une règle correspond → notification instantanée
Pas de tâche cron, pas de polling. La notification est envoyée dans la même requête HTTP qui transmet l'événement.
Créer une alerte événement
Allez dans Dashboard > Monitoring > onglet Alertes > section Alertes sur événements > Ajouter une règle.
Configuration
| Champ | Description | Exemple |
|---|---|---|
| Nom | Nom lisible | "Alertes critiques" |
| Type d'événement | Correspondre à un type spécifique, ou "Tous" | tps_drop, ban, ou Tous |
| Catégorie | Correspondre à une catégorie, ou "Tous" | lifecycle, moderation, ou Tous |
| Source | Correspondre à une source, ou "tous" | voxelbench, litebans, ou tous |
| Sévérité minimum | Seuil de sévérité minimum | info, warning, ou error |
| Temps de repos | Temps minimum entre deux notifications | 5 minutes |
| Notifications | Où envoyer | In-app, Email, Discord |
Logique de correspondance
Une règle correspond à un événement quand TOUS les critères spécifiés sont remplis :
- Type : si défini, le type d'événement doit correspondre exactement
- Catégorie : si définie, la catégorie doit correspondre exactement
- Source : si définie, la source doit correspondre exactement
- Sévérité : la sévérité de l'événement doit être ≥ au minimum (
info<warning<error)
Mettre un champ à "Tous" / "tous" signifie qu'il correspond à tout.
Exemples de configurations
"Me notifier de tous les problèmes critiques"
- Type : Tous | Catégorie : Tous | Source : tous | Sévérité min : error
- Canaux : Email + Discord
- → Capture :
tps_critical,memory_critical, tout événement de sévérité error
"Notifications de bans"
- Type :
ban| Source : tous | Sévérité min : info - Canaux : Discord
- → Capture : chaque ban de LiteBans ou tout autre plugin de modération
"Alertes performance VoxelBench"
- Catégorie :
lifecycle| Source :voxelbench| Sévérité min : warning - Canaux : In-app
- → Capture :
tps_drop,gc_major,memory_high,server_stop
"Alertes anticheat"
- Catégorie :
security| Source : tous | Sévérité min : warning - Canaux : Discord + Email
- → Capture : flags de Matrix, Vulcan, Grim ou tout plugin anticheat
Temps de repos
Après le déclenchement d'une règle, elle ne se redéclenchera pas pendant la période de repos configurée (défaut : 5 minutes). Cela empêche le spam de notifications quand de nombreux événements arrivent rapidement.
Alertes métriques vs alertes événements
| Alertes métriques | Alertes événements | |
|---|---|---|
| Déclenchement | Cron vérifie toutes les 1-5 min | Instantané à réception |
| Latence | 1-5 minutes | < 1 seconde |
| Idéal pour | Conditions soutenues (TPS bas 3 min) | Occurrences ponctuelles (ban, redémarrage) |
| Détection | Backend analyse les métriques | Plugin détecte et signale |
| Config | Métrique + condition + seuil + durée | Type + catégorie + source + sévérité |
| Max règles | 3 (Pro) / illimité (Enterprise) | 10 par serveur |
Utilisez les deux ensemble pour une couverture complète.