VMware Cloud Director include diversi livelli di registrazione. La configurazione predefinita della registrazione potrebbe non essere sufficiente per gli ambienti con molti data center o per l'acquisizione degli eventi durante la risoluzione dei problemi. Potrebbe essere necessario modificare il livello di registrazione e anche le dimensioni e il numero di file conservati.

Importante: Assicurarsi di conoscere le conseguenze che le modifiche della configurazione della registrazione senza le istruzioni del team di supporto globale di VMware possono avere sul gruppo di server di VMware Cloud Director. Se si modifica un livello di registrazione impostandolo su uno più dettagliato, è possibile che i registri inizino a espandersi molto rapidamente esaurendo lo spazio su disco dell'ambiente VMware Cloud Director.

I registri di VMware Cloud Director si trovano nella directory /opt/vmware/vcloud-director/logs/.

Il file di configurazione del registro di VMware Cloud Director si trova nella directory /opt/vmware/vcloud-director/etc/. Il nome del file di configurazione del registro è log4j.properties.

Se si personalizza il file di configurazione del registro log4j.properties prima di un aggiornamento di VMware Cloud Director, è necessario creare una copia di log4j.properties e dopo l'aggiornamento inserire manualmente eventuali sezioni mancanti.

Per migliorare la conservazione dei registri e garantire che i registri di VMware Cloud Director vengano conservati per un determinato periodo di tempo, è consigliabile utilizzare un server syslog.

Tabella 1. Livelli di registrazione
Livello di registrazione Descrizione
FATAL Questo livello registra eventi di errore molto gravi che potrebbero causare la mancata riuscita dell'applicazione.
ERROR Questo livello registra gli eventi di errore che potrebbero comunque consentire l'esecuzione dell'applicazione.
WARN Questo livello registra le situazioni e gli avvisi potenzialmente dannosi.
INFO Questo livello registra i messaggi informativi che evidenziano l'avanzamento dell'applicazione a livello generico.
DEBUG Questo livello registra gli eventi informativi più utili per eseguire il debug di un'applicazione a livello dettagliato.
TRACE Questo livello registra gli eventi informativi a un livello più dettagliato rispetto alla registrazione di livello DEBUG.

Prerequisiti

Creare una copia di backup del file /opt/vmware/vcloud-director/etc/log4j.properties.

Considerazione

Procedura

  1. Accedere alla console di VMware Cloud Director come root direttamente o utilizzando un client SSH.
  2. Aprire il file /opt/vmware/vcloud-director/etc/log4j.properties in un editor di testo.
  3. Individuare la definizione del file di registro che si desidera aggiornare. 
    log4j.appender.Feature.File=logs/File_Name
    Ad esempio, potrebbe essere necessario modificare il livello di registrazione per la sezione # Component appender for container debug. L'ultima riga della sezione configura il livello di registrazione acquisito dal file.
  4. Impostare il livello di registrazione sul valore desiderato.
    Importante: Assicurarsi di conoscere le conseguenze che le modifiche della configurazione della registrazione senza le istruzioni del team di supporto globale di VMware possono avere sul gruppo di server di VMware Cloud Director.
    TRACE è il livello più dettagliato e FATAL è il livello meno dettagliato. Nell'esempio seguente la riga viene modificata in modo da corrispondere al livello più dettagliato. 
    log4j.appender.vcloud.system.debug.threshold=TRACE
  5. Se si modifica la registrazione impostandola su un livello più dettagliato, potrebbe essere necessario aumentare il numero di backup dei registri e le dimensioni dei file di registro.
    1. Individuare le righe MaxFileSize e MaxBackupIndex. 
      log4j.appender.vcloud.system.debug.MaxFileSize=
      log4j.appender.vcloud.system.debug.MaxBackupIndex=
    2. Modificare le impostazioni predefinite.
      Ad esempio, se si desidera che i file di registro vengano espansi a 50 MB prima del rollover e che vengano conservati gli ultimi 18 registri, modificare le righe come indicato di seguito. 
      log4j.appender.vcloud.system.debug.MaxFileSize=50000KB
      log4j.appender.vcloud.system.debug.MaxBackupIndex=18
      Quando un file raggiunge le dimensioni di 50 MB selezionate, VMware Cloud Director continua a registrare i dati in un nuovo file e conserva fino a 18 backup.
    Importante: Se si modifica un livello di registrazione impostandolo su uno più dettagliato, è possibile che i registri inizino a espandersi molto rapidamente esaurendo lo spazio su disco dell'ambiente VMware Cloud Director.
  6. Salvare il file /opt/vmware/vcloud-director/etc/log4j.properties.
    VMware Cloud Director applica immediatamente le modifiche. Il file Log4J.properties non include righe esplicite per la modifica delle dimensioni e della quantità di registri che VMware Cloud Director conserva.