WebSphere WebSphere Enterprise Service Bus, Version 6.0.1 Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Filtering events with the default filter plug-in

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

  1. In the WebSphere administrative console, navigate to the Common Event Infrastructure Provider > Filter Factory Profile page.
  2. Create a new filter factory profile. For more information, see the online help for the administrative console.
  3. 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.
  4. Navigate to the Common Event Infrastructure Provider > Emitter Factory Profile page.
  5. 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.
  6. 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";

Task topic

Terms of Use | Rate this page

Timestamp iconLast updated: 13 Dec 2005
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.websphere.wesb.doc\doc\tcei_admin_defaultFilterPlugIn.html

(C) Copyright IBM Corporation 2005. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)