You copied the Doc URL to your clipboard.

About the Timeline view

The Timeline view is the first view that you see when ARM Streamline opens a report. It provides you with high level information about the performance of your target during the capture session.

After you have successfully generated a report, Streamline opens it automatically and displays the Timeline view.

Figure 25. The Timeline view

The Timeline view

The Timeline view breaks up its data into bins, a unit of time defined by the unit drop down menu at the top of the view. For example, if the unit is set to 100ms, every color-coded bin in the processes section represents trace data captured during a 100ms window.

Charts

Streamline collects data for the charts from hardware and software performance counter resources. Use the chart expansion control on the right side of the chart handle to increase the size of any chart.

Figure 26. The chart expansion control

The chart expansion control

The data is dependent on how you have configured your counters and the type of system you use. For SMP systems, the chart per core disclosure control enables you to expand the data to show collection per core.

Unlike the other charts in the Timeline view, the CPU Activity, GPU Vertex, and GPU Fragments charts are bar charts and the current selection in the processes section affects how they are displayed. When there is an active selection in the processes section the green bars change to reflect CPU activity caused by the selected processes. Streamline still displays the total activity in dark gray so that you can visually compare the selected processes CPU Activity values to the total.

Figure 27. A bar chart with an active selection in the processes section

A bar chart with an active selection in the processes section

Processes

The Processes section of the Timeline view shows you the active processes in each bin. The entries are derived from process/thread trace data from the Linux kernel scheduler. Weighted colors reflect the number of samples in each process or thread.

Figure 28. Process bars

Process bars

White

Not running

Gray

The process has started, but is dormant. It could be sleeping, waiting on user input, or waiting for some other process to finish.

Yellow to red

Responsible for some percentage of total instructions during this bin. Red indicates a higher percentage.

Note

The [idle] process is color-coded differently than the other processes in the Timeline view. When the system is fully idle, it is bright blue. When it is partially idle it is a lighter shade of blue, and when the system is fully active, it appears white.

In addition to the colored bins, the Processes sections contained colored dots that indicate that something triggered the process to delay. The color of the dots displayed depends on the cause of the delay:

Blue

CPU contention caused the display. This can happen if they are too many processes and not enough cores to handle them.

Figure 29. CPU contention dots in the Timeline view

CPU contention dots in the Timeline view

Red

An I/O operation caused the delay. The process stopped while a read or a write to disk occurred.

Green

A mutex triggered the delay.

If you select a process or multiple processes, all the charts in the Timeline view that contain process specific data update to reflect only activity caused by the selected processes. All charts that do not contain the necessary process information are blanked out.

GPU Vertex and Fragment bar charts display only activity initiated by the selected processes. This allows you to differentiate between GPU activity caused by your application and activity resulting from other applications or system services.

Detail bars

The detail bars show functions with the most samples in the currently selected cross-section. Selecting a bar jumps you into the relevant context in the Call Paths view. Double-click on the relevant Capture Data to load more applications and decrease the number of bracketed entries in this list.

The Samples HUD can be turned on and off using the Samples HUD button in the toolbar.

Figure 30. Timeline Detail Bar

Timeline Detail Bar

X-Ray mode

X-Ray mode changes the process trace from an intensity map of time, to a mode that highlights core affinity. In this mode, the bars show the mapping of software threads to processor cores. Streamline supports dual-core and quad-core targets. The colors in X-Ray mode are:

Blue

First core

Turquoise

Second core

Amber

Third core

Purple

Fourth core

Hovering the mouse cursor over a color-coded bin shows you which core the color identifies.

X-Ray mode is useful only in SMP systems. All entries in the processes section appear blue in a single core system report.

Figure 31. X-Ray mode

X-Ray mode

The process filter

The process filter is located on the right-hand side of the toolbar. Enter a regular expression in the field to filter the processes in the processes section of the Timeline view. For example, if you enter a standard string consisting only of letters, the processes section updates to include only [idle], [kernel], and any processes that contain the entered string. Regular expression strings are case sensitive unless you include (?i) in front of your search expression.

The bar charts in the Timeline view update to display only activity from the remaining processes.

Bookmarks

You can create bookmarks in the Timeline view, enabling you to label and quickly return to critical points in the Timeline view. To do so:

  1. Double click in the timeline itself. The timeline is the numbered ruler above the charts in the Timeline view.

  2. Give the new bookmark a title by entering it into the resulting field.

    Figure 32. Adding a bookmark

    Adding a bookmark

  3. Choose a color for the bookmark by clicking on the color selector to the right of the bookmark entry field.

    Figure 33. Choosing a color

    Choosing a color

  4. Use the Color dialog box to choose a color for the new bookmark.

After giving the bookmark a title and color, a bookmark now appears in the timeline. Hover over the bookmark to see an overlay that shows you the title of the bookmark and the time in the capture session. The overlay also provides two buttons:

Edit bookmark

Use this button to change the title or color of the bookmark. Double-clicking on a bookmark has the same effect.

Delete bookmark

Use this button to remove the bookmark from the Timeline.

If you scroll away from the bookmark, you can easily return to it by clicking on the colored mark in the timeline overview.

Figure 34. The bookmark in the timeline overview

The bookmark in the timeline overview

Value pins

In addition to bookmarking you can also place a pin in a particular point in any chart of the Timeline view. To do so, click the Toggle Value Pin Mode button in the toolbar and click on a point in any chart.

Figure 35. A value pin

A value pin

In value pin mode, a gray line appears under your cursor, so that you can more precisely place each pin. Each value pin shows an overlay with the values of the chart at the location of the pin.

Click on a value pin to remove it.

Process focus buttons

The CPU activity, CPU Wait, GPU Vertex, and GPU fragments are special charts types. They have a button on the left side of the chart handle that enables you to select that chart as the current focus of the processes section. By default, this is set to the CPU activity chart.

Figure 36. The Processes Focus button

The Processes Focus button

If you click a Processes Focus button on one of the bar charts, the processes section updates to show a heat map of processes that contributed to activity in the newly selected bar chart. For example, if you click the Processes Focus button on the GPU Vertex chart, the processes section updates to show heat mapped activity for the GPU vertex processor only. The GPU charts are only available if you have captured data on a Mali-400 target and built the gator module to support Mali.

Changing graphics quality

If you find Streamline to be slow and unresponsive, change the graphics quality by following these steps:

  1. Select Window → Preferences.

  2. Use the disclosure control to open DS-5.

  3. Select Streamline from the list under DS-5.

  4. Select the Use highest quality graphics checkbox.

Figure 37. The Timeline view with the Use highest quality graphics option disabled

The Timeline view with the Use highest quality graphics option disabled

By default, the Use highest quality graphics option is active.

Events-based sampling tag

If you use the counter configuration dialog to set up events-based sampling, a blue EBS tag appears in the toolbar of any Analysis Report you create using that configuration.

Figure 38. The Events-based sampling tag

The Events-based sampling tag

The tooltip that appears when you hover the mouse over the EBS tag tells you which counter you set as the basis for the events-based sampling and the threshold value. For more information on events-based sampling, see Events-based sampling.

Was this page helpful? Yes No