Index

wrapper.logfile.purge.pattern
Compatibilité :3.3.8
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community
Plateformes :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

AVERTISSEMENT

Sauf si vous suivez l'un des exemples d'utilisation spécifiques ci-dessous, vous ne voudrez très probablement PAS utiliser cette propriété. Soyez prudent si vous le faites, car il est tout à fait possible de supprimer des fichiers autres que des fichiers journaux si vous n'êtes pas attentif.

Cette propriété contrôle le motif de fichier pour purger les anciens fichiers journaux. Chaque fois que le fichier journal fait l'objet d'une rotation et qu'un nouveau fichier journal est généré, tous les fichiers correspondant au motif spécifié seront sélectionnés et triés en utilisant le mode de tri. Tous les fichiers disponibles seront interrogés et triés selon le mode spécifié, et les fichiers qui dépassent le nombre maximum de fichiers journaux seront supprimés.

Le motif et le tri ne seront disponibles que lorsque le nombre maximum de fichiers journaux a été défini à une valeur non nulle.

Exemple : 
wrapper.logfile.purge.pattern=../logs/wrapper-*.log*

Exemple d'utilisation : Fichiers journaux incluant le PID du Wrapper

Certains utilisateurs ont demandé la possibilité d'inclure le PID du Wrapper dans le fichier journal afin de pouvoir exécuter plus d'une instance du Wrapper à partir du même répertoire.

Exemple de configuration : 
wrapper.logfile=../logs/wrapper-%WRAPPER_PID%.log
wrapper.logfile.purge.pattern=../logs/wrapper-*.log*
wrapper.logfile.purge.sort=TIMES
wrapper.logfile.rollmode=SIZE_OR_JVM
wrapper.logfile.maxsize=10m
wrapper.logfile.maxfiles=10

Chacune des propriétés de l'exemple a été utilisée comme suit :

  • wrapper.logfile :

    Selon le paramètre de fichier journal, les fichiers journaux seront générés avec des noms de fichiers incluant le PID du Wrapper.

  • wrapper.logfile.purge.pattern :

    Le motif de purge des fichiers est spécifié ici. Dans cet exemple, seuls les fichiers dont les noms incluent 'wrapper-' et '.log' seront purgés.

  • wrapper.logfile.purge.sort :

    Comme les PID inclus dans les noms de fichiers ne sont pas séquentiels, un tri par nom ne donnerait pas le résultat attendu. Les fichiers journaux sont donc triés par leur date de modification (TIMES).

  • wrapper.logfile.rollmode :

    Selon le mode de rotation (SIZE_OR_JVM), les fichiers journaux feront automatiquement l'objet d'une rotation chaque fois que la JVM est redémarrée ou que la taille du fichier journal atteint la taille maximale. Lorsque le fichier journal fait l'objet d'une rotation, « .1 » et « .2 » seront ajoutés par le jeton « ROLLNUM ».

  • wrapper.logfile.maxsize :

    La taille maximale des fichiers journaux est définie à « 10 Mo ».

  • wrapper.logfile.maxfiles :

    Le nombre maximum de fichiers ayant fait l'objet d'une rotation est défini à « 10 ». Un maximum de 10 fichiers sera conservé en plus du fichier actuel.

Voici une liste de fichiers qui pourraient exister, présentés dans leur ordre de tri basé sur la date de modification (.purge.sort=TIMES). Notez que les PID ne sont pas séquentiels par rapport au temps.

Exemple de fichiers journaux : 
wrapper-31832.log  (Current file)
wrapper-31832.log.1
wrapper-31832.log.2
wrapper-8643.log
wrapper-13062.log
wrapper-13062.log.1
wrapper-13062.log.2
wrapper-13062.log.3
wrapper-11523.log
wrapper-11523.log.1
wrapper-11523.log.2 (Oldest file)

Exemple d'utilisation : Fichiers journaux incluant l'heure de démarrage du Wrapper

Il est également possible de créer des fichiers journaux dont les noms incluent l'heure de démarrage du Wrapper.

L'exemple suivant générera des fichiers journaux incluant l'heure de démarrage du Wrapper. Ces fichiers peuvent être triés par leurs noms plutôt que par leurs dates de modification. Le seul avantage d'utiliser les noms plutôt que les dates est que les fichiers seront conservés correctement même s'ils sont modifiés.

Exemple de configuration : 
wrapper.logfile=../logs/wrapper-%WRAPPER_TIME_YYYYMMDDHHIISS%-YYYYMMDD.log
wrapper.logfile.purge.pattern=../logs/wrapper-*-*.log
wrapper.logfile.purge.sort=NAMES_DEC
wrapper.logfile.rollmode=DATE
wrapper.logfile.maxfiles=10

Chacune des propriétés de l'exemple a été utilisée comme suit :

Voici une liste de fichiers qui pourraient exister, présentés dans leur ordre de tri basé sur la date (.purge.sort=NAMES_DEC). Notez que les PID ne sont pas séquentiels par rapport au temps.

Exemple de fichiers journaux : 
wrapper-20091020142321-20091025.log (Current file)
wrapper-20091020142321-20091024.log
wrapper-20091020142321-20091023.log
wrapper-20091020142321-20091022.log
wrapper-20091020142321-20091021.log
wrapper-20091020142321-20091020.log
wrapper-20091001123545-20091020.log
wrapper-20091001123545-20091019.log
wrapper-20091001123545-20091018.log
wrapper-20091001123545-20091017.log
wrapper-20091001123545-20091016.log (Oldest file)

Référence : fichier journal
  • wrapper.log.lf_delay.threshold (3.5.10)

    Définit un seuil pour scinder les messages JVM trop longs pour être affichés en une seule fois.

  • wrapper.log.warning.threshold (3.5.8)

    Affiche un avertissement lorsqu'une entrée de journal met plus de temps à être imprimée que le nombre de secondes spécifié.

  • wrapper.logfile (1.0.0)

    Définit le chemin du fichier journal du Wrapper.

  • wrapper.logfile.close.timeout (3.5.21)

    Contrôle le nombre de secondes au bout desquelles le fichier journal doit se fermer après la dernière entrée de journal.

  • wrapper.logfile.flush.timeout (3.5.21)

    Configure l'intervalle en secondes auquel le Wrapper vide toutes les sorties vers le fichier journal.

  • wrapper.logfile.format (2.2.5)

    Configure le format des sorties envoyées au fichier journal.

  • wrapper.logfile.inactivity.timeout (3.2.0)

    Contrôle le nombre de secondes au bout desquelles le fichier journal doit se fermer après la dernière entrée de journal.

  • wrapper.logfile.loglevel (2.2.5)

    Filtre les messages envoyés au fichier journal selon leur niveau de journalisation.

  • wrapper.logfile.maxfiles (2.2.5)

    Contrôle le nombre maximal de fichiers de rotation.

  • wrapper.logfile.maxsize (2.2.5)

    Contrôle la taille maximale des fichiers de rotation.

  • wrapper.logfile.purge.pattern (3.3.8)

    Contrôle le motif de fichier pour purger les anciens fichiers journaux.

  • wrapper.logfile.purge.sort (3.3.8)

    Configure le mode de tri des fichiers de rotation afin de purger les derniers.

  • wrapper.logfile.rollmode (3.2.0)

    Définit le mode de rotation du fichier journal.