IBM BPM, V8.0.1, All platforms > Authoring services in Integration Designer > Developing monitor models > Create monitor models > Generate monitor models

Update monitor models based on applications

After generating a model from an application, or adding application elements to a model, you might want to add more activities to monitor, or apply new templates. You can add monitoring to application elements that were not originally selected for monitoring or that were created after the monitor model was originally generated.

Before you can update a monitor model based on an application, the following prerequisites must be met:

To update the monitor model:


Procedure

  1. Click the Monitor Details Model tab of the editor, right-click the monitoring context or event group in the model tree, and click Update from Application > application name. This option is available only for monitoring contexts or event groups associated with application elements in Integration Designer. The Generate Monitor Model window opens, and shows the part of the application that has the element associated with the selected monitoring context as the root.

    For example, if the selected monitoring context is associated with a Business Process Execution Language (BPEL) scope activity, the tree displays the scope node as the root of the tree, with all descendant application elements underneath.

    Remember: You are looking at the last synchronized version of the application. If the model has not been synchronized with the application, you are looking at outdated information, and could, for example, attempt to monitor an element that no longer exists in the application.

  2. Select the elements that you want to monitor. In the tree showing the application to be monitored, click any node to see the template and event information for that element. The Monitoring Templates tab shows the common monitoring templates that are available for the selected element. Choose one or more templates to create the appropriate monitoring constructs in the generated model. (See Common monitoring templates for IBM BPM Advanced and WebSphere Enterprise Service Bus for more information.) The Emitted Events tab shows all of the events that the selected element can emit. You can either select events individually, or you can right-click in the tree at any level and click Select all events at this level or Select all events at this level and below.

    Events that can carry business information, which is often called the business payload (see Events that can carry business payload), are shown with a flag and package icon

    . Events that can never carry business information are shown with a flag icon

    .

    You cannot remove an event if you have chosen a template that requires that event. The event is shown as selected but unavailable.

    By default, all the events that you select are automatically enabled for emission in the application that you will be monitoring. If the application has already been deployed and, therefore, the set of events that the application emits cannot be changed, or if you want to restrict the selection to the events that the application currently indicates will be emitted, from the Select events with an option list, select Include only the events that have been turned on in the application.

    You can also select Include all selected events. If you select this option and select an event that is not currently emitted, you will see a warning in the Problems view after you have generated the monitor model. Using the information in the warning message, you can find the event that is currently turned off and update the application to turn on the event. To remove the synchronization warning from the Problems view, you can then synchronize the monitor model with the application.

    After you have finished selecting events and templates, click Next.

  3. Select how the monitored elements will be implemented. In general, accept the default implementations. The tree on this page shows only the elements you have chosen to monitor. Specifically, the tree shows the event sources that you selected events for and the event sources that are ancestors of those event sources. If you did not select any templates or events for the ancestor event sources, the default implementation is None whenever possible. (It is not always possible to specify None because some event sources contain information that is needed by events that are emitted from descendent event sources.) In the second column, select the monitoring implementation that you want for each element. Based on the element, you might have some or all of the following choices:

    • None. The element will not be represented in the generated monitor model. This option is available only if there are no inbound events at the selected or descendant levels that require the selected element to be present. If you click this option, all descendant levels are also set to None.
    • Monitoring context. A monitoring context will be created for the element, complete with keys and a corresponding cube. This option is available only if the selected application element has a lifecycle and an identity that events can use to find it.
    • Event group. An event group will be created for the element. All inbound events at the selected level and all descendant levels will be collected in this new event group (that is, they will all be at the same level in the event group). This option is available only if there are no templates chosen that require a monitoring context at the selected or any descendant levels.

      If you choose this option, all descendants are set to "–" because all of the associated events will be collected into the event group. (See When to choose monitoring contexts versus event groups for more information.)

  4. To see a preview of the monitor model that you chose to create, click Next. To make changes and see how they affect your model, click Back to make changes and then click Next.

  5. When satisfied with your selections, click Finish. You are asked whether you would like to switch to the Business Monitoring perspective to begin editing the newly created monitor model. To open the new monitor model in the Monitor Model editor, select Yes.

    Important: Confirm that the Build Automatically option on the Project menu is enabled. If it is not, perform a clean build on the monitor model project after it is generated to ensure that the monitor model is validated.


Results

The existing monitor model is updated with the monitor model constructs that correspond to the common monitoring templates and inbound events that you selected.

Generate monitor models