Thread View (vtl)Thread View (vtl)This information applies to the command-line interface (vtl) only.
Use this option to view the sampling data by thread.
To view all threads for all events in the Activity result from the command line, use the -threads option.
Command-line example:
>vtl view a0::r0 -threads
where a0 - Activity name, r0 - Activity result name.
The VTune(TM) Performance Analyzer displays a system-wide view of all the threads running on your system. Collected data are displayed in the table format:
Column Heading |
Description |
|---|---|
|
Thread |
Thread name. This is an arbitrary name and is not related to the actual thread name. |
|
Process |
Process name to which the thread belongs. |
|
TID |
Operating system Thread ID (by default shown in hex). |
|
PID |
Operating system Process ID (by default shown in hex). |
|
Event |
The name of the event which triggered the samples on this thread. |
|
Samples |
The number of samples collected on this thread for the specified process and event. |
|
Events |
Event count which is equal to Samples column * sample after value for selected event. |
|
%Selection
|
Percent of samples with respect to total samples shown in this view. |
|
%Total |
Percent of samples with respect to total samples collected during the entire duration of the Activity. |
|
CPU |
The CPU number on which the sample was recorded. To view this column, use the -cpu option. |
|
EventId |
Every event can be referred to by its name as shown in the Event column or by EventId. To view this column, use the -cl option. To view this column instead of the Event name, use -sc option and then -cl. |
These additional options enable formatting the thread table.
To see a complete list of thread options, enter the following:
vtl -help -v sampling
To view columns supported by a view, use the -supported-columns (or -sc) option. By default, only the main columns are shown. Use this option to specify any specific columns you wish to view.
Command-line example:
vtl view -threads -sc
This generates a comma separated list of supported columns. For every numeric column (except the % columns), there is an associated format. For example, TID:hex means show the TID column in hex.
To configure the column layout, use the -column-layout (or -cl) option and specify columns to be visible on the view as <COL1[:FORMAT1]>[,col2,...].
Command-line example:
>vtl view -thread -cl ”r;Thread,Process,Event,Samples,TID:dec”
This command generates a table with the following columns: Thread, Process, Event, Samples, TID, and the format of TID is decimal, instead of the default hex.
See Also Other Options: