IBM BPM, V8.0.1, All platforms > Authoring services in Integration Designer > Developing monitor models > Create monitor models > Defining monitor details models > Generate a global monitoring context
Generate a global monitoring context from a common source metric
You can generate a global monitoring context in which the source contexts contain a common key.
For example, all the source monitoring contexts might contain a loan ID that can be used to link the contexts.
Before you can generate a global monitoring context for a monitor model, the monitor model must contain at least two basic root-level monitoring contexts. The New > Global Monitoring Context menu item is disabled until at least two root-level monitoring contexts exist for the monitor model.
When your monitoring contexts have a common key, you do not specify the relationships between milestones as part of generating the global monitoring context.
If you want to map one milestone to multiple other milestones (a fan-out mapping) or if you want to have multiple milestones map to one milestone (a fan-in mapping), follow these steps:
- For each monitoring context, add a new metric whose value is set by the metric that contains the common key. The new metric will be a copy of the common key. Then, select the Hide from dashboards option.
If the monitoring context is going to be the target of more than one source monitoring context (for example, it is a fan-in target), add multiple metrics to contain copies of the common key.
- Follow the steps in Use the Global Monitoring Context wizard.
- Make sure you do not select the check box for All source monitoring contexts contain a common key.
- From the Metric mapping key list on the Map Metrics in Monitoring Contexts for Correlation page, select the metric that you added in step 1, and then map the milestones.
You use the Global Monitoring Context wizard to create global monitoring contexts. Start the Global Monitoring Context wizard from the Monitor Details Model page of the monitor model editor.
Procedure
- Right-click the name of the monitor model in the tree view and select New > Global Monitoring Context.
Only one global monitoring context can exist for each monitor model. If a global monitoring context exists for a monitor model, the New > Global Monitoring Context menu item is not displayed.
- Complete the wizard pages. A brief overview of the wizard pages is provided in the steps that follow.
- On the Create a Global Monitoring Context page, specify information about the global monitoring context. Select All source monitoring contexts contain a common key.
After you deploy the monitor model with which the global monitoring context is associated, you can view information about the instances of the global monitoring context on the generated dashboard. The information that you view depends on the selection you make for Do not display source monitoring contexts in dashboard.
- If you want to view instances of the global monitoring context only, select Do not display source monitoring contexts in dashboard. When you select this option, you do not see instances of the individual monitoring contexts that make up the global monitoring context.
- If you want to view instances of the individual monitoring contexts that make up the global monitoring context, make sure that Do not display source monitoring contexts in dashboard is not selected. If you do not select this option, instances of the global monitoring context as well as the individual monitoring contexts that make up the global monitoring context are displayed on the dashboard.
- On the Map Monitoring Contexts to Milestones page, add a milestone, and then select, from the list of existing monitoring contexts, the ones you want to include in the milestone.
Important: Verify that the monitoring contexts for each milestone are listed in the order in which the instances of the monitoring contexts will be processed.
For example, if an instance of an Order monitoring context must precede an instance of a Shipping monitoring context, make sure Order is listed before Shipping in the Included monitoring contexts list.
Repeat the steps for adding a milestone and including monitoring contexts in that milestone until you have defined all the milestones for this global monitoring context. Then indicate which milestone completes the global monitoring context.
At this point, you have defined the milestones for your global monitoring context, and you have included source monitoring contexts within those milestones.
- On the Create a Key Metric page, create a key metric to be used to the link monitoring contexts.
The key metric serves as a correlation key. The global monitoring context uses the key metric to track instances of monitoring contexts for an instance of the same end-to-end process. You select a "natural" business key (such as a loan ID in a banking scenario or a claim ID in an insurance scenario).
For example, if you are monitoring loan ID 42, you select the metric that contains the value of 42.
For each monitoring context to be included in the milestone, select the metric and add it to the Mapped list.
After you have linked the monitoring contexts within a milestone, indicate the relationship of the milestones.
For example, if you select One to One, you are indicating that one instance of the first milestone (for example, an Order Initiated milestone) flows directly to an instance of the second milestone (for example, an Order Submitted milestone). Milestones can also have mapping types of One to Many or Many to One.
Tip: Before you select Next, click Preview Diagram to see a visual indicator of how the milestones flow from one to another. At this point, you can make changes to your selections before you commit them by selecting Next.
- On the Add Metrics page, select at least one metric from the existing monitoring contexts to include in the new global monitoring context.
- Click Finish to generate the new global monitoring context.
Results
The new global monitoring context is displayed under the monitor model in the tree view.