Querying Activity Data (vtl)

This information applies to the command-line interface (vtl) only.

To get more data on an Activity, data collectors, views, supported import file types, and the name of the current project file, use the query command and any of the options listed below:

vtl query

• [-lc | -list-collectors]

• [-r | -remote <system>]

• [{-c | -collector <type>} {-dof | -dump-options-to-file <filename>}]

• [-lv | -list-views]

• [{-v | -view <type>} {-dof | -dump-options-to-file <filename>}]

• [-li | -list-importers]

• [-p | -project]

• [-a | -activity [<name>]]

Collector Query

The -list-collectors (or -lc) option displays a list of available collectors.

Command-line example:

>vtl query -lc

List of data collectors available:

sampling

To see data collectors for a remote system, use the -remote (or -r) option, specify the system name as username@IP_address, and enter the password upon request.

Command-line example:

>vtl query -lc -r vtune@10.125.21.51

List of data collectors available:

sampling

call graph

To get collector-specific data, use the -collector (or -c) option and specify the collector name.

Command-line example:

>vtl query -c sampling

This example will display sampling collector options and their descriptions, and will list processor events.

View Query

The -list-views (or -lv) option displays a list of available views.

Command-line example:

>vtl query -lv

List of views available:

sampling

To get view-specific data, use the -view (or -v) option and specify the view name.

Command-line example:

>vtl query -v sampling

This example displays sampling view options and their descriptions.

Importer Query

The -list-importers (or -li) option provides the list of file formats that can be imported into your vtl project using the import command.

Command-line example:

>vtl query -li

Importers are available for following file types:

Sampling Result Files (*.tb5)

Project Query

The -project (or -p) option shows the current project file being used by vtl.

Command-line example:

>vtl query -p

Project file: /home/user/VTune/Projects/vtldefault.vpj

Note

Use the project command to change the default project.

Activity Query

The -activity (or -a) option provides detailed information for a specified Activity <name>. You can specify the name you assigned to your Activity or a shortcut Activity name ([a]number), which the VTune(TM) Performance Environment provides. To view the shortcut Activity name, use the show command.

Command-line example:

1. View the contents of the project.

>vtl show

a1__MyActivity1

    r1____callgraph Results - Fri Oct 25 17:48:45 2002

a2__MyActivity2

    r1____Sampling Results - Fri Oct 25 17:54:12 2002

2. Query the data for the required Activity.

>vtl query -a a1

Name: MyActivity1

Duration: 20 sec

Start with data collection paused: no

Application/Module Profiles:

  1. cat

    Application to Launch:

      Filename: /bin/cat

      System on which to launch application: <localhost>

  2. Modules of Interest

    Modules of Interest:

      1. /bin/cat

Data Collectors:

  1. callgraph

    Collector type: callgraph

    Master: no

    Enabled: yes

    Associated with the following Application/Module Profiles:

      1. cat

      2. Modules of Interest

    Options:

Folder with call graph configuration files (*.ini) for this activity:

/home/vtune/.VTune/vtune/cgECC899E/