itzg/docker-minecraft-server

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

Offen

#3.870 geöffnet am 14.01.2026

Auf GitHub ansehen
 (1 Kommentar) (1 Reaktion) (0 zugewiesene Personen)Shell (1.858 Forks)batch import
enhancementhelp wanted

Repository-Metriken

Stars
 (13.694 Sterne)
PR-Merge-Metriken
 (Durchschn. Merge 15h 10m) (32 gemergte PRs in 30 T)

Beschreibung

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>

Contributor Guide

Research-Richtung
Untersuchen Sie, wie Sie die Umgebungsvariablenunterstützung hinzufügen, um die Log4j2 Ausgabe mit JsonTemplateLayout auf JSON umzustellen. Sehen Sie sich die vorhandenen LOG CONSOLE FORMAT/LOG FILE FORMAT Muster an und passen Sie die Startskripte des Containers an, um eine JSON Layout Konfiguration einzufügen.
Tech Stack
javadocker
Domain
backendinfrastructure
Issue Type
Funktion
SchwierigkeitGeschätzte Implementierungsschwierigkeit für neue Contributors, von 1 für sehr kleine Änderungen bis 5 für Expertenarbeit.
2
Geschätzte ZeitEin grober Zeitrahmen, um zu recherchieren, zu implementieren, zu testen und einen Pull Request vorzubereiten.
Halber Tag
AktivitätsstatusWie verfügbar das Issue gerade wirkt: frisch, aktiv, stale, blockiert oder wartet auf Maintainer-Input.
Frisch
KlarheitWie klar das Issue die erwartete Änderung, Akzeptanzkriterien und den nächsten Schritt erklärt.
Klar
Voraussetzungen
DockerMinecraft server basics
EinsteigerfreundlichkeitEin Score von 1 bis 100, der schätzt, wie zugänglich dieses Issue für First-Time Contributors ist.
65