wrapper.logfile.rollmode

Compatibilidad :3.2.0
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad
Plataformas :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Esta propiedad controla el modo de rotación del archivo de registro. Consulte la propiedad wrapper.logfile para una explicación de cómo nombrar el archivo de registro.

El valor predeterminado es SIZE.

Ejemplo:
wrapper.logfile.rollmode=SIZE

A partir de la versión 3.5.37, es posible rotar el archivo de registro por fecha en combinación con cualquiera de los modos enumerados a continuación. Esto se puede hacer incluyendo el token "YYYYMMDD" en el valor de wrapper.logfile.

Al rotar por fecha, cada entrada de registro se escribe en un archivo cuyo nombre contiene una fecha correspondiente a su marca de tiempo. Cada vez que cambia la fecha, se comenzará a registrar en un nuevo archivo de registro. Esto tiene la ventaja de agrupar todas las entradas de registro de un día determinado en un archivo específico. No se creará un archivo en los días que no tengan ninguna salida de registro.

Los valores de modo posibles incluyen:

  • NONE :

    En este modo, el archivo de registro no será rotado por el Wrapper a menos que wrapper.logfile contenga el token "YYYYMMDD".

    En general, es mejor rotar el archivo de registro; de lo contrario, podría crecer indefinidamente y posiblemente agotar todo el espacio disponible en disco si una aplicación produce cantidades muy grandes de salida.

    Sin embargo, hay casos en los que un usuario desearía desactivar la rotación de registros por parte del Wrapper. Un ejemplo es cuando se está utilizando una herramienta externa de rotación de registros.

  • DATE (Alias de NONE desde la versión 3.5.37):

    Antes de la versión 3.5.37, este valor se utilizaba para rotar el archivo de registro por fecha.

  • SIZE :

    En este modo, el archivo de registro se rotará siempre que su tamaño exceda el valor definido por la propiedad wrapper.logfile.maxsize.

  • WRAPPER :

    En este modo, el archivo de registro se rotará cuando el Wrapper se inicie por primera vez. Esta rotación ocurrirá inmediatamente después de que se haya cargado el archivo de configuración. Por esta razón, cualquier problema de configuración se registrará en el archivo antes de que se rote. En este modo WRAPPER, los archivos de registro no tendrán un tamaño máximo y continuarán creciendo hasta que se reinicie el Wrapper.

  • JVM :

    En este modo, el archivo de registro se rotará al iniciar el Wrapper al igual que en el modo WRAPPER. Pero también se rotará justo antes de que se inicien las JVM reiniciadas. En este modo JVM, los archivos de registro no tendrán un tamaño máximo y continuarán creciendo hasta que se reinicie el Wrapper o una JVM.

  • SIZE_OR_WRAPPER :

    Este modo combina los modos SIZE y WRAPPER. El archivo de registro se rotará al iniciar el Wrapper o siempre que el archivo de registro exceda el tamaño máximo configurado.

  • SIZE_OR_JVM :

    Este modo combina los modos SIZE y JVM. El archivo de registro se rotará al iniciar el Wrapper, al reiniciar la JVM o siempre que el archivo de registro exceda el tamaño máximo configurado.

Referencia: Archivo de Registro