Filters

LevelMatchFilter

Use LevelMatchFilter when you want to filter log events for a single message threshold. For example, you might want to log only error messages, or you might want all messages that do not have a threshold of FATAL.

To use this filter you specify a threshold, and you specify whether to accept or deny the log event if the filter threshold matches the log event threshold. If there is no match, the filtering process continues with the next filter in the filtering policy. If there are no other filters in the filtering policy and if the log event has not been denied, the appender accepts and processes the log event.

LevelMatchFilter Syntax

</filter>

LevelMatchFilter Syntax Description

class="LevelMatchFilter"

specifies to filter messages based on a log event threshold.

name="AcceptOnMatch" value="TRUE | FALSE"

specifies whether to accept or deny the log event if the log event threshold matches the value in this filter. Valid values are TRUE or FALSE:

TRUE	specifies to accept the log event.
FALSE	specifies to deny the log event.

specifies the threshold to filter log events for this appender. Valid values are DEBUG, TRACE, INFO, WARN, ERROR, or FATAL.

See:	Pattern Layout

LevelMatchFilter Example

The following filter denies log events whose threshold is INFO:

<filter class="LevelMatchFilter">
   <param name="LevelToMatch" value="info"/>
   <param name="AcceptOnMatch" value="false"/>
</filter>

Top of Page