Índice

wrapper.logfile

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

Establece la ruta del archivo de registro donde se registrará toda la salida del Wrapper y de la aplicación Java.

Ejemplo ("wrapper.log"):
wrapper.logfile=../logs/wrapper.log

Para más información sobre el "modo de rotación del archivo de registro", el "formato de salida del archivo de registro" y el "nivel de registro del archivo de registro", consulte la descripción de cada propiedad.

Predeterminado:

Si esta propiedad está ausente, o si el Wrapper no puede escribir en la ubicación especificada (por ejemplo, debido a un problema de permisos), los mensajes se registrarán en un archivo de registro predeterminado llamado "wrapper.log" en el directorio de trabajo. Si esto también falla, la salida al archivo de registro se deshabilitará y el registro solo continuará en la consola, syslog o EventLog.

A partir de la versión 3.5.30, el Wrapper tiene la capacidad de reanudar el registro en el archivo de registro cuando vuelve a estar disponible.

El siguiente diagrama representa los mecanismos de respaldo y reanudación:


Deshabilitación del registro:

Establecer la propiedad en un valor en blanco deshabilitará el registro en archivo.

Ejemplo de propiedad:
wrapper.logfile=

NOTA

En las versiones 3.5.31 a 3.5.34, el Wrapper contiene un error que provoca que se utilice el archivo de registro predeterminado en lugar de deshabilitar el registro en archivo cuando se especifica un valor en blanco. Una mejor práctica para deshabilitar la salida al archivo de registro, y que funciona con todas las versiones del Wrapper posteriores a 2.2.5, es establecer wrapper.logfile.loglevel en NONE.

Nombre del archivo de registro generado por tokens:

El nombre del archivo de registro especificado puede contener uno o ambos tokens; ROLLNUM y YYYYMMDD.

Token "ROLLNUM":

El token ROLLNUM se usa cuando se rota el archivo de registro. Si el formato es "wrapper.log.ROLLNUM", el token "ROLLNUM" se reemplaza por un entero, y entonces los números de rotación se añadirán al final del nombre de archivo "wrapper.log".

Cuanto mayores sean los valores del número de rotación, más antiguos serán los archivos. El archivo de registro rotado más reciente siempre tendrá un número de rotación de "1", que es "wrapper.log.1". El segundo más reciente será "wrapper.log.2".

Cuando la propiedad wrapper.logfile.rollmode tiene un modo de rotación, si no se incluye un token ROLLNUM en el archivo de registro especificado, se añadirá ".ROLLNUM" al final de forma predeterminada.

Ejemplos con el token ROLLNUM:
wrapper.logfile=../logs/wrapper.log.ROLLNUM
wrapper.logfile=../logs/wrapper-ROLLNUM.log

Token "YYYYMMDD":

El token YYYYMMDD es necesario cuando la propiedad wrapper.logfile.rollmode tiene un valor de DATE. El token "YYYYMMDD" se reemplazará por la fecha de las entradas de registro contenidas en el archivo.

Ejemplos con el token YYYYMMDD:
wrapper.logfile=../logs/wrapper.YYYYMMDD.log
wrapper.logfile=../logs/wrapper-YYYYMMDD.log
wrapper.logfile=../logs/wrapper_YYYYMMDD.log

Eliminación de tokens:

Siempre que alguno de los tokens no se aplique a un formato de nombre de archivo determinado, se eliminará del nombre de archivo generado. Cuando se elimina una parte de un token, el carácter precedente también se eliminará si es ".", "-" o "_".

wrapper.logfile.group

Compatibilidad :3.5.38
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad
Plataformas :Windows (No Compatible)Mac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Puede establecer el "grupo" para este archivo. Consulte la propiedad wrapper.*.group.

Ejemplo:
wrapper.logfile.group=jenkins

wrapper.logfile.umask

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

Puede establecer el "umask" en este archivo. Consulte la propiedad wrapper.*.umask.

Ejemplo:
wrapper.logfile.umask=0022

Referencia: Archivo de Registro