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

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.

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

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

Le formateur de journalisation utilisé par ce log handler.

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

Le niveau maximum de messages de journalisation que le log handler enregistre.

L'identifiant unique de ce log handler.

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.

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.

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.

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.

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 de journalisation sera créé au redémarrage du serveur. La valeur par défaut est false.

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.