O VMware Cloud Director tem diferentes níveis de log. A configuração de log padrão pode não ser suficiente para ambientes ocupados ou para capturar eventos durante a solução de problemas. Talvez seja necessário alterar o nível de log e até mesmo os tamanhos e o número de arquivos retidos.

Importante: Certifique-se de estar ciente das consequências para o seu grupo de servidores do VMware Cloud Director ao fazer alterações na configuração de logs sem orientação da equipe de Suporte Global da VMware. Se você alterar um nível de log para um mais detalhado, os logs poderão começar a se expandir muito rapidamente, e seu ambiente do VMware Cloud Director poderá ficar sem espaço em disco.

Os logs do VMware Cloud Director estão localizados no diretório /opt/vmware/vcloud-director/logs/.

O arquivo de configuração de log do VMware Cloud Director está localizado no diretório /opt/vmware/vcloud-director/etc/. O nome do arquivo de configuração de log é log4j.properties.

Se você personalizar o arquivo de configuração de log log4j.properties, antes de uma atualização do VMware Cloud Director, deverá fazer uma cópia de log4j.properties e, após a atualização, inserir manualmente as seções ausentes.

Para melhorar a retenção de logs e garantir que os logs do VMware Cloud Director sejam mantidos por um determinado período de tempo, considere o uso de um servidor syslog.

Tabela 1. Níveis de log
Nível de log Descrição
FATAL Esse nível registra eventos de erro muito graves que podem causar falha no aplicativo.
ERROR Este nível registra eventos de erro que ainda podem permitir que o aplicativo continue em execução.
WARN Esse nível registra situações e avisos potencialmente perigosos.
INFO Esse nível registra mensagens informativas que destacam o progresso do aplicativo em um nível mais detalhado.
DEBUG Esse nível registra eventos informativos mais úteis para depurar um aplicativo em um nível refinado.
TRACE Esse nível registra eventos informativos em um nível mais refinado do que o registro de nível DEBUG.

Pré-requisitos

Faça uma cópia de backup do arquivo /opt/vmware/vcloud-director/etc/log4j.properties.

Considere

Procedimento

  1. Faça login diretamente ou usando um cliente SSH no console do VMware Cloud Director como raiz.
  2. Abra o arquivo /opt/vmware/vcloud-director/etc/log4j.properties em um editor de texto.
  3. Localize a definição do arquivo de log que você deseja atualizar. 
    log4j.appender.Feature.File=logs/File_Name
    Por exemplo, talvez você queira alterar o nível de log da seção # Component appender for container debug. A última linha da seção configura o nível de log que o arquivo captura.
  4. Defina o nível de log como o valor desejado.
    Importante: Certifique-se de estar ciente das consequências para o seu grupo de servidores do VMware Cloud Director ao fazer alterações na configuração de logs sem orientação da equipe de Suporte Global da VMware.
    TRACE é o nível mais detalhado e FATAL, o menos detalhado. O exemplo a seguir altera a linha para corresponder ao nível mais detalhado. 
    log4j.appender.vcloud.system.debug.threshold=TRACE
  5. Se você alterar a gravação para um nível mais detalhado; talvez seja necessário aumentar o número de backups de log e o tamanho dos arquivos de log.
    1. Localize as linhas MaxFileSize e MaxBackupIndex. 
      log4j.appender.vcloud.system.debug.MaxFileSize=
      log4j.appender.vcloud.system.debug.MaxBackupIndex=
    2. Altere as configurações padrão.
      Por exemplo, se quiser que os arquivos de log se expandam para 50 MB antes de serem transferidos e manter os últimos 18 logs, altere as linhas da seguinte forma. 
      log4j.appender.vcloud.system.debug.MaxFileSize=50000KB
      log4j.appender.vcloud.system.debug.MaxBackupIndex=18
      Quando um arquivo atingir o tamanho selecionado de 50 MB, o VMware Cloud Director continuará registrando dados em um novo arquivo e manterá até 18 backups.
    Importante: Se você alterar um nível de log para um mais detalhado, os logs poderão começar a se expandir muito rapidamente, e seu ambiente do VMware Cloud Director poderá ficar sem espaço em disco.
  6. Salve o arquivo /opt/vmware/vcloud-director/etc/log4j.properties.
    O VMware Cloud Director aplica as alterações imediatamente. O arquivo Log4J.properties não tem linhas explícitas para alterar o tamanho e a quantidade de logs que o VMware Cloud Director mantém.