Domanda

Come configurare il livello di dettaglio del logging di PTV xServer

Risposta 

Questo articolo spiega come regolare il livello di logging in PTV xServer 2 per controllare la quantità di dettagli registrati nei log. Questo è particolarmente importante negli ambienti di produzione per evitare dimensioni eccessive dei file di log e informazioni irrilevanti.

Framework di Logging

PTV xServer utilizza il framework log4j2 per il logging.

Livelli di Log Disponibili

Come Configurare

Per PTV xServer 1:

logRequests=fatal → Le richieste vengono registrate solo se il modulo si blocca. Questo dovrebbe essere impostato su true.
logResponses=false → Le risposte non vengono mai registrate. (Utile per i client che vogliono vedere risposte dettagliate — ma genera molti log e occupa spazio.)

Salvare il file e riavviare xServer per applicare le modifiche.

Per PTV xServer 2:

Modificare il file:
conf/wrapper.conf

Assicurarsi che le seguenti righe siano impostate (o modificarle secondo necessità):

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

Per log più dettagliati, cambiare INFO in DEBUG.
Salvare il file e riavviare xServer per applicare le modifiche.

Suggerimenti aggiuntivi

Su xServer 1:
Per impostazione predefinita, il logging non è attivo in modo continuo.
È configurato a un livello minimo, principalmente per diagnosticare errori critici.

Se si desidera contare il numero di richieste inviate (ad esempio a /xlocate/ws/XLocate o /xroute/ws/XRoute ecc., :

• Impostare logRequests=true
  → Questo registrerà tutte le richieste.
  → È quindi possibile contare le righe nei file di log.
  → Nota: Questo può generare un grande volume di log in produzione, quindi si consiglia un post-processing (ad esempio archiviazione o cancellazione dei log dopo un certo numero di richieste).

Su xServer 2: 
(Opzionale) Abilitare la rotazione dei log:
wrapper.logfile.maxsize=10m
wrapper.logfile.maxfiles=5
 

Fare riferimento ai manuali ufficiali:

• Configurazione del Logging - Manuale xRoute

• Configurazione del Logging - Dashboard xServer 2