Rapports

Types de rapports

Chaque run écrit son rapport local à sa fin, avant tout envoi : un envoi échoué, un profil en submit: false et un profil personnalisé jamais noté laissent tous un fichier. Un rapport de benchmark porte un statut d'envoi — pending, submitted, failed ou not_submitted — et le même fichier est réécrit avec le VoxelScore quand voxelbench.com répond ; les rapports de stress limit et de test unitaire n'ont pas de tel statut. Ce qui est sauvegardé reste limitable par type (voir Stockage par type).

Consulter les rapports

Interface en jeu

/bench reports

Ouvre la liste de tous les rapports, avec un bouton de filtre par type de rapport (et Tous) et un bouton de nettoyage qui applique aussitôt les règles de rétention. /bench reports gui <type> l'ouvre déjà filtrée. Les listes sont paginées et triées par date, du plus récent au plus ancien. Cliquez sur un rapport pour voir son détail, par exemple :

• Statut, date, joueur et durée
• Informations serveur au moment du run
• Paramètres et métriques des tests
• Pour les rapports Stress Limit, la charge atteinte pour chaque type et si le serveur a rompu
• Pour un benchmark encore sans score — envoi en attente, échoué ou jamais effectué — Aucun score et le statut d'envoi à la place de zéros, plus l'erreur d'envoi quand il y en a une
• Un lien vers le rapport en ligne quand il existe, et un bouton de suppression

Le menu Rapports de /bench gui a une entrée par type de rapport, une entrée Comparer (voir Comparer les rapports) et un bouton de nettoyage qui demande une confirmation. Il a aussi une entrée Profils (expérimentale, exige voxelbench.profile) : les profils enregistrés par le profileur, avec leur propre liste et leur fiche ; et une entrée Mémoire (expérimentale, exige voxelbench.memory) : les résumés du tas et les analyses de vidage enregistrés par l'inspection mémoire — jamais les vidages du tas. Les boutons Nettoyer ne suppriment que d'anciens rapports, jamais des profils, des résumés du tas ni des analyses.

Les entrées Dashboard Scores et Derniers Résultats de /bench gui montrent le score du dernier benchmark tel que voxelbench.com l'a renvoyé : le plugin ne calcule aucun score lui-même. Sous Single-Core, elles listent les tests que le site compte dans ce sous-score, Redstone et Block Physics ; les tuiles de network et de singleCoreBenchmark indiquent Non compté dans le score du site. Voir VoxelScore.

Commandes chat

/bench reports list [type] [page]
/bench reports view <id>
/bench reports delete <id>
/bench reports cleanup

type vaut unit_test, benchmark, stresslimit ou all. <id> est l'identifiant court affiché par list.

Les résultats sont aussi affichés dans le chat à la fin d'un test ou d'un benchmark.

Comparer les rapports

L'entrée Comparer du menu des rapports (/bench gui, puis Rapports) affiche vos deux rapports les plus récents côte à côte. L'écart n'est calculé que si les deux sont réellement comparables :

• même type de rapport (une moyenne de TPS et un VoxelScore ne sont pas à la même échelle),
• pour deux tests unitaires, le même test,
• et un vrai score des deux côtés.

Sinon, l'écran indique que les deux rapports ne peuvent pas être comparés. Un benchmark sans score du backend affiche Aucun score et son statut d'envoi à la place d'un VoxelScore.

Utile pour :

• Mesurer l'impact de changements de configuration serveur
• Suivre les performances dans le temps
• Comparer avant et après une mise à niveau matérielle

Pour une comparaison détaillée, ouvrez chaque rapport ou comparez-les sur voxelbench.com.

Stockage

Les rapports sont sauvegardés en fichiers JSON, dans un sous-dossier par type de plugins/VoxelBench/reports/. Chaque nom de fichier est la date suivie de l'identifiant court du rapport :

plugins/VoxelBench/reports/
  benchmark/
    2026-09-12_18-30-45_1a2b3c4d.json
  unit_test/
    2026-09-12_14-00-00_5e6f7a8b.json
  stresslimit/
    2026-09-13_10-30-00_9c0d1e2f.json
  profiles/                              ← sorties du profileur, voir Profilage
    20260924-153012-manual.json
  memory/                                ← résumés du tas et analyses de vidage, voir Inspection mémoire
    20260924-210908-live.json

reports:
  enabled: true          # false désactive la sauvegarde et /bench reports
  folder: "reports"      # relatif à plugins/VoxelBench/

Stockage par type

Contrôlez quels types de rapports sont sauvegardés :

reports:
  storage:
    unit-tests: true       # /bench test
    benchmarks: true       # /bench start
    stresslimit: true      # /bench stresslimit, /bench tier, profils de stress

Rétention

Le nettoyage automatique empêche les rapports de s'accumuler indéfiniment :

reports:
  retention:
    max-age-days: 90       # Supprimer les rapports de plus de 90 jours (-1 = illimité)
    max-per-type: 100      # Maximum par type (-1 = illimité)
    max-total: 500         # Maximum total (-1 = illimité)
    cleanup-on-startup: true   # Nettoyage au démarrage du serveur

Une valeur de -1 (ou 0) désactive la règle correspondante. /bench reports cleanup applique les règles à la demande. Ces règles et le nettoyage ne concernent que les rapports : les profils de reports/profiles/ gardent leur propre rétention (profiling.storage, voir Profilage) et les résumés du tas et analyses de vidage de reports/memory/ la leur (memory-inspection.summary et memory-inspection.analysis, voir Inspection mémoire) ; le nettoyage des rapports ne les supprime jamais.

Synchronisation backend

Les benchmarks complets (/bench start) et les runs Stress Limit sont toujours soumis à voxelbench.com, que votre serveur soit lié ou non. Les profils personnalisés ne sont envoyés qu'avec submit: true dans le profil ; avec le submit: false par défaut, le run reste local, et le rapport d'un profil de benchmark est marqué not_submitted. Les résultats de tests individuels ne sont envoyés que si la synchronisation des tests unitaires est activée et que votre serveur est lié (voir Liaison de compte) :

reports:
  backend:
    unit-tests: true     # défaut : false

Une fois activée, les résultats de /bench test et /bench tier sont soumis au backend pour le suivi dans votre tableau de bord.

Rapports en ligne

Rendez-vous sur voxelbench.com pour :

• Consulter votre historique complet de rapports
• Comparer votre serveur avec d'autres
• Partager vos rapports avec votre communauté
• Suivre les tendances de performance dans le temps