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 FATAL es el nivel menos detallado. 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 TRACE es el nivel más detallado. 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 sección Default vCloud loggers y modifique el nivel de registro de los registradores.
    El siguiente ejemplo muestra el nivel de registro establecido en el nivel más detallado.
    log4j.logger.com.vmware.vcloud=TRACE 
    log4j.logger.com.vmware.ssdc=TRACE
  4. 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.
  5. 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.
    El siguiente ejemplo cambia la línea para que se aplique el nivel más detallado.
    log4j.appender.vcloud.system.debug.threshold=TRACE
  6. 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.
  7. 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.

Controlar el registro de solicitudes de API en VMware Cloud Director

Es posible controlar el proceso de captura y almacenamiento de información sobre las solicitudes entrantes en VMware Cloud Director.

VMware Cloud Director registra las solicitudes entrantes en las celdas de VMware Cloud Director en los registros de solicitud. Los nombres de los registros tienen el formato AAAA_MM_DD.request.log. Puede encontrar los archivos VMware Cloud Director request.log en el directorio /opt/vmware/vcloud-director/logs/, pero no puede configurar los registros a través del archivo log4j.properties.

El subcomando manage-config de la herramienta de línea de comandos se puede utilizar para controlar el registro de solicitudes de la API. El subcomando manage-config cambia la configuración de todo el grupo de servidores. Para obtener más información sobre las opciones y los argumentos del subcomando manage-config, consulte Actualizar las opciones de configuración de la aplicación en VMware Cloud Director.

La rotación de registros puede producirse una vez al día como máximo y no está vinculada al tamaño de los archivos de registro individuales ni al tamaño total de todos los archivos de registro. Si desea controlar la directiva de rotación, cambie la cantidad de días durante los cuales VMware Cloud Director mantiene los registros.

Procedimiento

  1. Inicie sesión directamente o mediante un cliente SSH en el SO de celda de VMware Cloud Director como raíz.
  2. Si desea cambiar la directiva de retención de los registros de solicitud, utilice el subcomando manage-config de la herramienta de administración de celdas.
    El valor de la directiva de retención representa el número de días durante los cuales VMware Cloud Director conserva el registro de solicitudes conforme al National Center for Supercomputing Applications (NCSA). El valor predeterminado es 0, donde 0 significa para siempre. Al eliminar el valor también se mantienen los registros para siempre. La cantidad de tiempo más pequeña que se pueden conservar los registros es de 1 día.
    /opt/vmware/vcloud-director/bin/cell-management-tool manage-config --name "vcloud.http.log.retainDays" --value New_Value
  3. Para que los cambios surtan efecto, debe reiniciar las celdas.
    Después de reiniciar una celda, esta comienza a utilizar el valor actualizado. Puede reiniciar parte de las celdas o todas a la vez.