IBM BPM, V8.0.1, All platforms > Authoring services in Integration Designer > Monitoring events > Monitoring events

Specifying event properties for component elements

In the event monitor, you can specify event properties for individual component elements that you have selected in a component editor.

For example, you can choose whether to generate all events, or selected events, or no events for a component element. You can also specify other event properties for a selected component element, such as the content level and transaction behavior.

Before you begin to work with the event monitor, you should ensure that you have configured IBM Process Server to support the monitoring and logging of business process and human task events. This is described in the topic "Configuring IBM BPM to support event monitoring in IBM Integration Designer." Also, you should ensure that you are familiar with the components and elements that can be monitored for events in IBM Integration Designer. A complete list of monitorable components and elements is found in the topic "Monitorable components and elements in IBM Integration Designer".

To specify event properties for component element perform the following steps.

Procedure

1. If you have opened the event monitor in the business process editor or the human task editor, complete one or both of the following steps:

   • If you want to generate CEI events into the CEI data store, ensure that the CEI check box is selected. This is the default selection.

   • If you want to generate audit events into the process choreographer database, select the Audit Log check box. (If you also selected the CEI check box, these same audit events will also be generated as CEI events and they will be accessible to all components and event consumers. Unless you have a specific need to work with audit events in the process choreographer database, it is recommended that you only select the CEI check box.)

2. Select one of the following radio buttons:

   • Select None if you do not want to generate and monitor any events associated with the component element selected for monitoring. (If that if you are in the event monitor for the business process editor and you select None, the default events will still be generated for the Process, Receive, Reply, Invoke, Scope, Human Task, and Pick elements if you have selected Enable Default Events in the Global Event Settings pane of the event monitor. Enabling and disabling default events for business process activities is described in the topic "Specifying event properties for components.")

   • Select All if you want to generate and monitor all events associated with the component element selected for monitoring.

   • Select Selected if you want to select, generate, and monitor individual events associated with the component element selected for monitoring.

3. If you chose Selected, select the check boxes beside the individual events that you want to generate and monitor for the selected element.

4. If you selected All or Selected, then select one of the following Event Content levels beside All or beside the individual events that you selected:

   • Select Full to show all business object fields in the event.

   • Select Digest to show only the business object ID in the event.

   • Select Empty to show no business object fields in the event.

   If you have selected an individual event for a monitorable element that has no business object, Empty is the only option.

5. If you have selected one or more events and you want to have the events generated at run time, then ensure that On is selected for each event. The events will be generated at run time with the appropriate level of information. (If On is not selected for a selected event, the event will continue to be registered with the monitor run time, but it will not be generated at run time.)

6. If you want to choose a transaction behavior to control rollbacks when an event fails, then select one of the following entries in the Transaction drop-down list:

   • Select Existing to send the event in the current transaction. If the current transaction fails, the event will not be generated.

   • Select New to send the event in a new transaction. If this new transaction fails, the event will not be generated.

   • Select Default to use the default transaction value supported by the underlying event infrastructure. This value is either Existing or New.

7. If you want to add a specific comment on the event setting for a selected event, then type a comment in the Label field. The comment is only used for documentation purposes at development time. It will not be used at run time and it will not be written to the generated event.
8. Repeat these steps for each element that you want to monitor.
9. Press Ctrl-S to save the event monitor settings. On the component elements that you selected to monitor, an event monitor symbol is displayed

   . A monitoring (.mon) file is also generated or regenerated in the Physical Resources view to store your event monitoring specifications. The next time that you deploy and run your monitored component, events will be generated for each monitorable element that you chose to monitor in the component.

What to do next

When you have finished specifying event properties for individual component elements, you might want to globally specify event properties for all your component elements, as described in the topic "Specifying event properties for components." Or you might want to deploy and run your component and view the generated events in the Common Base Event browser, as described in the topic "Viewing CEI events."

Alternatively, you might want to use the event definition generator to generate event definitions for the events that you have selected in the event monitor. Event definitions are files that define the structure of emitted events that are based on the Common Base Event specification. Information about generating event definitions is found in the event definition generator topic "Generating event definitions." However, you must have the IBM Business Monitor development toolkit installed to work with event definitions. The toolkit enables you to associate your event definitions with a monitor model and then add business metrics to the event definitions in the monitor model editor. You can later deploy the monitor model and event definitions to anIBM Business Monitor server and monitor the events in the IBM Business Monitor dashboard. Information about using the toolkit to work with event definitions is found in the IBM Business Monitor development toolkit documentation.

Monitoring events