4.3 Registrazione

4.3.1 Individuazione dei file di log

Sono disponibili due file di log:

  • <directory-installazione>/sessionserver/sessionserver/sessionserver.log: il file di log per l'applicazione del server di sessione.

  • <directory_installazione>/sessionserver/container.log: il file di log del container che ospita l'applicazione Host Access for the Cloud.

4.3.2 Configurazione della rotazione dei log

È possibile configurare la rotazione dei log modificando questi valori in <directory-installazione>\microservices\microservices\sessionserver\sessionserver\service.yml:

logging.file.max-size
logging.file.max-history

4.3.3 Impostazione dei livelli di log

Sono disponibili diversi tipi di livelli di registrazione che si possono utilizzare per produrre tipi diversi di informazioni. È possibile configurare i livelli di registrazione in <directory-installazione>\sessionserver\microservices\sessionserver\service.yml.

NOTA:Le righe in service.yml devono essere indentate utilizzando spazi.

Per impostare i livelli di log, utilizzare il formato seguente:

- name: logging.level.<logger>
   value: "<livello log>"

Dove <logger> è il nome del logger da regolare e <livello log> è uno dei seguenti:

  • Trace - indica eventi informativi con granularità più fine di Debug.

  • Debug - indica eventi informativi con granularità fine, utili in particolare per eseguire il debug di applicazioni.

  • Info - indica messaggi informativi che evidenziano l'avanzamento dell'applicazione con granularità più grossolana.

  • Warn - indica situazioni potenzialmente pericolose.

  • Error - indica eventi di errore che possono comunque consentire di continuare l'esecuzione dell'applicazione.

  • Fatal - indica errori gravi che presumibilmente causeranno l'interruzione dell'applicazione.

NOTA:È necessario riavviare il server di sessione dopo le modifiche apportate service.yml.

4.3.4 Client Web per la registrazione del server di sessione

Sebbene il browser fornisca un meccanismo di base per registrarsi nella console JavaScript, il client Web viene esteso e, con una certa configurazione, è possibile registrare gli eventi sul server di sessione per la visualizzazione da parte di un amministratore.

Per default, non viene registrato nulla sul server di sessione. Per abilitare questa funzione, è necessario impostare il livello di log seguendo le istruzioni riportate di seguito.

I livelli di log disponibili sono: debug, info, warn, error o off. Il livello di log predefinito è off.

Regolazione del livello di registrazione per tutti gli utenti del client Web

Per modificare il livello di registrazione per tutti i client Web, aggiungere la seguente voce a <directory-installazione>\sessionserver\microservices\sessionserver\service.yml

- name: <logger>
  value: "<livello di log>"

In cui <logger> è il seguente:

logging.level.com.microfocus.zfe.webclient.core.handler.ClientLoggingHandler-webclient

NOTA:Prestare attenzione quando si aumenta il livello di registrazione per tutti gli utenti del client Web in un ambiente di produzione a causa di un potenziale aumento del traffico di rete.

Regolazione del livello di registrazione per un singolo utente

Per modificare il livello di registrazione per i singoli utenti sono disponibili due opzioni:

Per modificare temporaneamente il livello di registrazione per un'istanza del client Web di un utente specifico senza richiedere il riavvio di un server di sessione, indicare all'utente di aggiungere il seguente parametro URL durante il caricamento del client Web nel browser:

https://mysessionserver.com:7443/?log=<livello di log>

Per modificare il livello di registrazione di un singolo utente senza che sia necessario apportare modifiche, aggiungere la seguente voce a service.yml:

- name: <logger>
  value: "<livello di log>"

In cui <logger> è il seguente:

logging.level.com.microfocus.zfe.webclient.core.handler.ClientLoggingHandler-webclient-<nome utente>

In cui <nome utente> è il nome della persona di cui si stanno regolando i livelli di registrazione.

NOTA:La registrazione in base a un nome utente richiede una modalità di autenticazione che coinvolga i nomi utente.