Red Hat Training

A Red Hat training course is available for Red Hat JBoss Enterprise Application Platform

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

Tableau 12.12. Propriétés des gestionnaires de journaux périodiques en rotation

Propriété Datatype Description
append Boolean
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.
rotate-size String
La taille maximale que le fichier journal peut atteindre avant qu'il soit mis en rotation.
max-backup-index Integer
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.
suffix String
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.
autoflush Boolean
Si défini sur true, les messages de journalisation seront envoyés vers les gestionnaires immédiatement après la réception.
file Object
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.
relative-to String
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.
path String
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.
enabled Boolean
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.
filter-spec String
Expression qui définit un filtre. L'expression suivante définit un filtre qui ne correspond pas à un modèle : not(match("JBAS.*"))
rotate-on-boot Boolean
Si la valeur est true, un nouveau fichier journal sera créé au redémarrage du serveur. La valeur par défaut est false.
formatter String
Le formateur de journalisation utilisé par ce gestionnaire de journal.
level String
Le niveau minimum de messages de journalisation que le gestionnaire de journal enregistre.
name String
L'identifiant unique de ce gestionnaire de journal.
named-formatter String
Le nom du formateur défini à utiliser avec le gestionnaire
encoding String
Définir la codification utilisée pour la sortie.