Lire un rapport

L'en-tête

Le haut de la page dit ce qui a été mesuré, et où :

• Le titre est le nom du serveur quand son propriétaire affiche le serveur sur son profil public, l'hébergeur et son offre pour un rapport certifié, et Rapport de benchmark sinon. Il s'accompagne de la bannière et de l'icône du serveur, d'une coche verte quand le serveur est vérifié, et de son adresse quand son propriétaire a activé Afficher l'adresse sur les rapports. Un rapport mesuré pour l'offre d'un hébergeur indique Hébergé chez cet hébergeur.
• Les badges donnent la visibilité (Public, Non répertorié, Privé, Certifié ou Anonyme), le mode de benchmark (STANDARD, LIMITE DE STRESS…), la version du barème et AUTO-BENCH quand l'auto-bench l'a lancé. Survolez la version du barème pour lire ce qu'elle signifie ; barème antérieur marque un rapport noté avec des règles plus anciennes que les règles actuelles, dont le score ne se compare pas directement à un score récent.
• Dessous, la date et l'heure, la version de VoxelBench qui a mesuré et la durée du run. Sur un rapport public ou certifié, le nom du propriétaire mène à son profil public.
• Les boutons : Ajouter au comparateur (voir Classement et comparaison), Badge et Partager (voir Image de partage et badge), et Signaler, qui permet à un visiteur connecté de signaler le rapport aux modérateurs.

Un rapport certifié ajoute un bandeau Certifié VoxelBench, avec un lien vers la certification. Quand des plugins ou des mods connus pour fausser les résultats ont été détectés sur le serveur, Ce score peut être trompeur les énumère.

Score et verdict

Sur un run standard, le premier bloc donne le Score total et le Rang, puis les trois familles du score, Mono-cœur, Gameplay et Matériel, chacune avec sa barre. Comment ce score est composé mène aux sous-scores détaillés en bas de page. Le calcul de chaque chiffre est expliqué dans Comment fonctionne le scoring.

À côté, Le verdict dit ce que vaut ce score :

• le constat le plus grave du diagnostic, avec sa conséquence et les chiffres sur lesquels il repose, ou Aucune mesure ne franchit un seuil quand rien ne signale un défaut ;
• le test le plus faible, face au TPS le plus bas que tiennent tous les autres tests ;
• combien de tests de tick sont en échec, critiques, instables et sains ;
• Réglages non standard quand la configuration du serveur s'écarte des valeurs par défaut, et les Multiplicateurs appliqués (synergie, stabilité, durée, GC).

Quand un test obligatoire a échoué ou a été ignoré, le rapport n'a ni score ni rang (voir Comment fonctionne le scoring). Les familles qui dépendent de ce test affichent Échec ou Non mesuré ; survolez le mot pour voir les tests concernés.

Ce qu'il faut retenir et les réglages qui en découlent

Ce qu'il faut retenir traduit le diagnostic en cartes, tirées des mesures et jamais estimées. Chaque carte a une gravité (Critique, Avertissement ou Pour information), une conséquence, et souvent une Cause probable : comme un quota de cœurs, la latence du disque ou une pause du ramasse-miettes. Voir le réglage que cela justifie mène au réglage correspondant plus bas. Une carte À savoir rappelle de comparer avec prudence quand le serveur ne tourne pas avec les réglages par défaut.

Les réglages que vos mesures justifient liste, pour un run standard, les réglages qu'appelle une mesure de ce rapport, rangés selon l'endroit où ils se font : JVM, Paper, Spigot, Bukkit ou Serveur. Chacun donne :

• où le régler : la Ligne de démarrage Java, ou le fichier de configuration ;
• la valeur à mettre, avec un bouton Copier, et pourquoi cette mesure l'appelle ;
• Actuellement, la valeur en place quand le plugin a pu la lire ;
• Mesuré, le chiffre qui a franchi le seuil, et le seuil ;
• Test à rejouer, le test qui vous dira si le changement a servi.

Appliquez un réglage à la fois et rejouez le test nommé : tant que vous ne l'avez pas mesuré, l'effet reste une hypothèse. Quand rien ne franchit un seuil, la section dit qu'il n'y a rien à changer. Briefing pour un modèle de langage contient ces réglages et leurs chiffres sous une forme à coller dans un assistant pour les faire reformuler : tous les nombres y sont déjà, le modèle n'en a donc aucun à inventer.

L'API rend le même diagnostic et les mêmes réglages (/reports/{id}/diagnosis et /reports/{id}/tuning, voir API et jetons).

Test par test

Test par test consacre une ligne à chaque test de tick, les problèmes d'abord :

Choisissez une ligne pour aller au test. Les tests de mémoire, de disque et multi-cœur n'ont pas de ligne : ils se lisent par leur score. Un test ignoré n'en a pas non plus ; sa carte en donne la raison.

Toutes les mesures montre ensuite chaque test en entier, par catégorie. Les tests en difficulté sont ouverts, les autres se replient sur leur ligne de résumé. La carte d'un test donne son issue (Réussi, Échec ou Ignoré), les avertissements du plugin (Échantillons non filtrés utilisés, Ramasse-miettes chargé, Le run n'a pas tenu), Percentiles et stabilité, et les autres champs du test sous Données brutes.

Tests ignorés

Un test ignoré est un test que le plugin a choisi de ne pas lancer, ou qu'il a arrêté pour protéger le serveur : il ne dit rien contre le serveur, mais il n'a rien mesuré non plus. Sa carte en donne la raison en clair, par exemple Ignoré pour protéger la mémoire du serveur ou Aucun joueur connecté, avec ce qui s'est passé. La liste complète des raisons, tests ignorés et échoués, se trouve dans Tests unitaires. Une raison envoyée par un plugin plus récent, que le site ne connaît pas encore, s'affiche sous forme de code.

Machine et serveur

Machine et serveur, replié par défaut, décrit l'environnement :

• Signaux d'hébergement, quand les chiffres les révèlent : Sonde dégradée (la détection matérielle a échoué), CPU partagé / bridé (l'hôte expose bien plus de CPU que le serveur ne peut en utiliser), Conteneurisé, Quota disque, Espace disque faible. Survolez un signal pour son explication.
• Informations CPU : modèle, fabricant, cœurs physiques et logiques, combien sont disponibles pour le serveur, fréquence maximale.
• Informations serveur : logiciel serveur et version de Minecraft, versions de Bukkit et de Java, système d'exploitation, localisation (pays), nombre de plugins, mémoire de la JVM, limite mémoire du conteneur (avec un avertissement quand le tas l'atteint ou la dépasse), et les options de la JVM, avec leur analyse.

Ce qui apparaît ici dépend du niveau d'anonymisation du plugin (voir Confidentialité et sécurité).

Détail des scores, en bas d'un run standard, donne les sous-scores (Mémoire, Disque, Multi-cœur ; Exploration, Entités, Mécaniques) et les quatre multiplicateurs (voir Comment fonctionne le scoring).

Autres sortes de runs

• Stress limit. La vue stress limit remplace le score et le verdict : le Score de stress sur le barème stress-limit, le rang, et les paliers que le serveur a franchis avant de céder (voir Stress limit).
• Benchmark personnalisé. Une carte Benchmark personnalisé indique que le run se consulte seulement : il n'a pas de score et n'est jamais classé.
• Profil personnalisé. Une carte nomme le profil, son auteur, sa version, le nombre de runs qui l'ont utilisé, ses étiquettes et sa description.
• Profil de stress personnalisé. Affiché avec la vue stress limit, mais marqué Profil de stress personnalisé — non noté : ses seuils et ses tests sont ceux de l'auteur du profil, et le résultat ne se compare pas au stress limit officiel.

Ces trois sortes de runs ne sont acceptées que d'un serveur lié, et peuvent être privées ou non répertoriées, jamais publiques (voir Profils personnalisés).

Qui peut voir un rapport

Un rapport venant d'un serveur lié commence Privé ; un rapport venant d'un serveur non lié est Anonyme et n'appartient à aucun compte.

Seul l'auteur du rapport, le compte dont le serveur lié l'a envoyé, change sa visibilité, à trois endroits : le menu de visibilité du bandeau Votre rapport · visible par vous seul sur la page du rapport, le menu du rapport dans Tableau de bord → Rapports (Rendre public, Rendre non répertorié, Rendre privé), ou l'API avec la portée reports:write. Le détenteur d'un serveur vérifié peut lire les rapports privés de ce serveur, mais pas les publier. Sur la page du rapport, le rendre public demande une confirmation, puisque ses données de performance deviennent visibles de tous. Les mêmes règles valent aux trois endroits :

• publier un rapport ou le partager par lien (public ou non répertorié) demande une adresse email vérifiée ;
• les benchmarks personnalisés, les profils personnalisés et les profils de stress personnalisés peuvent être privés ou non répertoriés, jamais publics ;
• la visibilité d'un rapport certifié est gérée par l'hébergeur, pas par vous.

Archiver le rapport, dans le même menu du tableau de bord, retire un rapport du classement et de votre profil public et supprime ses données détaillées. C'est irréversible.

Description et notes privées

Modifier les notes, dans le bandeau du propriétaire, contient deux textes :

• Description publique : le contexte du run (réglages, configuration, plugins). Elle apparaît au-dessus des chiffres pour toute personne qui peut voir le rapport. Jusqu'à 2 000 caractères et 3 liens ; une modération automatique la vérifie à l'enregistrement.
• Notes privées : vos propres notes, jusqu'à 5 000 caractères, visibles seulement de vous et des modérateurs et administrateurs du site.

Les modérateurs peuvent modifier la description publique ; vous seul modifiez vos notes privées, sur la page du rapport comme par l'API (portée reports:write). Le détenteur du serveur, même vérifié, ne les voit pas.

JSON brut

JSON brut, dans le bandeau du propriétaire, télécharge exactement la charge utile que le plugin a envoyée pour ce rapport. Il est proposé au propriétaire, et aux administrateurs de VoxelBench, dont le téléchargement est journalisé ; jamais aux modérateurs, aux hébergeurs ni aux visiteurs, même sur un rapport public. Une fois un rapport archivé, ses données brutes ont disparu.

Durée de conservation

À moins de 7 jours de la fin, un bandeau Bientôt expiré donne le temps restant. Un rapport expiré affiche Rapport expiré jusqu'à son archivage, dans la journée : ses données détaillées sont alors supprimées et sa page ne s'ouvre plus. Les résultats de tests unitaires suivent leurs propres règles (voir Plans et limites).

Image de partage et badge

Quand vous collez le lien d'un rapport dans Discord, sur X ou sur Reddit, l'aperçu montre une image tirée du rapport : le score total, les trois scores de catégorie, le rang, la position du rapport parmi les rapports publics (Top N %), la date, les versions du plugin et du serveur, et le nom, l'icône et la bannière du serveur quand son propriétaire l'affiche publiquement (son adresse aussi, avec Afficher l'adresse sur les rapports). Un rapport certifié reçoit un cadre vert et la mention CERTIFIED. Un run personnalisé affiche CUSTOM BENCHMARK, CUSTOM PROFILE ou STRESS PROFILE au lieu d'un score. L'image est toujours en anglais.

L'image n'existe que pour les rapports publics, non répertoriés et certifiés : un rapport privé ou anonyme n'en a pas.

Sur un rapport noté, deux boutons s'en servent :

• Badge montre l'image et propose Télécharger PNG, Copier l'image, Copier le lien et son URL directe de l'image, pour l'intégrer à un site ou à un forum.
• Partager propose Copier le lien, Partager sur X, Partager sur Reddit, Comparer avec d'autres, Télécharger le résumé (un court fichier texte) et un QR code.