Creating a monitor model for IBM Business Monitor V7 or later

To create a monitoring model for IBM® Business Monitor V7 or later, export monitoring information from IBM Integration Bus.

1. Export your message flow from IBM Integration Bus.
   1. In the IBM Integration Toolkit, right-click the message flow or integration project, and click Export.
      The Export wizard starts.
   2. Click Business Monitoring > Application monitoring information, then click Next.
   3. Select the flows from which you want to export monitoring information, and specify a file name.
   4. Optional: Specify that an existing file should be overwritten without warning.
   5. Click Finish.
      A .zip file is created that contains the following monitoring information about the message flow:

      • All monitoring information that is defined in the message flow files
      • The WMBEvent.xsd file, which is the schema for the emitted event
      • All .xsd files in the message sets that are referenced by the selected flows

      A report of the export is written to file flowProjectName_batchgen.report.txt in the log directory of the integration project.
2. Import the exported .zip file into IBM Business Monitor V7 or later.
   1. In the Business Monitoring perspective of IBM Business Monitor, right-click the Project Explorer view and click Import.
   2. Complete the instructions in the Generate Monitor Model wizard.
      Select one or more of the following templates, depending on the event sources in your message flow:

      • Average Transaction Duration This template is available if you have created transaction.Start, transaction.End, and transaction.Rollback event sources. If you select this template, a metric and stopwatch are created for you in the monitor model showing the Average Transaction Duration, and a key performance indicator (KPI) is created using the data from this stopwatch.
      • Number of Failed Transactions This template is available if you have created transaction.Rollback event sources. If you select this template, metrics are created for you in the monitor model showing the number of failed transactions and the failed transaction time (this has a default value of 1 January 9999 01:00:00.) A measure and dimension are also created for use in creating multidimensional reports. See Defining Dimensions in the IBM Business Monitor product documentation.
      • Message Flow Correlation This template provides information about the integration node (such as integration node name, integration server name, parentTransactionID, globalTransactionID). You can display this information in a Business Space Dashboard with other metrics and key performance indicators. Because these metrics are used in the correlation expression for the inbound events defined, select this template only if the events for a specified monitoring context are from the same integration server.

      For detailed instructions for using IBM Business Monitor to monitor message flows, see Generating monitor models based on application monitoring information from WebSphere Message Broker in IBM Business Process Manager product documentation online.
3. Install and configure a message-driven bean in IBM Business Monitor.

   For IBM Business Monitor to monitor events, they must be submitted to the CEI repository by using a message-driven bean. The message-driven bean, which runs in WebSphere Application Server, subscribes to the event topic and writes events that match its subscription to the CEI repository as Common Base Event events.

4. Ensure that the event topic has a subscription registered against it for the message flow.
5. Create a IBM Business Monitor dashboard.

   For detailed instructions see IBM Business Process Manager product documentation online.

6. In IBM Integration Bus, configure event sources by using either monitoring properties or a monitoring profile.
   For more information, see the appropriate topic:

   • Configuring monitoring event sources by using monitoring properties
   • Configuring monitoring event sources by using a monitoring profile
7. Ensure that the appropriate events are enabled.

   For more information, see Enabling and disabling event sources.

8. In IBM Integration Bus, activate monitoring for the deployed message flow.

   For more information, see Activating monitoring.