VMware Cloud Director tiene distintos niveles de registro. Es posible que la configuración de registro predeterminada no sea suficiente para entornos muy cargados o para capturar eventos durante la solución de problemas. Es posible que deba cambiar el nivel de registro e incluso el tamaño y la cantidad de archivos retenidos.

Importante: Compruebe que conoce las consecuencias para su grupo de servidores de VMware Cloud Director al realizar cambios en la configuración del registro sin la orientación del equipo de soporte global de VMware. Si cambia un nivel de registro a otro más detallado, es posible que los registros comiencen a crecer muy deprisa y que su entorno de VMware Cloud Director se quede sin espacio de disco.

Los registros de VMware Cloud Director se encuentran en el directorio /opt/vmware/vcloud-director/logs/.

El archivo de configuración de registro de VMware Cloud Director se encuentra en el directorio /opt/vmware/vcloud-director/etc/. El nombre del archivo de configuración del registro es log4j.properties.

Si personaliza el archivo de configuración de registro de log4j.properties antes de una actualización de VMware Cloud Director, debe realizar una copia de log4j.properties y, después de la actualización, insertar manualmente las secciones que falten.

Para mejorar la retención de registros y garantizar que los registros de VMware Cloud Director se mantengan durante un tiempo determinado, considere la posibilidad de usar un servidor syslog.

Tabla 1. Niveles de registro
Nivel de registro Descripción
FATAL Este nivel registra los eventos de error muy graves que pueden hacer que la aplicación falle.
ERROR Este nivel registra eventos de error que aún podrían permitir que la aplicación siga ejecutándose.
WARN Este nivel registra las situaciones y las advertencias potencialmente dañinas.
INFO Este nivel registra mensajes informativos que resaltan el progreso de la aplicación en un nivel grueso.
DEBUG Este nivel registra los eventos informativos que son más útiles para depurar una aplicación en un nivel detallado.
TRACE Este nivel registra los eventos informativos a un nivel más detallado que el registro de nivel DEBUG.

Requisitos previos

Realice una copia de seguridad del archivo /opt/vmware/vcloud-director/etc/log4j.properties.

Considerar

Procedimiento

  1. Inicie sesión directamente o utilice un cliente SSH en la consola de VMware Cloud Director como raíz.
  2. Abra el archivo /opt/vmware/vcloud-director/etc/log4j.properties en un editor de texto.
  3. Busque la definición del archivo de registro que desea actualizar. 
    log4j.appender.Feature.File=logs/File_Name
    Por ejemplo, es posible que desee cambiar el nivel de registro para la sección # Component appender for container debug. La última línea de la sección configura el nivel de registro que captura el archivo.
  4. Establezca el nivel de registro en el valor que desee.
    Importante: Compruebe que conoce las consecuencias para su grupo de servidores de VMware Cloud Director al realizar cambios en la configuración del registro sin la orientación del equipo de soporte global de VMware.
    TRACE es el nivel más detallado y FATAL es el menos detallado. El siguiente ejemplo cambia la línea para que se aplique el nivel más detallado. 
    log4j.appender.vcloud.system.debug.threshold=TRACE
  5. Si cambia la grabación a un nivel más detallado, es posible que deba aumentar el número de copias de seguridad del registro y el tamaño de los archivos de registro.
    1. Busque las líneas MaxFileSize y MaxBackupIndex. 
      log4j.appender.vcloud.system.debug.MaxFileSize=
      log4j.appender.vcloud.system.debug.MaxBackupIndex=
    2. Cambie la configuración predeterminada.
      Por ejemplo, si desea que los archivos de registro se crezcan hasta 50 MB antes de que sean sustituidos y conservar los 18 registros últimos, cambie las líneas de la siguiente manera. 
      log4j.appender.vcloud.system.debug.MaxFileSize=50000KB
      log4j.appender.vcloud.system.debug.MaxBackupIndex=18
      Cuando un archivo alcanza el tamaño seleccionado de 50 MB, VMware Cloud Director continúa registrando datos en un archivo nuevo y mantiene hasta 18 copias de seguridad.
    Importante: Si cambia un nivel de registro a otro más detallado, es posible que los registros comiencen a crecer muy deprisa y que su entorno de VMware Cloud Director se quede sin espacio de disco.
  6. Guarde el archivo /opt/vmware/vcloud-director/etc/log4j.properties.
    VMware Cloud Director aplica los cambios inmediatamente. El archivo Log4J.properties no tiene líneas explícitas para cambiar el tamaño y la cantidad de registros que guarda VMware Cloud Director.