The Log view lists every message generated by the
in your code along with information related to the message.
To populate the Log view, insert
in your code. Absent
ANNOTATE statements in
the source, the view is empty.
For instructions on how to use Annotate, see Customize reports using Annotate.
Right-click on any message in the list and use the Select in Call Paths contextual menu to open the Call Paths view with the calling Process/Thread/Function highlighted.
The Log view provides three search fields above the table data that enable you to find particular messages based on the field type you use and the regular expression that you enter. The regular expression in the search field acts as a filter. Only messages that contain the matching pattern appear in the list, sorted in the chronological order.
Search the message field for a string. Only messages that match the given pattern appear in the log view until the search is modified or cleared. Regular expression strings are case sensitive unless you include
(?i)in front of your search expression.
Find messages called by a particular core. Enter a core number here and the Log view displays only messages triggered by that core.
Search based on the location that triggered the annotate message. To narrow down messages to those called by a particular function, enter that function name in the Where field.
Here is a list of all of the column headers available in the Log view:
This value, given in seconds, tells you when message was generated during the captured execution. All messages appear in the Log view in chronological order.
The difference in time between when this message and the one previous to it were generated. Filtering affects the values in this column. If your searches narrow this list down, the delta values reflect only the filtered messages.
The contents of the message. For example, if your inserted
ANNOTATE("Total Value= (%d)", value)and the value of
(%d)was 12, the Message field would contain the string “Total Value = 12”. If an annotation message contains an image, a camera icon appears in the Message column. Select a row with a camera icon to see the image.
The core that generated the message.
The process and thread that generated the message.
The file location and line of code that generated the message.
The totals panel provides additional information when you select multiple messages in the Log view.
- Log Entries
The total number of messages you have selected in the Log view.
The total difference in time between the function called first and the function called last amongst the selected functions. Use the totals panel to easily see the time gap between two messages by clicking on one and holding Ctrl and clicking on a second. The value in the Totals Panel Delta field updates to show you the time difference between the two selected messages.
Right-click anywhere in the table to open a contextual menu. The menu contains the following options:
- Select Process/Thread in Timeline
Opens the Timeline view with the cross-section marker moved to the location of the selected annotation message.
- Select in Call Paths
Opens the Call paths view. All functions related to the selection in the Log view are selected in the Call paths view.