5.1 Liste des filtres

L'enregistreur vous permet de configurer très simplement le filtrage des messages. Pour ce faire, il dispose d'une vingtaine de filtres avec toutes sortes de paramètres. Le tableau ci-dessous montre les plus populaires.

Filtres Description
1 BurstFilter Permet de contrôler la fréquence des messages par seconde pour un niveau de journalisation donné.
2 Filtre composite Vous permet de définir plusieurs filtres séquentiels.
3 DynamicThresholdFilter Vous permet d'activer la journalisation détaillée si certaines informations sont trouvées dans le journal.
4 FiltreCarte Permet de construire une expression logique complexe pour le filtre à partir de plusieurs paramètres.
5 MarqueurFiltre Permet de filtrer les messages par balises, la balise doit d'abord être ajoutée lors de la journalisation des événements.
6 RegexFiltre Vous permet de définir un masque - une expression régulière.
7 Filtre de données structurées Vous permet de filtrer les messages en fonction de la présence de certaines données en eux.
8 ThreadContextMapFilterThreadContextMapFilter Permet de gérer des filtres basés sur des données extraites du contexte du fil en cours.
9 Filtre de seuil Contrôle la journalisation en fonction du niveau de message de journal.
dix Filtre de temps Vous permet d'activer et de désactiver les filtres à des moments précis.
Java university

Ci-dessous, nous ne parlerons que de trois d'entre eux. Vous pouvez en savoir plus sur ces filtres sur leur site officiel .

5.2 Filtre de temps

Le filtre TimeFiltervous permet d'activer et de désactiver les filtres à un certain moment, il dispose de 5 paramètres :

1 commencer Heure de début de journalisation au formatHH:mm:ss
2 fin Heure de déconnexion au formatHH:mm:ss
3 fuseau horaire Définit le fuseau horaire.
4 surMatch Comment se connecter si la condition du filtre est vraie . Peut-être ACCEPT, DENYou NEUTRAL. Par défaut NEUTRAL.
5 onMismatch Comment se connecter si la condition du filtre est fausse . Peut-être ACCEPT, DENYou NEUTRAL. Par défaut NEUTRAL.

Configurons un filtre qui activera la journalisation à 5h du matin et l'éteindra à 5h30 tous les jours. Un exemple avec une configuration de filtre complète est ci-dessous :


    <?xml version="1.0" encoding="UTF-8"?>
    <Configuration status="warn" name="MyApp" packages="">
    <Appenders>
        <RollingFile name="RollingFile" fileName="logs/app.log" filePattern="logs/app-%d{MM-dd-yyyy}.log.gz">
        <TimeFilter start="05:00:00" end="05:30:00" onMatch="ACCEPT" onMismatch="DENY"/>
        <PatternLayout>
            <pattern>%d %p %c{1.} [%t] %m%n</pattern>
        </PatternLayout>
        <TimeBasedTriggeringPolicy />
        </RollingFile>
    </Appenders>
    <Loggers>
        <Root level="error">
        <AppenderRef ref="RollingFile"/>
        </Root>
    </Loggers>
    </Configuration>

5.3 RegexFiltre

Le filtre RegexFiltervous permet de définir un masque (expression régulière) pour filtrer les messages. Ce filtre a 4 paramètres :

1 expression régulière Spécifie une expression régulière - un masque utilisé pour filtrer les messages.HH:mm:ss
2 utiliserRawMsg Le masque est appliqué dans le message avant formatage (true) ou après formatage (false)
3 surMatch Comment se connecter si la condition du filtre est vraie . Peut-être ACCEPT, DENYou NEUTRAL. Par défaut NEUTRAL.
4 onMismatch Comment se connecter si la condition du filtre est fausse . Peut-être ACCEPT, DENYou NEUTRAL. Par défaut NEUTRAL.

Configurons un filtre qui n'autorisera que les messages contenant le mot codegym. Un exemple avec une configuration de filtre complète est ci-dessous :


    <?xml version="1.0" encoding="UTF-8"?>
    <Configuration status="warn" name="MyApp" packages="">
    <Appenders>
        <RollingFile name="RollingFile" fileName="logs/app.log"   filePattern="logs/app-%d{MM-dd-yyyy}.log.gz">
        <RegexFilter regex=".* codegym .*" onMatch="ACCEPT" onMismatch="DENY"/>
        <PatternLayout>
            <pattern>%d %p %c{1.} [%t] %m%n</pattern>
        </PatternLayout>
        <TimeBasedTriggeringPolicy />
        </RollingFile>
      </Appenders>
    <Loggers>
        <Root level="error">
        <AppenderRef ref="RollingFile"/>
        </Root>
    </Loggers>
    </Configuration>

5.4 Filtre de seuil

Le filtre ThresholdFilter vous permet de configurer le filtrage par niveau de message. Il n'a que 3 paramètres :

1 niveau Définit le nom du niveau de journalisation des messages : ERROR, DEBUG, …
2 surMatch Comment se connecter si la condition du filtre est vraie . Peut-être ACCEPT, DENYou NEUTRAL. Par défaut NEUTRAL.
3 onMismatch Comment se connecter si la condition du filtre est fausse . Peut-être ACCEPT, DENYou NEUTRAL. Par défaut NEUTRAL.

Configurons un filtre qui n'autorisera que les messages de niveau DEBUG. Un exemple avec une configuration de filtre complète est ci-dessous :


    <?xml version="1.0" encoding="UTF-8"?>
    <Configuration status="warn" name="MyApp" packages="">
    <Appenders>
        <RollingFile name="RollingFile" fileName="logs/app.log" filePattern="logs/app-%d{MM-dd-yyyy}.log.gz">
           <ThresholdFilter level="DEBUG" onMatch="ACCEPT" onMismatch="DENY"/>
        <PatternLayout>
            <pattern>%d %p %c{1.} [%t] %m%n</pattern>
        </PatternLayout>
        <TimeBasedTriggeringPolicy />
        </RollingFile>
    </Appenders>
    <Loggers>
        <Root level="error">
        <AppenderRef ref="RollingFile"/>
        </Root>
    </Loggers>
    </Configuration>