The Counter Timeline shows the values of all counters that a given trace file provides. The Intel® Trace Collector records user-defined counters or counters provided by the operating system. Please refer to the Intel Trace Collector documentation to learn more about tracing counters.
Figure 4-20. The settings dialog showing all counters available in the trace with their type and scope
The Counter Timeline as shown in Figure 4-21 shows counters with the scopes Valid BEFORE point, Valid AFTER point, Valid AT point and Curve. The time interval is small enough so that no counter samples are merged over time (Section 9.1). The sample points are indicated by markers.
The sample points for counters with the attribute Curve are connected by line segments. Samples with the attribute Valid AT point are shown by markers. Samples of counters with other scopes are shown by short, unconnected horizontal line segments before or after the sample.
The Counter Timeline as shown in Figure 4-22 shows the same counters as in Figure 4-21 but zoomed out. Notice that there are no markers anymore because the values shown represent samples that were merged over time. To force that effect the View was made very narrow.
When the mouse pointer hovers over the Counter Timeline, its exact position in time is shown in the View's status bar. If the mouse pointer is near a sample point then the respective value is shown.
The Settings dialog box in the Counter Timeline has three tabs - the Preferences tab, the Counters tab and the Processes tab.
Use the controls in this tab to adjust the display settings and the scaling of the Counter Timeline. The tab consists of the groups Display and Vertical Scaling.
The group Display contains the following controls:
Time Scale: This displays a time scale along the x-axis.
Vertical Scale: This scale is on the y-axis. By default, this option is enabled so that the scale is shown.
Legend: This shows the legend in the right margin of the timeline. This is also enabled by default.
Adjust Graphics to Legend Height: This forces the size of the diagram to be large enough to show all legend items.
The combo box showing either Single Diagram or Many Diagrams allows to have either a single diagram for all selected counters and all selected target group children or to create a separate diagram for each target group child.
Use the Vertical Scaling group to switch between the Automatic Scaling (per Diagram), Automatic Scaling (global) and the Manual Scaling of the y-axis. To explicitly specify the minimum and maximum scale values, use Manual Scaling. To visually compare two or more Charts in the same or distinct Views, specify the same bounds for both charts.
This tab holds a list with seven items for each counter provided by the trace file. The top level entry for each counter shows the counter's Name, its Unit, its target Process Group and its Attributes (Figure 4-23). The name and the unit are arbitrary, free format strings defined in the trace file.
The column Process Group contains the counter's target group. A counter that has different values for each process will have the target group All_Processes, while a counter that has a distinct value for each SMP node will have the target group All_Nodes.
The column Attributes can contain the following attributes:
Either Integer or Double, indicating the counter's type.
One of Valid BEFORE Point, Valid AFTER Point, Valid AT Point or Curve indicating the counters scope. Curve indicates that it is meaningful to interpolate values between two given counter values.
The attribute Show Rate, indicating that it is preferable to display the derivation to time instead of the plain counter values.
Nested under the top level entry for a counter, there are six entries for the minimum, average and maximum values and for the minimum, average and maximum rates that allow to switch each on and off independently. If you just use the top level entries check box then either the average value or rate will be chosen depending on the counters attributes.
This tab contains one top-level entry for each target group used in at least one of the counters and a nested entry for each target group's child.
Using the top-level entry for a target group you can switch the entire target group on or off, or go back to the last subset that you selected using the second level entries.
Using the second level entries you can switch on and off arbitrary children of the target group.
The settings for a target group in this tab are applied to all counters with the respective target group.
The context menu of the Counter Timeline provides the common entries as defined in Section 4.8.
The filter mechanism in the Intel Trace Analyzer does not cover counters. Therefore the Counter Timeline is independent of the View's filter settings.