IBM BPM, V8.0.1, All platforms > Measuring and improving business processes > Monitoring > Enabling and configuring service component monitoring > Monitoring service component events > Monitoring service components with the Common Event Infrastructure server > Tutorial: Using the Common Event Infrastructure server for event monitoring

Example: Monitoring with the Common Event Infrastructure server

For monitoring with the CEI server, you can use the administrative console to manage the details for event types and to display recorded events in the Common Base Event browser. This example shows the use of the console to change the level of detail recorded for some event types and to use the Common Base Event browser to view the information for individual events.

You will use the business rules sample application for this scenario; consequently, you should already have the web page containing this application already open. Keep it open, since you will be running the sample after you specify monitoring parameters. Ensure that you have already run the sample at least once, because that will cause it to appear in the list of functions that you can select to monitor.

The Common Base Event Browser depends on the CEI Server database, which is not configured by default. If necessary, configure the database before beginning this task. Be aware that using the CEI Server database in a production environment can result in degraded performance.


Procedure

  1. Open the administrative console.

  2. In the navigation pane, click Servers > Server Types > WebSphere application servers.

  3. Click server_name.
  4. Under Troubleshooting, click Logging and tracing

  5. Click Change Log Detail levels

  6. Select the Runtime tab.
  7. Expand the tree for WBILocationMonitor.CEI.BR and you will see five event types under the WBILocationMonitor.CEI.BR.brsample.* element:

    • WBILocationMonitor.CEI.BR.brsample_module.DiscountRuleGroup.Operation._calculateDiscount.ENTRY
    • WBILocationMonitor.CEI.BR.brsample_module.DiscountRuleGroup.Operation._calculateDiscount.EXIT
    • WBILocationMonitor.CEI.BR.brsample_module.DiscountRuleGroup.Operation._calculateDiscount.FAILURE
    • WBILocationMonitor.CEI.BR.brsample_module.DiscountRuleGroup.Operation._calculateDiscount.SelectionKeyExtracted
    • WBILocationMonitor.CEI.BR.brsample_module.DiscountRuleGroup.Operation._calculateDiscount.TargetFound

  8. Click each of the events and select finest.

  9. Click OK.
  10. Switch the business rules sample application page, and run the application once.

  11. Go back to the administrative console, and select Integration Applications > Common Base Event Browser from the navigation pane.

  12. If you are running your server on node within a Network Deployment environment, then you may need to modify the Event Data Store field to include to the names of your server and node. Enter the string in the following form: 'cell/nodes/ node_name/servers/ server_name/ejb/com/ibm/events/access/EventAccess'.
  13. Press Get Events.


Results

You should now see a list in the upper pane of the Common Base Event browser of the four business rule events that were published to the CEI server when you ran the sample application. Select one of the events, and you will be shown the contents of the event in the lower pane. Compare this to the events published to the loggers. Notice that the browser has parsed the original XML string that was published to the CEI server, and that the business object code in the ENTRY and EXIT events was converted from the original hexadecimal format to readable XML. You may want to go back through this exercise and change the level of detail from finest to fine or finer, and compare the differences between the events.

After completing this exercise, you should understand how to select service component event points for monitoring using the CEI server. You have seen that the events fired in this type monitoring have a standard format, and that the results are published to a database. You should also be able to use the Common Base Event browser to retrieve events from the database, and view the information for individual events in a parsed table format on the browser.


What to do next

If you no longer want to monitor the business rules sample application, you can go back to through the steps outlined here and reset the level of detail for the sample events to info.

Tutorial: Using the Common Event Infrastructure server for event monitoring