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 FATAL é o nível menos detalhado. 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 TRACE é o nível mais detalhado. 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 seção Default vCloud loggers e modifique o nível de log dos loggers.
    O exemplo a seguir mostra o nível de log definido como o nível mais detalhado. 
    log4j.logger.com.vmware.vcloud=TRACE 
log4j.logger.com.vmware.ssdc=TRACE
  4. 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.
  5. 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.
    O exemplo a seguir altera a linha para corresponder ao nível mais detalhado. 
    log4j.appender.vcloud.system.debug.threshold=TRACE
  6. 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.
  7. 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.

Controlar o log de solicitação de API no VMware Cloud Director

Você pode controlar o processo de captura e armazenamento de informações sobre solicitações de entrada no VMware Cloud Director.

O VMware Cloud Director registra as solicitações de entrada para as células do VMware Cloud Director nos logs de solicitação. Os logs têm nomes do formulário AAAA_MM_DD.request.log. Você pode encontrar os arquivos VMware Cloud Director request.log no diretório /opt/vmware/vcloud-director/logs/, mas não pode configurar os logs por meio do arquivo log4j.properties.

Você pode usar o subcomando manage-config da ferramenta de linha de comando para controlar o log de solicitação de API. O subcomando manage-config altera as configurações de todo o grupo de servidores. Para obter mais informações sobre as opções e os argumentos de subcomando manage-config, consulte Atualização de definições de configuração do aplicativo no VMware Cloud Director.

A rotação de log pode acontecer no máximo uma vez por dia e não está vinculada ao tamanho dos arquivos de log individuais ou ao tamanho total de todos os arquivos de log. Você pode controlar a política de rotação alterando a quantidade de dias durante os quais o VMware Cloud Director mantém os logs.

Procedimento

  1. Faça login diretamente ou usando um cliente SSH no sistema operacional da célula do VMware Cloud Director como root.
  2. Se quiser alterar a política de retenção dos logs de solicitação, use o subcomando manage-config da ferramenta de gerenciamento de células.
    O valor da política de retenção representa o número de dias durante os quais o VMware Cloud Director mantém o log de solicitação em conformidade com o Centro Nacional de Aplicativos de Supercomputador (NCSA). O valor padrão é 0, em que 0 significa para sempre. Excluir o valor também mantém os logs para sempre. A menor quantidade de tempo que você pode manter os logs é 1 dia. 
    /opt/vmware/vcloud-director/bin/cell-management-tool manage-config --name "vcloud.http.log.retainDays" --value New_Value
  3. Para que as alterações entrem em vigor. você deve reiniciar as células.
    Depois de reiniciar uma célula, ela começa a usar o valor atualizado. Você pode reiniciar parte das células ou todas as células de uma só vez.