A default emitter filter plug-in is included with the Common Event
Infrastructure.
Why and when to perform this task
The Common Event Infrastructure includes a default emitter filter
plug-in, which can be configured with an XPath event selector defining which
events are sent to the event server and which are discarded. For example,
the filter settings might specify that only events with severity greater than
20 (harmless) should be sent.
To filter events using the default filter
plug-in, follow these steps:
Steps for this task
- In the WebSphere administrative console, navigate to the Common
Event Infrastructure Provider > Filter Factory Profile page.
- Create a new filter factory profile. For more information,
see the online help for the administrative console.
- In the Filter Configuration String field, type an XPath
event selector describing events you want to use for filtering events. Events
matching this event selector are sent to the event server; events that do
not match are discarded by the emitter.
- Navigate to the Common Event Infrastructure Provider > Emitter
Factory Profile page.
- Create a new emitter factory profile, or go to an existing emitter
factory profile. For more information, see the online help for
the administrative console.
- In the Filter Factory JNDI Name field, type the JNDI name
of the new filter factory profile you created.
Result
Event sources can now use the new emitter factory to create instances
of an emitter using the new filter configuration. If you later want to adjust
the filter settings for event sources using that emitter factory, you can
modify the event selector specified in the filter factory.
You can use
tracing to find out what events are being discarded by the default filter
plug-in; for more information, see Logging and tracing in the Common Event Infrastructure.
What to do next
Note: The default filter plug-in uses the Apache JXPath component
to process XPath event selectors. If Java 2 security is enabled, you must
modify your policy file to include entries allowing the required access:
permission java.util.PropertyPermission "*", "read";
permission java.io.FilePermission
"${was.install.root}${/}java${/}jre${/}lib${/}jxpath.properties",
"read";