Red Hat Training

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

12.6.6. Propriétés de log handlers de taille

Tableau 12.11. Propriétés de log handlers de taille

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.
autoflush Boolean
Si défini sur true, les messages de journalisation seront envoyés vers les gestionnaires immédiatement après la réception.
encoding String
Définir la codification utilisée pour la sortie.
formatter String
Le formateur de journalisation utilisé par ce log handler.
named-formatter String
Le nom du formateur défini à utiliser avec le gestionnaire
level String
Le niveau maximum de messages de journalisation que le log handler enregistre.
name String
L'identifiant unique de ce log handler.
file Object
L'objet qui représente le fichier dans lequel la sortie de ce log handler 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.
rotate-size Integer
La taille maximale que le fichier journal peut atteindre avant qu'il soit mis en rotation. Un seul caractère ajouté au nombre indique les unités de taille : b pour bytes, k pour kilobytes, m pour megabytes, g pour gigabytes. Par ex. 50m pour 50 megabytes.
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.
Disponible à partir de JBoss EAP 6.4. 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.
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 de journalisation sera créé au redémarrage du serveur. La valeur par défaut est false.
suffix String
Disponible à partir de JBoss EAP 6.4. Ce string est inclus dans le suffixe ajouté aux fichiers de journaux en rotation. Le format du suffix est avec un (.) suivi d'un string de date qui peut être traité par la classe SimpleDateFormat
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 1 October 2014 se nommerait server.log.2014-10-1. Dans cet exemple, la portion 2014-10 du suffixe dérive de la valeur de suffix.