Displaying Transaction Tracking events in Tivoli Business Service Manager

Situation events from Transaction Tracking can be forwarded from IBM Tivoli Monitoring to Tivoli® Netcool/OMNIbus for display in Tivoli Business Service Manager (TBSM) in ITCAM for Transactions V7.2 and later.

Before you begin

Ensure Tivoli Netcool/OMNIbus and Tivoli Business Service Manager are installed and configured to display events from ITCAM for Transactions. See Configuring IBM Tivoli Monitoring to forward situation events for further information.

Note: IBM Tivoli Monitoring version 6 release 2.1 or higher is required for event integration.
Before you generate events to send to Tivoli Business Service Manager, generate the iDML Book for Transaction Tracking. See Generating the iDML Book for Transaction Tracking for further information.

About this task

Create a new situation for the Transaction Reporter that generates events to send to Tivoli Business Service Manager for the attributes in which you are interested.

For example, if you want to generate Total Time events for aggregates where the average transaction time of individual transactions is more than 500 milliseconds, specify Child Total Time >500 and Group Level Transaction.

Tip: Ensure that you use the Interaction Situations Attributes Group to include both agentless and agent-based information in the event.

To configure Transaction Tracking to forward events to TBSM:

Procedure

In the Situation Editor, add situations for the Transaction Reporter events that you want to send to Tivoli Business Service Manager:

  1. Click New Situation.
  2. In the Create Situation window:
    1. Enter a name and description if required.
    2. From the Monitored Application list, select Transaction Reporter.
    3. From the Type list, select the situation type.
  3. In the Select condition dialog box:
    1. Select Interaction Situations in the Attribute Group list.
      New situation Select condition dialog box.
    2. In the Attribute Item list, select Display Format and any other attribute you require.
    3. Click OK.
  4. On the Formula tab, enter values for the attributes.
  5. Set the display item for the Situation.
    Composite image of Advanced Situations Options dialog box with Situation Editor.
     Each IBM Tivoli Monitoring Situation event can be mapped to an OMNIbus event. If you do not set the Display Item, only one situation event for each situation specified can be shown in Tivoli Business Service Manager, even if there are multiple rows satisfying the situation conditions. If the Display Item is set, each different value for that Display Item triggers a situation event, resulting in multiple rows (each with a different value for the Display Item), multiple situation events, and multiple events in OMNIbus to show the status of multiple service object nodes.
    1. For the new Situation, click Advanced.
    2. In the Advanced Situation Options dialog box, go to the Display Item tab and set the Item to Display_Value.
    3. Click OK.
  6. On the Distribution tab, select the Tivoli Enterprise Portal Server.
  7. On the EIF tab, set Forward Events to an EIF Receiver and select the severity of the events to forward from the EIF Severity list.
    EIF tab showing options set.
  8. Set the attributes to be included in the event:
    Select Event Class dialog box with EIF tab.
    1. On the EIF tab, click EIF Slot Customization.
    2. In the EIF Slot Customization dialog box, select KTO_Base > ITM_Interaction_Situations from the Available Event Classes list.
    3. Click OK. The attributes that are included in that event class, and that will be forwarded to TBSM, are listed in the Slot name column.
    4. Set Map all attributes to include all listed attributes in the events forwarded to the EIF probe.
    5. Click OK.

What to do next

Events from Transaction Tracking are displayed in the Service Tree, Service Viewer, and the Active Event List.

In Tivoli Business Service Manager, navigate to Availability > Service Availability. In the Service Tree, select Imported Business Services > Transactions Business Activities to display Transaction Tracking information, as shown in Figure 1.

Figure 1. Transaction Tracking events in Tivoli Business Service Manager

Click any Transaction Tracking generated service object in the Service Tree or Service Viewer to jump to the Transaction Tracking default workspace.

To see the events in the Active Event List, select Availability > Events > Active Event List.
Figure 2. Transaction Tracking events in the Active Event List in Tivoli Business Service Manager
Transaction Tracking events in the Active Event List
Note: The default colors assigned to each status are different between IBM Tivoli Monitoring and IBM Tivoli Netcool/OMNIbus and therefore between ITCAM for Transactions and Tivoli Business Service Manager. In particular, the color for Warning is yellow in IBM Tivoli Monitoring and blue in IBM Tivoli Netcool/OMNIbus. To make the colors consistent, edit the severity attribute in the tivoli_eif.rules file, located in $OMNIHOME/probes/arch/tivoli_eif.rules on Windows systems and %OMNIHOME%\probes\arch\tivoli_eif.rules on UNIX systems. See Configuring the EIF probe in the IBM Tivoli Monitoring documentation for further information.
Parent topic: Integrating Tivoli Business Service Manager