Index

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

Cette propriété contrôle la façon dont les fichiers journaux existants sont triés avec la correspondance de motifs pour décider lesquels purger. Elle peut être utilisée en combinaison avec le motif de tri qui a été configuré manuellement uniquement lorsque la propriété wrapper.logfile.maxfiles a été définie.

Les modes de tri valides comprennent :

  • TIMES :

    pour que les fichiers soient triés en fonction de leurs dates de modification. L'ordre sera du plus récent au plus ancien.

  • NAMES_SMART :

    pour que les fichiers soient triés en fonction de leurs noms. Les fichiers seront triés selon les dates et les numéros de rotation inclus dans leurs noms.

  • NAMES_ASC (obsolète depuis 3.5.37) :

    pour que les fichiers soient triés en fonction de leurs noms. L'ordre sera croissant. Les nombres dans les noms sont traités comme des nombres et seront triés en conséquence.

  • NAMES_DEC (obsolète depuis 3.5.37) :

    pour que les fichiers soient triés en fonction de leurs noms. L'ordre sera décroissant. Les nombres dans les noms sont traités comme des nombres et seront triés en conséquence.

La valeur par défaut est NAMES_SMART. Avant la version 3.5.37, la valeur par défaut était TIMES (sauf lors de la rotation par date où NAMES_DEC était utilisé).

Exemple : 
wrapper.logfile.purge.sort=TIMES

Exemple d'utilisation des modes de tri :

Pour clarifier un peu chaque mode, veuillez consulter les exemples suivants. Dans tous les cas, les fichiers sont triés comme expliqué ci-dessus. Les N premiers fichiers seront conservés, où N est la valeur de la propriété wrapper.logfile.maxfiles. Tous les fichiers restants seront purgés.

Voici la liste des fichiers utilisés dans les exemples suivants. La liste suivante de 5 fichiers journaux Wrapper a été générée en utilisant le jeton ROLLNUM dans le nom du fichier journal et le mode de rotation SIZE.

Liste des fichiers journaux : 
logs/wrapper.log.1  (2009-12-29 22:59:40)
logs/wrapper.log.2  (2009-12-29 05:45:35)
logs/wrapper.log.3  (2009-12-27 15:23:18)
logs/wrapper.log.4  (2009-12-27 10:00:00)
logs/wrapper.log.5  (2009-12-26 10:55:03)

Après la génération des fichiers, quelqu'un a modifié le fichier journal « wrapper.log.4 », ce qui a entraîné le report de sa date de modification à une valeur ultérieure.

Modification de wrapper.log.4 : 
logs/wrapper.log.1  (2009-12-29 22:59:40)
logs/wrapper.log.2  (2009-12-29 05:45:35)
logs/wrapper.log.3  (2009-12-27 15:23:18)
logs/wrapper.log.4  (2009-12-30 10:00:00)  <- Modified file
logs/wrapper.log.5  (2009-12-26 10:55:03)

  • TIMES :

    Les fichiers journaux sont triés du plus ancien au plus récent en utilisant la date de modification des fichiers.

    Fichiers triés par date : 
    logs/wrapper.log.4  (2009-12-30 10:00:00)
logs/wrapper.log.1  (2009-12-29 22:59:40)
logs/wrapper.log.2  (2009-12-29 05:45:35)
logs/wrapper.log.3  (2009-12-27 15:23:18)
logs/wrapper.log.5  (2009-12-26 10:55:03)

    Si la propriété wrapper.logfile.maxfiles est définie à 3, alors les fichiers suivants resteront après la purge :

    Fichiers conservés : 
    logs/wrapper.log.4  (2009-12-30 10:00:00)
logs/wrapper.log.1  (2009-12-29 22:59:40)
logs/wrapper.log.2  (2009-12-29 05:45:35)

  • NAMES_SMART :

    Les fichiers journaux sont triés en fonction de leurs noms en tenant compte de la date et de l'index qu'ils contiennent. L'ordre de tri sera par dates décroissantes et numéros de rotation croissants, afin de garantir que les fichiers les plus anciens seront toujours purgés avant les plus récents.

    Nom de fichier trié par dates et numéros de rotation : 
    logs/wrapper_20181203.log  (Current log file)
logs/wrapper_20181202.log
logs/wrapper_20181202.log.1
logs/wrapper_20181202.log.2
logs/wrapper_20181202.log.3
logs/wrapper_20181201.log

    Si la propriété wrapper.logfile.maxfiles est définie à 3, alors les fichiers suivants resteront après la purge :

    Fichiers conservés : 
    logs/wrapper_20181203.log  (Current log file)
logs/wrapper_20181202.log
logs/wrapper_20181202.log.1
logs/wrapper_20181202.log.2

    NOTE

    Contrairement au mode TIMES, cette méthode n'est pas affectée par les modifications de fichiers.

  • NAMES_ASC (obsolète depuis 3.5.37) :

    AVERTISSEMENT

    L'utilisation de cette valeur est obsolète depuis la version 3.5.37 du Wrapper au profit de NAMES_SMART qui permet de trier les fichiers journaux en tenant compte à la fois des dates et des numéros de rotation inclus dans leurs noms. Pour des raisons de rétrocompatibilité, NAMES_ASC continuera de fonctionner comme auparavant, mais NAMES_SMART devrait toujours être préféré.

    Les fichiers journaux sont triés en fonction de leurs noms par ordre croissant.

    Nom de fichier trié par ordre croissant : 
    logs/wrapper.log.1  (2009-12-29 22:59:40)
logs/wrapper.log.2  (2009-12-29 05:45:35)
logs/wrapper.log.3  (2009-12-27 15:23:18)
logs/wrapper.log.4  (2009-12-30 10:00:00)
logs/wrapper.log.5  (2009-12-26 10:55:03)

    Si la propriété wrapper.logfile.maxfiles est définie à 3, alors les fichiers suivants resteront après la purge :

    Fichiers conservés : 
    logs/wrapper.log.1  (2009-12-29 22:59:40)
logs/wrapper.log.2  (2009-12-29 05:45:35)
logs/wrapper.log.3  (2009-12-27 15:23:18)

  • NAMES_DEC (obsolète depuis 3.5.37) :

    AVERTISSEMENT

    L'utilisation de cette valeur est obsolète depuis la version 3.5.37 du Wrapper au profit de NAMES_SMART qui permet de trier les fichiers journaux en tenant compte à la fois des dates et des numéros de rotation inclus dans leurs noms. Pour des raisons de rétrocompatibilité, NAMES_DEC continuera de fonctionner comme auparavant, mais NAMES_SMART devrait toujours être préféré.

    Les fichiers journaux sont triés en fonction de leurs noms par ordre décroissant.

    Le mode de tri NAMES_DEC n'a que peu de sens lors du tri de fichiers contenant uniquement un numéro de rotation. Il est plus couramment utilisé avec des noms de fichiers contenant des dates ou des horodatages, car ces fichiers doivent être triés par ordre décroissant pour purger les fichiers les plus anciens :

    Liste des fichiers journaux (utilisation efficace de l'ordre décroissant) : 
    logs/wrapper-20091230.log  (Current log file)
logs/wrapper-20091229.log
logs/wrapper-20091228.log
logs/wrapper-20091227.log
logs/wrapper-20091226.log
logs/wrapper-20091225.log

    Si la propriété wrapper.logfile.maxfiles est définie à 3, alors les fichiers suivants resteront après la purge :

    Fichiers conservés : 
    logs/wrapper-20091230.log  (Current log file)
logs/wrapper-20091229.log
logs/wrapper-20091228.log
logs/wrapper-20091227.log

Référence : fichier journal