itzg/docker-minecraft-server

Add first-class JSON log output (Log4j2 JsonTemplateLayout) via env var

Ouverte

#3 870 ouverte le 14 janv. 2026

Voir sur GitHub
 (1 commentaire) (1 réaction) (0 personne assignée)Shell (1 858 forks)batch import
enhancementhelp wanted

Métriques du dépôt

Stars
 (13 694 étoiles)
Métriques de merge PR
 (Merge moyen 15h 10m) (32 PRs mergées en 30 j)

Description

Enhancement Type

Improve an existing feature

Describe the enhancement

Describe the problem / motivation Many log pipelines and docker observation tools work best with JSON in container stdout. Today the image primarily supports customizing PatternLayout via LOG_CONSOLE_FORMAT / LOG_FILE_FORMAT, which still produces unstructured text. (docker-minecraft-server.readthedocs.io)

Proposed enhancement Add an opt-in way to switch console (and optionally file) logs to JSON output using Log4j2’s JsonTemplateLayout. (logging.apache.org)

Suggested UX:

  • LOG_FORMAT=json (or LOG_LAYOUT=json-template)
  • LOG_JSON_TEMPLATE=<builtin name | path>

Guide contributeur

Direction de recherche
Étudiez comment ajouter la prise en charge des variables d'environnement pour basculer la sortie Log4j2 vers JSON à l'aide de JsonTemplateLayout. Examinez les modèles LOG CONSOLE FORMAT/LOG FILE FORMAT existants et adaptez les scripts de démarrage du conteneur pour injecter une configuration de mise en page JSON.
Stack technique
javadocker
Domaine
backendinfrastructure
Type d'issue
Fonctionnalité
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
2
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
Une demi journée
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
Récente
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
Claire
Prérequis
DockerMinecraft server basics
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
65