Événements serveur
Les événements serveur sont des occurrences ponctuelles signalées par votre serveur Minecraft. Contrairement aux métriques continues (TPS, CPU), les événements capturent des moments précis : un redémarrage, un ban de joueur, un flag anticheat, une détection de chute de TPS.
Sources d'événements
Les événements peuvent provenir de trois endroits :
1. Plugin VoxelBench (automatique)
Le plugin détecte et envoie automatiquement des événements :
Événements de performance :
tps_drop— TPS maintenu sous le seuil pendant 10stps_critical— TPS tombé critiquement bas (immédiat)tps_recovery— TPS revenu à la normalegc_major— Pause GC dépassant 200ms
Événements mémoire :
memory_high— Utilisation RAM au-dessus de 80% (avec hystérésis de 5%)memory_critical— Utilisation RAM au-dessus de 95%
Événements sécurité :
player_op/player_deop— Statut opérateur modifiéwhitelist_change— Whitelist modifiéeconfig_reload— Configuration serveur rechargée
Événements joueurs :
player_count_high— Nombre de joueurs au-dessus de 80% des slots maxplayer_count_full— Serveur plein
Événements cycle de vie :
server_start— Serveur démarréserver_stop— Serveur arrêtérestart— Serveur redémarré (changement de boot timestamp)
2. Plugins tiers (via l'API VoxelBench)
D'autres plugins peuvent envoyer des événements via l'API du plugin VoxelBench :
- LiteBans :
ban,tempban,mute,tempmute,kick,unban,unmute - Plugins anticheat :
flag,punish,alert - N'importe quel plugin peut enregistrer des événements personnalisés
3. Générés par le backend (depuis les alertes métriques)
Quand une alerte métrique se déclenche ou se résout, le backend crée automatiquement un événement. Cela relie les deux systèmes pour que toute activité d'alerte apparaisse dans la timeline des événements.
Structure d'un événement
| Champ | Description | Exemple |
|---|---|---|
| Type | Identifiant spécifique | tps_drop, ban, memory_high |
| Catégorie | Classification de groupe | lifecycle, moderation, security, custom |
| Source | D'où vient l'événement | voxelbench, litebans, alert |
| Sévérité | Niveau d'importance | info, warning, error |
| Titre | Résumé lisible | "Chute de TPS détectée" |
| Description | Détails optionnels | "TPS tombé à 12.3 pendant 15 secondes" |
| Metadata | Données structurées (JSON) | {"player": "Steve", "reason": "Fly hack"} |
Catégories
| Catégorie | Description | Sources typiques |
|---|---|---|
lifecycle | Démarrage/arrêt serveur, redémarrages, performance | Plugin VoxelBench, alertes |
benchmark | Début/fin de benchmark | Plugin VoxelBench |
moderation | Bans, kicks, mutes | LiteBans, Essentials |
security | Flags anticheat, changements d'op | Matrix, Vulcan, VoxelBench |
custom | Tout le reste | N'importe quel plugin |
Visualisation des événements
Les événements apparaissent à deux endroits sur le dashboard :
- Marqueurs sur les graphiques — Lignes verticales pointillées avec icônes de catégorie sur tous les graphiques
- Tableau d'événements — Tableau chronologique sous les graphiques avec filtrage par catégorie et source
Rétention
Les événements sont conservés pendant 90 jours puis automatiquement nettoyés.