Customize the BPM Monitor Model for WebSphere Business Monitor
Import the BPM Project Interchange file
Use the following steps to import the BPM Project Interchange file into IBM WebSphere Integration Developer (WID). This file contains the monitor model.
- Click File > Import and select Project Interchange from the list of Import Sources.
- In the WASMonitor folder, select BPMMonitoring.zip and click Next.
- Change to the Business Monitoring perspective.
- After importing, the new file appears with many errors. Fix the errors by changing the MMINstallDate placeholder with the actual date of installing the BPM CBE Adaptor for WebSphere Business Monitor in the following format:dateTime('2007-07-31T14:47:27-07:00'). See the Inbound Event Filter section in the Best Practices topic.
- Save to confirm there are no more errors.
Add user-defined fields
To monitor user-defined fields (UDF) in running BPM processes, complete the following steps (details below) in WebSphere Integration Developer (WID) to add the fields to the BPM Monitor Model for WebSphere.
NOTE The fields must be exposed in the event logs of the Process Engine isolated region so that the values are recorded in the event log. See Configure data fields in the online Help for Process Configuration Console for instructions for exposing data fields in event logs.
Add user-defined field - event definition
Add the UDF to P8.BPM.Base event so all P8 BPM events will contain this UDF.
- In Project Explorer under Event Definition, select P8 BPM and click P8.BPM.Base.
- In the ExtendedData section, add the UDF as a nested child element of businessData.
NOTE The field name you specify must be exactly the same as the field you exposed in Process Configuration Console. Also specify the data type.
Add user-defined field - BPM Monitor Model for WebSphere
Add the UDF to the appropriate monitor context as a metric.
- To monitor the UDF at process level, add it to BPM Process monitor Context.
- To monitor the UDF at work item level, add it to BPM WorkItem Monitor Context.
To define a UDF as a metric
- Go to BPM monitoring under the Monitor Model, and double-click BPM Monitoring.
- On the Monitor Details Model tab, right-click the appropriate monitoring context (process or activity) in the model tree, and click New > Metric.
- In the Create New Metric window, type a name into the Name field and click OK. The name is limited to 256 characters.
The metric is added to the model tree under the monitoring context, and the form editor opens so that you can define the metric.
- In the form editor, specify the details of the metric as follows:
- Optional: Type a description in the Description field. The description is used only in the Monitor Model editor and is not displayed anywhere in WebSphere Business Monitor. The character set is unrestricted.
- Select the type from the list.
- Optional: Type the maximum string length in the Maximum string length field. This option is available only if the type is String. The default is 256, and you can enter any value greater than 0. The maximum string length is added as a constraint in the database.
- Optional: To specify a default value, type a number or a function into the box, or click Edit to enter an expression.
-
Click Add to add a map to the table and, optionally, enter the expression for setting the value of the UDF.
- Click the Expression cell and click the button to open the Expression Dialog window. If you press Ctrl+Space for content assist, a small window opens to help you write the expression.
- Select BPM Monitoring.
- Select the inbound event that specifies when the value is updated in the data mart. Select the inbound event as either a Process Monitor context or the Work Item context that updates the value of the metric.
For detailed information regarding metric editing, please refer to Information Center of WebSphere Business Monitor.
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.btools.help.monitor.doc/Doc/tasks/mme/definingmetrics.html
Add user-defined field - Data Mart Model
Add the UDF as a dimension or measure to either the BPM Process MC Cube or the BPM WorkItem MC Cube, depending on the monitoring context you defined for this UDF.
To define a dimension and its attributes
- On the Data Mart Model tab of the editor, select the appropriate cube in the Dimensions table, and click Add Dimension.
- In the Create New Dimension window, type a name into the Name field and click OK.
- Optional: Click Details to add a description.
- Select the dimension and click Add Attribute. In the Create New Dimension Attribute window, type a name into the Name field and click OK.
Click the Source cell and click the button that is displayed to open the Select Attribute Source window. Select the source of the attribute. The source is the UDF you defined within the monitoring context.
- Select the Is Key check box.
To define a measure to be used based on one of the facts
- On the Data Mart Model tab of the editor, scroll down to the Measures table.
- Select the appropriate cube and click Add Measure.
- In the Create New Measure window, type a name into the Name field and click OK.
- Click the Source cell and click the button to open the Select Fact Attribute window.
Select the source of the measure.
- Optional: Click the Aggregation Function cell and select the function from the list.
For detailed information regarding data mart editing, refer to Information Center of WebSphere Business Monitor.
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.btools.help.monitor.doc/Doc/tasks/mme/definingdatamarts.html
Add KPIs and threshold monitoring
Use WID to define KPI and outbound event for threshold monitoring. Refer to Information Center of IBM WebSphere Business Monitor for details.
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.btools.help.monitor.doc/Doc/tasks/mme/definingkpimodels.html
Deploy the updated BPM Monitor Model for WebSphere
Generate the .EAR file and deploy the updated monitor model to the WebSphere Business Monitor server.
For more information, refer to the WebSphere Business Monitor documentation.