Filter

A filter object applies custom filtering criteria to select the messages to log. When a logger is asked to log a message, it checks for the logging level. If the level is lower than the level that the logger is configured to, the message is ignored. Thus, a message can be filtered using its level.

You can configure a filter for any handler such that it logs only those message that originate from a particular class. Additionally, a filter can be used to prevent errors with higher logging levels from appearing in loggers configured to display errors with low logging levels.

The following filters (in the com.microstrategy.utils.log package) are used by MicroStrategy Web products:

ClassFilter

This filter provides regular expression filtering of class. It uses the following properties:

Property	Use	Default Value
accept	Specifies the class names for which messages are logged. If unspecified, filter is effectively disabled.	N/A

ClassMethodTracingFilter

This filter provides regular expression filtering of class and method names. It uses the following properties:

Property	Use	Default Value
trace	Specifies if every log record should have a stack trace. To enable, use value 1.	0
pattern	Regular expression, specified as a string. If unspecified, filter is effectively disabled.