Alertes métriques
Les alertes métriques surveillent les données de performance de votre serveur et vous préviennent quand un seuil est franchi assez longtemps. voxelbench.com les évalue chaque minute, sur les relevés envoyés par le plugin, et vous notifie sur le site, par email ou sur Discord.
Fonctionnement
Une tâche de fond vérifie chaque minute toutes les règles activées, sur les mesures envoyées par votre serveur. Le plugin envoie ses mesures par lots : la fenêtre de la règle se compte donc à rebours depuis la dernière mesure reçue, pas depuis l'heure actuelle.
- Toutes les mesures de la fenêtre franchissent le seuil → l'alerte se déclenche (une seule notification).
- Les 3 dernières mesures sont saines → l'alerte se résout.
- Sinon (trou, valeurs mêlées, aucune donnée) → rien ne change.
Pour se déclencher, la fenêtre doit contenir au moins 3 mesures quand la durée atteint 3 minutes (1 en dessous). Quand la dernière mesure date de plus de 10 minutes, rien n'est décidé. Les règles TPS et MSPT ignorent les mesures prises pendant que Minecraft suspendait un serveur vide.
Des données manquantes ne résolvent jamais une alerte : un serveur qui cesse d'envoyer garde ses alertes ouvertes, et c'est la règle Serveur hors ligne qui signale son silence.
Créer une règle
Dans le menu latéral, ouvrez Monitoring, puis votre serveur, puis l'onglet Alertes. Dans Règles d'alerte, cliquez sur Ajouter une règle d'alerte : la fenêtre Créer une règle d'alerte s'ouvre.
Configuration
| Champ | Description | Exemple |
|---|---|---|
| Nom de l'alerte | Nom lisible | « Alerte chute TPS » |
| Métrique | Quoi surveiller | TPS, MSPT, Nombre de joueurs, Nombre d'entités, Utilisation RAM (Mo), Utilisation CPU (%), Serveur hors ligne |
| Condition | Le sens du franchissement : Inférieur à ou Supérieur à | Inférieur à 18 |
| Seuil | La valeur de déclenchement, dans l'unité de la métrique | 18.0 |
| Durée (minutes) | Combien de temps la condition doit tenir, de 1 à 60 minutes (3 par défaut) | 3 |
| Délai d'attente (minutes) | Temps minimum entre deux alertes de la même règle, de 5 minutes à 24 heures (30 par défaut) | 30 |
| Canaux de notification | Où envoyer les alertes : Email, Webhook Discord, Dans l'application (email et application sont cochés par défaut) | Dans l'application, Email |
Métriques disponibles
| Métrique | Condition typique | Seuil exemple |
|---|---|---|
| TPS | Inférieur à | 18 (avertissement), 15 (critique) |
| MSPT | Supérieur à | 100 ms |
| Utilisation CPU (%) | Supérieur à | 80 % |
| Utilisation RAM (Mo) | Supérieur à | 14000 (pour un serveur de 16 Go) |
| Nombre de joueurs | Supérieur à | 90 (proche de la capacité) |
| Nombre d'entités | Supérieur à | 50000 |
| Serveur hors ligne | — | Serveur injoignable |
La métrique Serveur hors ligne est spéciale : elle se déclenche quand aucun heartbeat n'a été reçu pendant la durée configurée (3 minutes au moins), et n'a besoin ni de condition ni de seuil. Un serveur qui n'a jamais envoyé de heartbeat ne la déclenche pas : c'est l'assistant d'installation qui traite ce cas, et il propose de créer cette règle en un clic (Créer l'alerte « hors ligne » : 5 minutes, par email et sur le site). Les règles hors ligne attendent aussi, au lieu de lancer de fausses alertes, quand le problème vient sans doute de VoxelBench : quand aucun serveur surveillé ne donne de nouvelles, ou quand plus de 30 % d'entre eux (3 au moins) se taisent dans la même minute. Cette pause dure 30 minutes au plus.
La RAM se mesure en mégaoctets : pour « RAM au-dessus de 90 % » sur un serveur de 16 Go, utilisez un seuil d'environ 14 700 Mo.
Canaux de notification
In-App
Une notification apparaît dans votre cloche de notifications sur le site. Toujours disponible.
Un email HTML est envoyé à l'adresse de votre compte avec les détails de l'alerte, les valeurs métriques et un lien vers le dashboard.
Discord
Si votre serveur a un webhook Discord (paramètres du serveur, onglet Notifications, champ URL du webhook Discord, affiché que Notifier à chaque nouveau rapport soit activé ou non), un message embed est posté dans ce canal Discord. Si vous avez relié votre Discord personnel dans les paramètres du compte (Profil et paramètres → Notifications), vous recevez aussi une copie de chaque alerte d'une règle qui notifie au moins un canal.
Livraison et nouveaux essais
Les notifications par email et Discord passent par une file de livraison : si le serveur de messagerie ou Discord est indisponible un instant, la notification est retentée (après 1 minute, 5 minutes, 30 minutes, puis 2 heures) au lieu d'être perdue, et abandonnée après la cinquième tentative. Un webhook Discord qui n'existe plus ou refuse le message (401, 403, 404, 410) n'est pas retenté. Chaque alerte de l'historique montre ce que chaque canal a fait : reçu, nouvel essai, sauté (désabonnement, pas de webhook) ou échec.
Tester une règle
Le bouton Envoyer une notification de test (avion en papier), à côté de chaque règle, envoie tout de suite son message sur ses canaux, préfixé [TEST], et vous dit quels canaux l'ont reçu. Un test n'écrit aucun historique et ne déclenche pas le délai d'attente de la règle. Vous pouvez envoyer 5 tests par tranche de 10 minutes, règles métriques et règles d'événements confondues.
Maintenance et sourdine
Une intervention prévue ne doit pas vous réveiller. Trois façons de faire taire les alertes, dont aucune n'arrête l'évaluation — les alertes restent enregistrées dans l'historique, marquées comme tues :
- Maintenance — en haut du dashboard de monitoring du serveur, Maintenance fait taire toutes les alertes du serveur de 15 minutes à 24 heures. Elle se termine d'elle-même ; vous pouvez l'arrêter avant (Terminer la maintenance) ou la Prolonger. Elle existe aussi dans l'API (
/servers/{id}/maintenance, de 5 à 1 440 minutes) et pour les agents IA (start_maintenance,end_maintenance). - Sourdine d'une règle — l'icône de cloche à côté d'une règle (Mettre cette règle en sourdine) la fait taire pendant 1, 4 ou 24 heures. Contrairement à l'interrupteur, elle ne met pas la règle en pause et ne ferme pas ses alertes. Une règle en pause ne peut pas être mise en sourdine.
- Arrêts annoncés — quand le plugin signale que le serveur s'arrête, la règle Serveur hors ligne attend sa propre durée plus 30 minutes, comptées depuis l'annonce, avant d'alerter : un redémarrage prévu ne vous dérange pas, un serveur qui ne revient pas vous prévient quand même. Quand vous lancez
/bench monitor remote off, le silence est voulu et la règle ne se déclenche pas.
Si une alerte de seuil est toujours active à la fin du silence, elle est notifiée à ce moment — un serveur encore en panne après la maintenance ne reste pas muet.
Cycle de vie des alertes
- Déclenchée — Toutes les mesures de la fenêtre ont franchi le seuil ; les notifications partent une fois.
- Acquittée (facultatif) — Vous l'avez marquée comme vue (Acquitter). Elle reste ouverte et n'est plus notifiée jusqu'à sa résolution.
- Résolue — Les 3 dernières mesures sont de nouveau saines : une notification « Résolu après X min » part sur les mêmes canaux que l'alerte. Ou la règle n'est plus évaluée : mise en pause, monitoring coupé, offre qui n'inclut plus le monitoring, ou serveur au-delà du quota de l'offre. L'historique indique laquelle.
- Délai d'attente — Après une alerte, la même règle ne se redéclenche pas avant la fin du délai d'attente.
Mettre une règle en pause la garde telle quelle — canaux, durée et délai d'attente — et ferme ses alertes ouvertes.
Historique des alertes
Les alertes en cours sont listées au-dessus des onglets du dashboard, sous Alertes actives, où vous pouvez les Acquitter. Dans l'onglet Alertes, la section Historique des alertes montre toutes les alertes passées, que vous pouvez filtrer (Toutes, Déclenchées, Résolues, Acquittées, Alertes d'événement), avec :
- Nom de la règle et métrique
- Condition vs valeur réelle
- Statut (déclenchée / acquittée / résolue) et raison de la résolution
- Quand déclenchée et quand résolue
- Ce que chaque canal de notification a fait
Les alertes résolues sont conservées 90 jours.
Limites
La limite compte ensemble les règles métriques et les règles d'événements. L'onglet Alertes indique combien votre serveur en utilise.
| Plan | Règles max par serveur |
|---|---|
| Pro | 3 |
| Enterprise | 999 |
| Hébergeur | 10 |