Index

wrapper.logfile

Compatibilité :1.0.0
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community
Plateformes :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Définit le chemin du fichier journal dans lequel toutes les sorties du Wrapper et de l'application Java seront enregistrées.

Exemple (« wrapper.log ») :
wrapper.logfile=../logs/wrapper.log

Pour plus d'informations sur le « mode de rotation du fichier journal », le « format de sortie du fichier journal » et le « niveau de journalisation du fichier journal », veuillez consulter la description de chaque propriété.

Valeur par défaut :

Si cette propriété est absente, ou si le Wrapper n'est pas en mesure d'écrire à l'emplacement spécifié (par exemple en raison d'un problème de permissions), les messages seront alors enregistrés dans un fichier journal par défaut nommé « wrapper.log » dans le répertoire de travail. À défaut, la sortie vers le fichier journal sera désactivée et la journalisation ne se poursuivra que dans la console, syslog ou EventLog.

À partir de la version 3.5.30, le Wrapper est capable de reprendre la journalisation dans le fichier journal lorsque celui-ci redevient disponible.

Le diagramme suivant représente les mécanismes de repli et de reprise :


Désactivation de la journalisation :

Définir la propriété avec une valeur vide désactive la journalisation dans un fichier.

Exemple de propriété :
wrapper.logfile=

NOTE

Dans les versions 3.5.31 à 3.5.34, le Wrapper contient un bogue qui entraîne l'utilisation du fichier journal par défaut au lieu de désactiver la journalisation dans un fichier lorsqu'une valeur vide est spécifiée. Une meilleure pratique pour désactiver la sortie vers le fichier journal, et qui fonctionne avec toutes les versions du Wrapper postérieures à 2.2.5, consiste à définir wrapper.logfile.loglevel sur NONE.

Nom du fichier journal généré par des jetons :

Le nom de fichier journal spécifié peut contenir l'un des jetons suivants, ou les deux : ROLLNUM et YYYYMMDD.

Jeton « ROLLNUM » :

Le jeton ROLLNUM est utilisé lors de la rotation du fichier journal. Si le format est « wrapper.log.ROLLNUM », le jeton « ROLLNUM » est replaced par un entier, et les numéros de rotation sont alors ajoutés à la fin du nom de fichier « wrapper.log ».

Plus le numéro de rotation est élevé, plus le fichier est ancien. Le fichier journal ayant subi une rotation le plus récemment aura toujours le numéro de rotation « 1 », c'est-à-dire « wrapper.log.1 ». Le deuxième plus récent sera « wrapper.log.2 ».

Lorsque la propriété wrapper.logfile.rollmode spécifie un mode de rotation, si un jeton ROLLNUM n'est pas inclus dans le nom de fichier journal spécifié, ".ROLLNUM" sera ajouté à la fin par défaut.

Exemples avec le jeton ROLLNUM :
wrapper.logfile=../logs/wrapper.log.ROLLNUM
wrapper.logfile=../logs/wrapper-ROLLNUM.log

Jeton « YYYYMMDD » :

Le jeton YYYYMMDD est requis lorsque la propriété wrapper.logfile.rollmode a la valeur DATE. Le jeton « YYYYMMDD » sera remplacé par la date des entrées de journal contenues dans le fichier.

Exemples avec le jeton YYYYMMDD :
wrapper.logfile=../logs/wrapper.YYYYMMDD.log
wrapper.logfile=../logs/wrapper-YYYYMMDD.log
wrapper.logfile=../logs/wrapper_YYYYMMDD.log

Suppression des jetons :

Chaque fois qu'un jeton ne s'applique pas à un format de nom de fichier donné, il est retiré du nom de fichier généré. Lorsqu'une partie de jeton est retirée, le caractère précédent est également retiré s'il s'agit d'un « . », « - » ou « _ ».

wrapper.logfile.group

Compatibilité :3.5.38
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community
Plateformes :Windows (Non pris en charge)Mac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Vous pouvez définir le « groupe » pour ce fichier. Consultez la propriété wrapper.*.group.

Exemple :
wrapper.logfile.group=jenkins

wrapper.logfile.umask

Compatibilité :3.2.0
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community
Plateformes :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Vous pouvez définir « umask » pour ce fichier. Consultez la propriété wrapper.*.umask.

Exemple :
wrapper.logfile.umask=0022

Référence : fichier journal