Viewing Logged Messages and Properties

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

  • If instance logging is enabled, you can view information about each message logged in a specified time period as well as the value of any property associated with a message. You can also use the Message Log Search tool to search for a message or messages that contain property values of interest.

  • If message content logging is enabled, you can view information about each message logged in a specified time period as well as its content. In this case, in addition to searching for messages based on property values, you can also search based on the content of any message element (free text search).

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

  • You have enabled monitoring for the transaction

  • You have enabled the appropriate type of logging for the transaction (instance or message)

  • For message logging, you have selected one or more operations

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 of your search (in addition to the strictures defined by the view filters). You can access this tool in one of two ways:

  • To find messages belonging to any monitored transaction (for which logging is enabled), choose Search Message Log from the View menu.

  • To find messages belonging to the currently selected transaction, click the Choose Content... link from the Message Log tab of the transaction.

The tool has two main areas you can use to define search criteria: an area labeled Message property search and one labeled Free text search. You use controls in these areas to search for a set of messages based on a property value and/or on text content. As you enter property and free-text values, a search expression is constructed in the text box. 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.

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.