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.

Controllo della registrazione delle richieste API in VMware Cloud Director

È possibile controllare il processo di acquisizione e archiviazione delle informazioni sulle richieste in entrata in VMware Cloud Director.

VMware Cloud Director registra le richieste in entrata nelle celle di VMware Cloud Director nei registri delle richieste. I registri hanno nomi con formato YYYY_MM_DD.request.log. I file VMware Cloud Director request.log si trovano nella directory /opt/vmware/vcloud-director/logs/, ma non è possibile configurare i registri tramite il file log4j.properties.

È possibile utilizzare il sottocomando manage-config dello strumento della riga di comando per controllare la registrazione delle richieste API. Il sottocomando manage-config modifica le impostazioni dell'intero gruppo di server. Per maggiori informazioni sulle opzioni e sugli argomenti del sottocomando manage-config, vedere Aggiornamento delle impostazioni di configurazione dell'applicazione in VMware Cloud Director.

La rotazione del registro può verificarsi al massimo una volta al giorno e non è collegata alle dimensioni dei singoli file di registro o alle dimensioni totali di tutti i file di registro. È possibile controllare il criterio di rotazione modificando la quantità di giorni per cui VMware Cloud Director conserva i registri.

Procedura

  1. Accedere direttamente o tramite un client SSH al sistema operativo della cella di VMware Cloud Director come utente root.
  2. Se si desidera modificare il criterio di conservazione dei registri delle richieste, utilizzare il sottocomando manage-config dello strumento di gestione delle celle.
    Il valore del criterio di conservazione rappresenta il numero di giorni per cui VMware Cloud Director conserva il registro delle richieste conforme a National Center for Supercomputing Applications (NCSA). Il valore predefinito è 0, in cui 0 significa per sempre. I registri vengono conservati per sempre anche quando si elimina il valore. La durata minima della conservazione dei registri è 1 giorno. 
    /opt/vmware/vcloud-director/bin/cell-management-tool manage-config --name "vcloud.http.log.retainDays" --value New_Value
  3. Per rendere effettive le modifiche, è necessario riavviare le celle.
    Dopo aver riavviato una cella, inizia a utilizzare il valore aggiornato. È possibile riavviare parte delle celle o tutte le celle contemporaneamente.