Registrazione

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.

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_MAXSIZE LOGGING_FILE_MAXHISTORY

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.

Per impostare i livelli di registrazione, 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 (Traccia) - 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à meno fine.

• Warn (Avviso) - Indica situazioni potenzialmente pericolose.

• Error (Errore) - Indica eventi di errore che possono comunque consentire di continuare l'esecuzione dell'applicazione.

• Fatal (Irreversibile) - Indica errori gravi che presumibilmente causeranno l'interruzione dell'applicazione.

Abilitazione della registrazione da client Web a 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 (avviso), error (errore), o off (disattivato). Il livello di log di default è off (disattivato).

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

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:

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

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