Vue d'ensemble du monitoring

Architecture

Serveur Minecraft (plugin)
  │
  ├── Heartbeat (toutes les 30 s)
  │     POST /api/v1/monitoring/heartbeat
  │
  ├── Relevés de métriques (pris toutes les 60 s, envoyés toutes les 60 s)
  │     POST /api/v1/monitoring/metrics
  │
  └── Événements (au fil de l'eau)
        POST /api/v1/monitoring/events
        │
        ▼
   voxelbench.com
        │
        ├── Relevés bruts (conservés 48 h)
        ├── Agrégats 5 minutes (conservés 7 jours)
        ├── Agrégats 1 heure (conservés 30 jours)
        ├── Agrégats 1 jour (conservés 1 an)
        ├── Événements (90 jours ; sécurité et modération : durée de consultation de votre offre)
        └── Évaluation des alertes et notifications

Chaque requête porte le jeton de liaison du serveur. Les intervalles sont des réglages du plugin : remote-monitoring.collect-interval (60 secondes par défaut, 30 au minimum) fixe la fréquence des relevés, et remote-monitoring.send-interval (60 secondes par défaut, 60 au minimum) celle des envois, jusqu'à 60 relevés par requête. Quand voxelbench.com est injoignable, le plugin garde les relevés qu'il n'a pas pu envoyer (120 par défaut) et les envoie dès que le site répond de nouveau. L'intervalle du heartbeat est fixe. Les réglages sont décrits dans Configuration.

Métriques collectées

Un relevé décrit tout l'intervalle écoulé depuis le précédent, pas un instant isolé :

Sur Folia, le TPS et les durées de tick portent la pire région, à côté de la moyenne de toutes les régions et du détail de chaque région. Un serveur que Minecraft met en pause parce qu'il est vide le signale, et ses chiffres de tick sont écartés des graphiques et des alertes TPS et MSPT. Les relevés ne contiennent jamais de nom de joueur. Certains de ces champs exigent un plugin récent ; une version plus ancienne en envoie moins. La liste exacte des champs est dans Monitoring.

Rétention des données

Les données sont automatiquement agrégées et nettoyées pour optimiser le stockage :

Vous avez donc une précision à la minute sur les 48 dernières heures (un point par relevé, toutes les 60 secondes par défaut), à cinq minutes sur la dernière semaine, à l'heure sur le dernier mois, et un point par jour sur un an. Jusqu'où vous pouvez remonter dépend de votre offre (voir Plans et limites).

Événements

Sur un compte hébergeur, les événements de sécurité et de modération sont conservés 30 jours.

Les alertes résolues sont conservées 90 jours. Le contenu de chaque notification (email ou Discord) n’est conservé que jusqu’à sa livraison, 24 heures au plus ; la trace de son envoi (canal, statut, heure) est conservée 30 jours. Si votre plan est échu et que VoxelBench n'a rien accepté d'un serveur depuis 30 jours, toutes ses mesures et tous ses événements sont supprimés. Supprimer un serveur, ou votre compte, supprime d'un coup toutes ses données de monitoring.

Détection en ligne/hors ligne

Le plugin envoie un heartbeat léger toutes les 30 secondes. Quand aucun heartbeat n'est arrivé depuis 90 secondes (trois heartbeats manqués), le serveur apparaît hors ligne : assez vite pour repérer un plantage, sans s'alarmer d'une brève coupure réseau.

Le heartbeat indique aussi depuis combien de temps le thread principal n'a pas tiqué : le tableau de bord distingue ainsi un serveur qui s'est tu d'un serveur figé (les heartbeats arrivent encore, mais aucun tick depuis 10 secondes), en pause parce que Minecraft suspend un serveur vide, arrêté volontairement, ou dont le monitoring a été mis en pause depuis le jeu. Voir Dashboard de monitoring pour l'affichage de chaque état, et Alertes métriques pour être prévenu.

Activer le monitoring

Le monitoring exige une offre qui le comprend (Pro, Enterprise ou un compte hébergeur) et deux interrupteurs : un sur VoxelBench, un dans le plugin. L'ordre n'a pas d'importance.

1. Liez votre serveur à votre compte avec /bench link (voir Liaison de serveur).

2. Activez-le sur VoxelBench. Ouvrez Tableau de bord → Monitoring : sous Mettre en place le monitoring, chaque serveur lié figure avec son interrupteur. Le même interrupteur se trouve dans l'onglet Monitoring des paramètres de chaque serveur (Tableau de bord → Serveurs → Gérer).

3. Activez-le dans le plugin. Tapez ceci dans la console du serveur, ou en jeu avec la permission voxelbench.monitor.web :

   /bench monitor remote on
   

   La commande écrit remote-monitoring.enabled: true dans la configuration du plugin, démarre les envois et vous dit dans le chat ce qu'il reste à faire. Vous pouvez aussi modifier vous-même plugins/VoxelBench/config.yml :

   remote-monitoring:
     enabled: true
   

   puis lancer /bench reload, qui l'applique : aucun redémarrage n'est nécessaire.

Si le plugin commence à envoyer avant l'étape 2, voxelbench.com refuse ses données : le plugin se met en pause et vérifie de nouveau chaque minute (toutes les 10 minutes tant que votre offre ne comprend pas le monitoring), puis démarre de lui-même. /bench monitor remote status indique où il en est.

La page Monitoring montre, pour chaque serveur, trois étapes (Lié à votre compte, Activé sur VoxelBench, Le plugin envoie ses données), leur état réel et ce qui manque encore. Dès que les données arrivent, le serveur apparaît sous Serveurs surveillés ; ouvrez-le pour accéder à son dashboard.

Pour arrêter, lancez /bench monitor remote off : le plugin prévient voxelbench.com que le monitoring a été mis en pause volontairement, pour qu'il ne soit pas pris pour un plantage, puis cesse d'envoyer.

Plugin antérieur à la 1.9.0

Ces versions n'ont pas /bench monitor remote on, et ne démarrent le monitoring distant qu'au démarrage du serveur : /bench reload ne le démarre pas. Activez d'abord le monitoring sur VoxelBench, puis mettez enabled: true dans config.yml et redémarrez le serveur. Un plugin qui envoie alors que le monitoring est encore désactivé sur VoxelBench est refusé, réécrit enabled: false dans sa configuration et s'arrête ; si c'est arrivé, remettez true et redémarrez. Mettre le plugin à jour lève ces deux contraintes.