12.6.7. Propriétés de gestionnaires de journaux périodiques

Si la valeur est définie sur true, alors tous les messages rédigés par ce gestionnaire seront ajoutés au fichier si celui-ci existe déjà. Si la valeur est false, un nouveau fichier sera créé chaque fois que le serveur d'applications est lancé. Les modifications à «append» (ajout) nécessitent un redémarrage du serveur pour qu'elles soient prises en compte.

La taille maximale que le fichier journal peut atteindre avant qu'il soit mis en rotation.

Le nombre maximum de journaux en rotation conservés. Quand ce nombre est atteint, le journal le plus ancien est utilisé à nouveau. Valeur par défaut : 1.

Si l'attribut suffix est utilisé, le suffixe des fichiers de journaux en rotation sera inclus dans l'algorithme de rotation. Quand le fichier journal est mis en rotation, le fichier le plus ancien dont le nom commence par name+suffix est supprimé, les fichiers journal en rotation restant auront leur suffixe numérique incrémenté et le nouveau fichier journal en rotation recevra le suffixe 1.

Considérons que nous ayons le nom de fichier journal server.log, un suffixe ayant pour valeur .YYYY-mm, et un max-backup-index de valeur 3. Quand le fichier journal aura été mis en rotation deux fois, les noms de fichier pourront être server.log, server.log.2014-10.1 et server.log.2014-10.2. La prochaine fois que le fichier est mis en rotation, le fichier server.log.2014-10.2 sera supprimé, server.log.2014-10.1 sera renommée server.log.2014-10.2 et le fichier journal nouvellement mis en rotation sera nommé server.log.2014-10.1.

Cette chaîne est ajoutée au nom de fichier des journaux en rotation et sert à déterminer la fréquence de rotation. Le format du suffixe est un point (.) suivi d'une chaîne date String qui puisse être interprétée par SimpleDateFormat . Le journal est mis en rotation sur la base de la plus petite unité de temps définie par le suffixe. Notez que la plus petite unité de temps atourisée pour l'attribut suffixe est la minute.

Par exemple, une valeur de suffixe de .YYYY-MM-dd résultera en une rotation de journal quotidienne. Considérons que vous ayiez un fichier journal server.log et un suffixe ayant comme valeur .YYYY-MM-dd, le fichier journal mis en rotation le 20 October 2014 se nommerait server.log.2014-10-19. Avec un gestionnaire de journal périodique, le suffixe inclut la valeur précédente de plus petite unité de temps. Dans cet exemple, la valeur de dd est 19, le jour précédent.

Si défini sur true, les messages de journalisation seront envoyés vers les gestionnaires immédiatement après la réception.

L'objet qui représente le fichier dans lequel la sortie de ce gestionnaire de journal est écrite. Il contient deux propriétés de configuration, relative-to et path.

C'est une propriété de l'objet fichier qui correspond au répertoire où le fichier journal est écrit. Les variables de chemin d'accès peuvent être indiquées ici. La variable jboss.server.log.dir pointe vers le répertoire log/ du serveur.

C'est une propriété de l'objet fichier qui correspond au nom du fichier où seront écrits les messages du journal. C'est un nom de chemin d'accès relatif qui est ajouté à la valeur de la propriété relative-to pour déterminer le chemin d'accès complet.

Si défini sur true, le gestionnaire sera activé et fonctionnera normalement. Si défini sur false, le gestionnaire sera ignoré lors du traitement des messages de journalisation.

Expression qui définit un filtre. L'expression suivante définit un filtre qui ne correspond pas à un modèle : not(match("JBAS.*"))

Si la valeur est true, un nouveau fichier journal sera créé au redémarrage du serveur. La valeur par défaut est false.

Le formateur de journalisation utilisé par ce gestionnaire de journal.

Le niveau minimum de messages de journalisation que le gestionnaire de journal enregistre.

L'identifiant unique de ce gestionnaire de journal.

Le nom du formateur défini à utiliser avec le gestionnaire

Définir la codification utilisée pour la sortie.