Prev Next

Generate, Save and Load Profile Reports

Reports can be produced at any time during a session, or naturally when a program ends. To enable the Report button while the program is running, however, you need to suspend Profiling by toggling the Pause/Resume button, or by terminating the Profiler with the Stop button. You have some options for reviewing and sharing the results:

  • View the report
  • Save the report to File
  • Distribute the report as a Team Library resource
  • Attach the report as a document to an Artifact element
  • Synchronize the model by reverse engineering the source code that participated in the profile

Access

Ribbon

Execute > Analyze > Profiler > Create Report from Current Data

Other

From the Profiler window, click on the icon in the toolbar.

CallFrequency Report

Function Summary

Unfiltered Summary Report listing all participating functions in order of inclusive hits.

You can filter and reorganize the information in the report, in the same way as you do for the results of a Model Search.

Report Options

Right-click on the report to display the context menu.

Action

Detail

See also

Show Source for Function

For the selected frame, select this option to display the corresponding line of code in a code editor. Frames that have source available are identifiable by their icon.

Getting Started Customizing the Search View

Find in Summary Window

Select this option to locate the function in the 'Summary' tab.

Collapse Graph

Select this option to collapse the entire graph including child nodes, visible or not.

Collapse to Node

Select this option to collapse the entire graph, then expand and set the focus to the selected node.

Follow Max Allocations

Select this option to expand an entire line in the graph.

Create Line Report for Function

Select this option to launch the Profiler (if it is not already running), immediately bind the selected function and ready it for recording. Once bound, an extra tab is opened in the current Report View. This report will update instantaneously, showing the number of times each line executed. Of course, the report will continue to record activity in the function even if is not visible.

Note: In windowed programs, it is usually necessary to take some action in the application to cause the function to be invoked.

Function Line Reports

Create Function Graph

Select this option to create an additional tab, which shows the selected function in isolation. For a Call Frequency Profile, this produces a graph showing all the lines that led to this function being called (that is, the callers). For a Memory Profile, this produces a graph showing all lines that emanate from this function (that is, the callees).

Mark Initial Frame for Call Stack Diagram

Use prior to creating a Call Stack sequence diagram to limit the stack length. When this option is selected, the frame is marked and its text is highlighted. Frames above this one will then be excluded from any sequence diagram produced.

Remove Mark

Removes the mark from a frame that was previously marked as 'Initial'.

Create Call Stack Diagram

Generates a sequence diagram for a single stack in the graph. The selected frame is depicted as the terminal frame in the stack. The initial frame  of the stack defaults to the root node if no 'Initial' frame has been marked.

Create Weighted Call Graph Diagram

Generates a sequence diagram that presents a sequence for each visible stack branching from the selected frame. By expanding and collapsing the nodes of interest, a user can tailor the sequence diagram content to their liking.

Display the Heaviest Weighted Use

Select this option to display the line in the graph with the highest weight in which this function appears.

Display the Next Weighted Use

Select this option to navigate to the next line in the graph where the function appears.

You can use the shortcut key combination Ctrl+Down Arrow.

Display the Previous Weighted Use

Select this option to navigate to the previous line in the graph where this function appears.

You can also use the shortcut key combination Ctrl+Up Arrow

Save Report to File

Select this option to display the 'Save As' dialog, allowing you to choose where to store the report.

Save Report to Artifact

Note: Before selecting this option, go to the Project Browser and select the Package or element under which to create the Artifact element.

You are prompted to provide a name for the report (and element); type this in and click on the OK button.

The Artifact element is created in the Project Browser, underneath the selected Package or element.

If you add the Artifact to a diagram as a simple link, when you double-click on the element the report is re-opened.

Artifact

Team Library Options

Option

Description

See also

Make Report a Team Library Resource

You can save any current report as a resource for a Category, Topic or Post in the Team Library to share and review at any time, as it is saved with the model. The report can also be compared with future runs.

To begin this process, on the 'Team Library context menu select the menu option 'Share Resource | Add Active Profiler Report'.

Work on Team Review Items

Notes

  • If you add the Profiler report to an Artifact element and also attach a linked document, the Profiler report takes precedence and is displayed when you double-click on the element; you can display the linked document using the 'Edit Linked Document' context menu option

Learn more