Frage

Wie richtet man den Detaillierungsgrad des PTV xServer Loggings ein

Antwort 

Dieser Artikel erklärt, wie man das Logging-Level im PTV xServer 2 anpasst, um die Menge der im Log erfassten Details zu steuern. Dies ist besonders wichtig in Produktionsumgebungen, um übermäßige Logdateigrößen und irrelevante Informationen zu vermeiden.

Logging Framework

PTV xServer verwendet das log4j2-Framework für das Logging.

Verfügbare Log-Level

Wie man konfiguriert

Für PTV xServer 1:

logRequests=fatal → Requests werden nur geloggt, wenn das Modul abstürzt. Dies sollte auf true gesetzt werden.
logResponses=false → Antworten werden niemals geloggt. (Nützlich für Clients, die detaillierte Antworten sehen wollen – erzeugt aber viele Logs und benötigt Speicherplatz.)

Speichern Sie die Datei und starten Sie den xServer neu, um die Änderungen zu übernehmen.

Für PTV xServer 2:

Bearbeiten Sie die Datei:
conf/wrapper.conf

Stellen Sie sicher, dass die folgenden Zeilen gesetzt sind (oder passen Sie sie nach Bedarf an):

wrapper.console.loglevel=INFO
wrapper.logfile=%XSERVER2_LOG_DIRECTORY%/wrapper.log.YYYYMMDD
wrapper.logfile.format=LPTM
wrapper.logfile.loglevel=INFO
wrapper.logfile.rollmode=DATE

Für detailliertere Logs ändern Sie INFO zu DEBUG.
Speichern Sie die Datei und starten Sie den xServer neu, um die Änderungen zu übernehmen.

Zusätzliche Hinweise

Bei xServer 1:
Standardmäßig ist das Logging nicht dauerhaft aktiv.
Es ist auf einem minimalen Level konfiguriert, hauptsächlich zur Diagnose kritischer Fehler.

Wenn Sie die Anzahl der gesendeten Requests zählen möchten (z. B. an /xlocate/ws/XLocate oder /xroute/ws/XRoute usw.):

• Setzen Sie logRequests=true
  → Dadurch werden alle Requests geloggt.
  → Sie können dann die Zeilen in den Logdateien zählen.
  → Hinweis: Dies kann in der Produktion ein großes Logvolumen erzeugen, daher wird eine Nachbearbeitung (z. B. Archivierung oder Löschen der Logs nach einer bestimmten Anzahl von Requests) empfohlen.

Bei xServer 2:
(Optional) Aktivieren Sie die Logrotation:
wrapper.logfile.maxsize=10m
wrapper.logfile.maxfiles=5
 

Verweisen Sie auf die offiziellen Handbücher:

• Logging-Konfiguration - xRoute Handbuch

• Logging-Konfiguration - xServer 2 Dashboard