Skip Headers
Oracle® Enterprise Manager Business Transaction Management Online Help

Go to Documentation Home
Go to Book List
Book List
Go to Table of Contents
Go to Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Go to next page
PDF · Mobi · ePub

Viewing Logged Messages and Properties

You can use the Message Log tab for a transaction to view the following information:

Business Transaction Management logs message content or instance and property values only if you have done the following:

Logged information is stored according to storage settings that you define when you create the transaction.

This section explains how you view information about messages, search message logs for messages, and enable or disable logging.

Viewing Information About Logged Messages and Properties

The Message Log tab for a given transaction displays information using a grid view that displays a list of messages, showing the arrival time of the request message, the service that includes the selected operation, the location of the endpoint that implements the service, the operation (message), and the type of operation. If there are any properties associated with the operation, their values are shown in additional columns whose title is the property name.

If you have message content logging enabled, double clicking on any message shows you the contents of the message.

The set of messages shown in the grid varies depending on the setting of the filters shown at the top of the tab. These allow you to see

  • All operations or specific operations chosen from a drop down list

  • Any response, only successful operations, only failures

  • Messages that arrived within a time interval denoted by the last specified time period, since a certain time, or between two given times.

You can use these controls to narrow the selection of messages shown in the grid. After you change filter settings, click Search again to repopulate the grid.

You can further narrow your search by using the Message Search tool accessed from the Choose Content... link. This allows you to search for messages based on their property values or, if message content is enabled, based on message content. This tool is described in the next section.

Using the Message Log Search Tool

The Message Log Search tool enables you to further refine the scope and the criteria of your search (in addition to the strictures defined by the view filters). To bring up this tool, choose Search Message Log from the View menu. This allows you to find messages belonging to any monitored transaction for which logging is enabled.

You can also find messages belonging to the currently selected transaction, by clicking the Choose Content... link from the Message Log tab of the transaction. However, this more restricted search does not give you the additional option of searching for related transactions when you obtain the search results.

The Message Log Search tool has three main areas you can use to define search criteria: an area labeled Message property search, an area labeled ECID, and one labeled Free text search. You use controls in these areas to search for a set of messages based on a property value, ECID value, and/or on text content. As you enter property, ECID, and free-text values, a search expression is constructed in the text box at the top of the tool. To clear the box and start over, press the Clear button.

For additional information about using Oracle query language to formulate your query, look at the following:

When you are done defining the expression to be used in the search, click the OK button. Then click the Search button to repopulate the grid according to your newly defined search criteria.

The following sections provide additional information for each type of search; however, note that you are not restricted to a single type: you use them in any combination. For example, you can search for messages that have a given property and ECID value.

ECID-Based Search

If a message (operation) has been assigned an ECID, you can search for those messages that have been assigned a specific ECID. For information on the meaning and assignment of ECIDs, see Accessing Other Diagnostic Tools.

To do an ECID-based search, select the matching criteria in the ECID field and enter or paste the ECID value in the ECID entry field. You can copy the ECID value from anywhere it is displayed. If you are copying from a column, expand the column to make sure you have the full string value. The Message Log Search tool, displays all operations with the specified ECID in all transaction instances in a grid view.

If you want to look at a specific transaction instance that contains a given ECID, select the operation of interest in the grid view of the Message Log Search tool and select View > Related Transaction > target_Transaction in the Message Log Search tool. The instance of interest is displayed in the Instance Inspector window.

Property-Based Search

The properties that have been defined for the transactions in question are shown in the Message property search area. Use the drop-down lists to specify your property-based search criteria.

  • For a numeric value, the drop down list allows you to search for messages whose properties are less than, equal to, greater than, not equal to, and so on.

  • For a string value, the drop-down list provides a similar set of matching options.

Free Text Search

To use this search option, you must have enabled message content logging.

Enter a string you want to search for in the box labeled Message contains the text. Do not enclose the string in quotation marks unless you're looking for a string enclosed in quotation marks.

Enabling and Disabling Message Logging and Instance Logging

Do the following to enable or disable message logging and instance logging:

  1. Select the transaction of interest.

  2. Select Modify > Edit TransactionName.

  3. In the ensuing dialog, select the Logging tab.

  4. Use the check boxes shown to enable or disable message content logging and instance logging.

  5. If enabling message logging, select the specific operations you want to log.