Alertes sur événements

Fonctionnement

Le plugin détecte une chute de TPS
  → POST /api/v1/monitoring/events
  → voxelbench.com enregistre l'événement
  → Vérifie toutes les règles d'alerte d'événements actives de ce serveur
  → Une règle correspond → entrée d'historique et notification dans l'application, tout de suite
                         → email et message Discord mis en file, envoyés dans la minute
  → La réponse inclut : alerts_dispatched: 1

La correspondance et la notification dans l'application se font dans la requête même qui apporte l'événement. Les emails et messages Discord passent par la même file de livraison que les alertes métriques, qu'une tâche de fond vide chaque minute, avec nouveaux essais. Seuls les événements envoyés par le serveur sont examinés : ceux que voxelbench.com ajoute lui-même (alertes métriques, maintenance, régression) ne déclenchent jamais une règle d'événement.

Créer une alerte événement

Dans le menu latéral, ouvrez Monitoring, puis votre serveur, puis l'onglet Alertes. Dans Règles d'alerte d'événements, cliquez sur Ajouter une règle d'alerte : la fenêtre Créer une alerte d'événement s'ouvre.

Configuration

Logique de correspondance

Une règle correspond à un événement quand TOUS les critères renseignés sont remplis :

• Type : s'il est renseigné, le type de l'événement doit correspondre exactement
• Catégorie : si elle est renseignée, la catégorie doit correspondre exactement
• Source : si elle est renseignée, la source doit correspondre exactement
• Sévérité : la sévérité de l'événement doit être ≥ au minimum (info < warning < error)

Laisser un champ sur « Tous » ou « any » accepte n'importe quelle valeur. Les événements que le plugin envoie, avec leur catégorie et leur sévérité, sont listés dans Événements serveur.

Exemples de configurations

"Me notifier de tous les problèmes critiques"

• Type : Tous
• Catégorie : Tous
• Source : any
• Sévérité min : Erreur
• Canaux : Email + Discord

→ Capte : tps_critical et memory_critical, les événements de sévérité erreur du plugin

"Sanctions LiteBans"

• Type : Tous
• Catégorie : moderation
• Source : any
• Sévérité min : Avertissement
• Canaux : Discord

→ Capte : ban et tempban venant de LiteBans (mutes, kicks et levées de sanction sont de sévérité info). Demande l'intégration LiteBans activée, et une offre Enterprise ou un compte hébergeur

"Alertes performance VoxelBench"

• Type : Tous
• Catégorie : performance
• Source : voxelbench
• Sévérité min : Avertissement
• Canaux : Dans l'application

→ Capte : tps_drop, tps_critical, gc_major, memory_high, memory_critical, player_count_full

"Changements d'opérateurs et de whitelist"

• Type : Tous
• Catégorie : security
• Source : any
• Sévérité min : Avertissement
• Canaux : Discord + Email

→ Capte : player_op, et une whitelist désactivée. Avec le minimum sur Info, il capte aussi player_deop, les autres changements de whitelist et config_reload

Délai d'attente

Après qu'une règle s'est déclenchée, elle ne se redéclenche pas pendant le délai d'attente configuré (de 5 minutes à 24 heures). Cela évite le spam de notifications quand beaucoup d'événements arrivent vite (par exemple un TPS qui chute encore et encore pendant un pic de lag).

Les événements correspondants tus par le délai d'attente sont comptés : la notification suivante dit combien (par exemple « (+12 autres événements correspondants depuis la dernière alerte) »), et l'historique des alertes l'indique (« +12 tus par la temporisation »).

Maintenance et sourdine

Pendant une maintenance du serveur, ou tant que la règle est en sourdine (icône de cloche), les événements correspondants sont quand même enregistrés dans l'historique des alertes, marqués comme tus — personne n'est notifié. Un événement est un instant : il n'est pas notifié après coup quand le silence prend fin.

Historique et livraison

Chaque déclenchement d'une règle d'événement est enregistré dans l'historique des alertes (filtre Alertes d'événement), avec l'événement qui a correspondu et ce que chaque canal a fait. Les emails et messages Discord passent par la même file que les alertes métriques, avec nouveaux essais. Le bouton Envoyer une notification de test envoie sur les canaux de la règle un faux événement clairement signalé, sans rien enregistrer.

Alertes métriques vs alertes événements

Utilisez les deux ensemble pour une couverture complète : les alertes métriques pour les problèmes de performance qui durent, les alertes événements pour être prévenu tout de suite de faits précis.