wrapper.logfile.rollmode

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

Cette propriété contrôle le mode de rotation du fichier journal. Consultez la propriété wrapper.logfile pour une explication sur la façon de nommer le fichier journal.

La valeur par défaut est SIZE.

Exemple :
wrapper.logfile.rollmode=SIZE

À partir de la version 3.5.37, il est possible d'effectuer une rotation du fichier journal par date en combinaison avec n'importe lequel des modes listés ci-dessous. Cela peut être fait en incluant le jeton « YYYYMMDD » dans la valeur de wrapper.logfile.

Lors de la rotation par date, chaque entrée de journal est enregistrée dans un fichier dont le nom contient une date correspondant à son horodatage. Chaque fois que la date change, un nouveau fichier journal commencera à être utilisé. Cela présente l'avantage de regrouper toutes les entrées de journal d'un jour donné dans un fichier spécifique. Aucun fichier ne sera créé les jours sans aucune sortie de journal.

Les valeurs de mode possibles sont :

  • NONE :

    Dans ce mode, le fichier journal ne sera pas soumis à une rotation par le Wrapper, sauf si wrapper.logfile contient le jeton « YYYYMMDD ».

    En général, il est préférable d'effectuer une rotation du fichier journal, sinon celui-ci pourrait croître indéfiniment et éventuellement consommer tout l'espace disque disponible si une application produit de très grandes quantités de sorties.

    Il existe cependant des cas où un utilisateur souhaiterait désactiver la rotation des journaux par le Wrapper. Un exemple est l'utilisation d'un outil externe de rotation des journaux.

  • DATE (Alias de NONE depuis la version 3.5.37) :

    Avant la version 3.5.37, cette valeur était utilisée pour effectuer une rotation du fichier journal par date.

  • SIZE :

    Dans ce mode, le fichier journal sera soumis à une rotation chaque fois que sa taille dépasse la valeur définie par la propriété wrapper.logfile.maxsize.

  • WRAPPER :

    Dans ce mode, le fichier journal sera soumis à une rotation lors du premier lancement du Wrapper. Cette rotation se produira immédiatement après le chargement du fichier de configuration. Pour cette raison, tout problème de configuration sera enregistré dans le fichier avant sa rotation. Dans ce mode WRAPPER, les fichiers journaux n'auront pas de taille maximale et continueront de croître jusqu'au redémarrage du Wrapper.

  • JVM :

    Dans ce mode, le fichier journal sera soumis à une rotation au démarrage du Wrapper comme avec le mode WRAPPER. Mais il sera également soumis à une rotation juste avant le lancement de toute JVM redémarrée. Dans ce mode JVM, les fichiers journaux n'auront pas de taille maximale et continueront de croître jusqu'au redémarrage du Wrapper ou d'une JVM.

  • SIZE_OR_WRAPPER :

    Ce mode combine les modes SIZE et WRAPPER. Le fichier journal sera soumis à une rotation au démarrage du Wrapper ou chaque fois que le fichier journal dépasse la taille maximale configurée.

  • SIZE_OR_JVM :

    Ce mode combine les modes SIZE et JVM. Le fichier journal sera soumis à une rotation au démarrage du Wrapper, au redémarrage de la JVM, ou chaque fois que le fichier journal dépasse la taille maximale configurée.

Référence : fichier journal