Événements serveur — Monitoring

Sources d'événements

Les événements viennent de trois endroits.

1. Plugin VoxelBench (automatique)

Tant que le monitoring distant est actif, le plugin détecte et envoie lui-même ces événements. remote-monitoring.events.enabled coupe la détection, et chaque seuil ci-dessous est une valeur par défaut, modifiable sous remote-monitoring.events (voir Configuration).

Événements de performance (catégorie performance) :

tps_drop (avertissement) — TPS sous 18 pendant au moins 10 secondes
tps_critical (erreur) — TPS sous 10, envoyé immédiatement
tps_recovery (info) — TPS revenu à 18 ou plus après une chute
gc_major (avertissement) — Pauses de garbage collection majeures de 200 ms ou plus en 5 secondes
memory_high (avertissement) — Heap utilisé à 80 % ou plus du maximum ; renvoyé seulement après être redescendu sous 75 %
memory_critical (erreur) — Heap utilisé à 95 % ou plus
player_count_high (info) — Joueurs en ligne à 80 % ou plus des places du serveur
player_count_full (avertissement) — Serveur plein

Événements de sécurité (catégorie security) :

player_op (avertissement) / player_deop (info) — Statut d'opérateur modifié
whitelist_change — Whitelist modifiée (info), ou désactivée (avertissement)
config_reload (info) — /bench reload a été lancé

Événements de cycle de vie (catégorie lifecycle) :

server_start (info) — Serveur démarré
server_stop (avertissement) — Arrêt du serveur, annoncé par le plugin
monitoring_paused / monitoring_resumed (info) — Monitoring distant coupé ou relancé depuis le jeu avec /bench monitor remote off ou on

Événements de benchmark (catégorie benchmark) :

benchmark_start, benchmark_complete (info), benchmark_stopped (avertissement) — Un run de benchmark ou de stress limit
test_start, test_complete (info) — Un test unitaire (/bench test)

Un redémarrage n'est pas un événement : voxelbench.com le détecte quand l'heure de démarrage du serveur change, et le compte dans Redémarrages sur le dashboard.

2. LiteBans (intégré au plugin)

Quand l'intégration LiteBans est activée (remote-monitoring.events.litebans.enabled, désactivée par défaut, appliquée au prochain redémarrage du serveur), le plugin envoie les sanctions LiteBans avec la catégorie moderation et la source litebans : ban et tempban (avertissement), mute, tempmute, kick, unban et unmute (info). Ces événements nomment le joueur et le membre de l'équipe ; le motif n'est ajouté que si vous activez include-reason. La catégorie moderation demande une offre Enterprise ou un compte hébergeur.

Le plugin n'a pas d'autre intégration qui envoie des événements, ni d'API permettant à d'autres plugins d'envoyer les leurs. La catégorie custom est acceptée d'un serveur sous offre Enterprise ou compte hébergeur, mais le plugin VoxelBench n'en envoie aucun.

3. Générés par voxelbench.com

voxelbench.com ajoute ses propres événements à la chronologie du serveur, avec la source alert :

quand une alerte métrique se déclenche (alert_<métrique>, avertissement, ou erreur pour Serveur hors ligne) ou se résout (alert_resolved_<métrique>, info), dans la catégorie lifecycle ;
quand une maintenance commence ou se termine (maintenance_start, maintenance_end, catégorie lifecycle) ;
quand l'alerte de régression constate que les scores de benchmark d'un serveur vérifié ont baissé (benchmark_regression, catégorie benchmark).

Ces événements ne comptent pas dans votre limite quotidienne, et ne déclenchent pas les règles d'alerte d'événements.

Structure d'un événement

Chaque événement comporte :

Champ	Description	Exemple
Type	Identifiant précis de l'événement	`tps_drop`, `ban`, `memory_high`
Catégorie	Classement par groupe	`lifecycle`, `benchmark`, `performance`, `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	« Sustained TPS Drop: 12.3 »
Description	Détails facultatifs	« TPS below 18.0 for 15s (lowest: 11.8) »
Métadonnées	Données structurées (JSON, 2 Ko et 32 clés au plus)	`{"player": "Steve", "total_ops": 3}`
Horodatage	Quand c'est arrivé	Secondes epoch

Les titres et descriptions viennent du plugin, en anglais ; le dashboard traduit le type.

Catégories

Catégorie	Description	Sources
`lifecycle`	Démarrage et arrêt du serveur, monitoring mis en pause ou relancé, alertes métriques, maintenances	Plugin VoxelBench, voxelbench.com
`benchmark`	Début et fin des benchmarks et des tests, régression des benchmarks	Plugin VoxelBench, voxelbench.com
`performance`	Chutes et retours du TPS, GC majeurs, seuils de mémoire et de joueurs	Plugin VoxelBench
`moderation`	Bans, mutes, kicks et leur levée	LiteBans, via le plugin VoxelBench
`security`	Changements d'opérateurs, de whitelist, rechargements de configuration	Plugin VoxelBench
`custom`	Tout le reste (offre Enterprise et comptes hébergeur)	Autres outils

Visualisation des événements

Les événements apparaissent à deux endroits du dashboard de monitoring du serveur (voir Dashboard de monitoring) :

Marqueurs sur les graphiques — Lignes verticales en pointillés avec l'icône de la catégorie sur tous les graphiques ; un run de benchmark est une zone ombrée. Afficher sur les graphiques choisit les catégories tracées.
Tableau d'événements — Tableau chronologique sous les graphiques, filtrable par catégorie et par source, et exportable en CSV

Le dashboard montre les événements de la période que votre offre permet de consulter. Les scripts et les agents les lisent avec GET /api/v1/servers/{id}/events.

Rétention

Les événements sont conservés pendant 90 jours, puis supprimés automatiquement. Les événements de sécurité et de modération nomment des joueurs (un opérateur promu, un joueur sanctionné, un modérateur) : ils ne sont conservés que tant que votre offre vous permet de les consulter, soit 7 jours en Pro, 30 jours en Enterprise, 7 jours une fois votre plan échu. Sur un compte hébergeur, ils sont conservés 30 jours.

Limites

Plan	Événements par serveur et par jour	Catégories autorisées
Pro	500	Détecteurs intégrés : `lifecycle`, `benchmark`, `performance`, `security`
Enterprise	5 000	Toutes, dont `moderation` (LiteBans) et `custom`
Hébergeur	2 000	Toutes

La journée commence à minuit UTC. Au-delà de la limite, voxelbench.com refuse les événements du serveur jusqu'au lendemain. Un événement d'une catégorie que votre offre ne comprend pas est refusé, et le plugin cesse d'envoyer cette catégorie jusqu'au prochain /bench reload ; les métriques et les autres catégories continuent. Une requête porte 30 événements au plus.