Using UML2 Trace Interaction views
The visualization of host and process interactions in the Sequence Diagram
views of the Profiling and Logging Perspective helps in workload
administration of distributed applications. The representation of time
in these views helps in determining bottlenecks in application performance as well as network
communication.
Prerequisites:
The sequence diagram views provide a number of actions that can be performed
to easily view and analyze trace interactions.
To open a trace interaction diagram view, follow these steps:
- Select the monitor that represents the application cluster in the Profiling Monitor view.
Note: Switch to Distributed Layout to view monitors.
- Right click, then select Open With and select interaction diagram
type that you want to view. The Sequence Diagram view opens and shows entities that correspond to
the monitoring level selected. The following table lists the interaction views available for each selected
monitoring level.
Selected monitoring level
| Available interaction views
|
Monitor |
Monitor, Host |
Host |
Process, Agent |
Process |
Class, Object, Thread |
Execution Time Analysis |
Class, Object, Thread |
For large views where scrolling is required, the overview can be used to navigate to
and from different pages within the sequence diagram.
To open the sequence diagram overview, click on the
button at the lower right-hand corner of the view.
Note: This button is only displayed when scrolling is required.
Navigating lifelines and messages
For views with multiple pages, there are several methods of navigation available.
- Navigation menu item
- From the toolbar drop-down menu, select Navigation. A navigation
sub-menu is displayed.
- Select one of the navigation options.
- Pages menu item
- From the toolbar drop-down menu, select Pages. The Sequence Diagram Pages dialog box opens
- Type the page number that you want to go to. Click OK. The view refreshes with the target page.
- From the toolbar or from the toolbar drop-down menu, navigate using the
Go to next page and
Go to previous page buttons.
- Go to message
- Select a message. Right click to bring up the context menu.
- To view to the return of a method call, select Go to message return from the context menu.
- To view to the start of a method call, select Go to message from the context menu.
Collapsing and expanding lifelines can be used to hide or expand sections of data within a view.
- To collapse a lifeline
- While pressing the CTRL key, click on the lifelines that you want to collapse.
- Right click to bring up the context menu.
- Select Collapse selected classes or objects. The view refreshes with the selected
lifelines merged together in one lifeline. The collapsed lifeline is indicated by this icon
.
- To expanding lifelines
- Click on the collapsed lifeline that you want to expand. To view the full name
of the lifeline, hover the mouse over the lifeline.
- Right click to bring up the context menu.
- Select Expand selected lifeline. The view refreshes with the selected
lifeline expanded.
Note: Object or Class Interactions only
Collapsing and expanding messages can be used to hide or show all method
calls invoked from a selected method. Note: This applies to object or class interactions only
- To collapsing messages:
- Click on a message within the sequence diagram.
- Right click to bring up the context menu.
- Select Collapse invoked methods. The sequence diagram refreshes
hiding all method calls within the selected method.
The collapsed message is indicated by this icon
.
- To expand messages
- Click on a collapsed message within the sequence diagram.
- Right click to bring up the context menu.
- Select Expand invoked methods. The sequence diagram refreshes
showing all method calls invoked from the selected method.
Drilling down into a lifeline allows you to view all the trace interactions
within a particular lifeline. This feature allows a user to trace the root cause of a
problem from a host, to a process, to a thread and eventually to a class or an object.
The drill down option is available on host,
agent, process and thread interactions. To drill down in a lifeline, select the lifeline, right-click
and select Drill down into selected lifeline. To reset drill down options, use the Reset all drill down actions toolbar option
and drop-down list.
Highlighting a call stack allows you to view all the methods
invocations in a call stack. To highlight a call stack,
select a method, right-click and select Highlight call stack. All
method invocations in the call stack will be highlighted.
The time compression bar along the left edge of a trace diagram indicates the
time elapsed between consecutive events. The time compression scale shows
where the time falls between the minimum and maximum delta times.
The intensity of the color is used to indicate the length of time, namely,
the deeper the intensity, the higher the delta time.
The time compression bar and scale may provide accurate indication as to which part of a
method consumes the most time. It may be located between two calls, at a call
and method entry or exit, or it may cover a whole method.
The relative amount of time spent between two consecutive method calls or returns
can be viewed in two ways:
- Hover the mouse over the timeline on the left-hand side
of the diagram.
.
- Select a message, and hover the mouse over another message to see the time elapsed
between the two messages.
.
Hiding and displaying messages and lifelines
Hiding and displaying patterns in lifelines and messages allow you to examine
only certain objects of interest in the view. Note: This is only available
for object, class, thread and agent interactions.
- To hide a lifeline, select the lifeline, right-click and select Hide selected lifeline. The lifeline
will be hidden from the view.
- To display only a selected lifeline, select the lifeline, right-click and select Display only selected lifeline.
Only the selected lifeline will remain in the view. All other lifelines are removed.
- To hide a message, select the message, right-click and select Hide selected message. The message
will be hidden from the view.
- To reset the hide and display options selected:
- In the drop-down menu, select Hide/Display Patterns.
- In the Sequence Diagram Hide/Display Patterns dialog, clear the hide/display patterns
that you no longer want to apply to the view.
- Click OK.
- To add a custom hide pattern:
- In the drop-down menu, select Hide/Display Patterns.
- In the Sequence Diagram Hide/Display Patterns dialog, select Add.
- Define a string match pattern, and select whether this pattern should be searched for in
an Object/Class or Method Entry/Exit.
- Click Create. In the Hide/Display pattern list, the newly created pattern is automatically
selected.
- Click OK to apply the hide pattern to the view.
- Internal messages are calls from a lifeline to itself, for example,
a method call inside the same class or object. To hide internal messages:
- Open toolbar drop-down menu.
- Select Hide internal messages. This will filter all internal messages.
- To show the internal messages again, re-select the menu item from the drop-down menu.
To create search criteria, follow these steps:
- Open the toolbar drop-down menu.
- Select Find... The Sequence Diagram Find dialog box opens.

- In the Matching string field, specify a pattern that you want to search
for in the profiling data.
- Select whether you want to search for
the pattern in an Object or Class, a Method Entry or Exit or both options.
Note:Ensure that at least one of the options, Object or Class or a Method Entry or Exit, are selected in the
Find dialog box. If neither are selected, the Find command will appear disabled.
- Click Find. The current view is refreshed with messages or lifelines matching the search criteria.
Tip: The Find dialog can be started using the CTRL-F key.
To return the view to the default display size (reset zoom factor),
to zoom in, or to zoom out, use this set of toolbar controls.
.
Related concepts
Overview of the Log and Trace Analyzer
Log file correlation
Log interactions view
Log thread interactions view
Related tasks
Working with log files
Synchronizing time
Related reference
Sequence diagram views
(C) Copyright IBM Corporation 2000, 2006. All Rights Reserved.