コマンドラインから結果をインポート

インテル® VTune™ プロファイラーのコレクター (SEP コレクターやインテル® SoC Watch コレクターなど) または Linux* Perf コレクターでパフォーマンス・データをリモート収集して、結果をインテル® VTune™ プロファイラーのプロジェクトにインポートしてグラフィカル・インターフェイスまたはコマンドライン・インターフェイスで表示できます。データ収集ファイルのインポートには import アクションを使用します。現在サポートされているデータ形式を以下に示します。

• *.tb6/*.tb7(低レベルの SEP コレクターで収集された生データファイル)
• *.perf(Perf* データファイル)
• *.csv(事前定義された形式の外部データのインポートファイル)
• *.pwr(電力解析データを含むインテル® SoC Watch で処理されたファイル)

• Linux* Perf* ツールによって収集されたイベントベースのサンプリング・データを含む*.perfファイルをインポートする要件
• パフォーマンス・プロファイラーの結果をインポートしてデータを表示
• エネルギー解析の結果をインポートしてデータを表示

*.perf ファイルをインポートする必要条件

Linux* Perf ツールで収集されたハードウェア・イベントベース・サンプリング・データを含む *.perf ファイルをインポートするには、事前定義されたコマンドライン・オプションを使用して Perf 収集を行います。

• アプリケーション解析の場合:

  $ perf record -o <trace_file_name>.perf -call-graph dwarf -e cpu-cycles,instructions <application_to_launch>

• プロセッサー解析の場合:

  $ perf record -o <trace_file_name>.perf -call-graph dwarf -e cpu-cycles,instructions <application_to_launch> -p <PID> sleep 15

ここで、-e オプションは、収集するイベントのリストを -e <list of events> として指定します。--call-graphオプションは、サンプルが取得された時点にスレッドのコールスタックを同時に収集することを指定します。利用可能なコールスタック収集オプション (例えば、dwarf) と各種 OS カーネルバージョンでの可用性については、Linux* Perf* のドキュメントを参照してください。

パフォーマンス・プロファイラーの結果をインポートしてデータを表示

1. 結果をローカルシステムにコピーします。
2. import アクションを使用して必要なファイルをインポートし、インポートした結果ディレクトリーを検索ディレクトリーとして設定します。

   vtune -import <result_path> -source-search-dir <search_path> -r <result_dir>

   result-dir オプションを使用しないと、インテル® VTune™ プロファイラーはデフォルト名を使用して、現在の作業ディレクトリーに新しいディレクトリーを作成します。

   注

   外部データの CSV ファイルをインポートするには、-result-dirオプションを使用して、外部収集と並行してインテル® VTune™ プロファイラーによって収集された結果ディレクトリー名を指定します。インテル® VTune™ プロファイラーは、外部で収集された統計情報を結果に追加して、[タイムライン] ペインに統合したデータを表示します。

3. コマンドラインを使用して、インポートされた結果をインテル® VTune™ プロファイラーの GUI に表示したり、レポートを作成できます。

   • GUI:

     vtune-gui <result_dir>/<result>.vtune

   • CLI:

     vtune -report <report_type> -result-dir <result_dir>/<result>.vtune

   注

   • モジュールを解決するためシンボルファイルとバイナリーファイルの場所を指定するには、search-dir アクションオプションを使用します。

   • Linux* ターゲットでは、コンパイルとリンクで -g オプションを指定して、バイナリーファイルのデバッグ情報を生成します。これにより、インテル® VTune™ プロファイラーは正確なパフォーマンス・データを収集できます。

   • 結果のサイズを小さくするため、discard-raw-data アクションオプションを使用できますが、これにより結果の再ファイナライズができなくなります。

   • インポートされた結果ファイルには、インテル® VTune™ プロファイラーの結果ファイルに含まれるすべてのフィールドが提供されない可能性があるため、レポートで一部のデータが欠落することがあります。

電力解析の結果をインポートしてデータを表示

次のコマンドを実行して、インテル® SoC Watch トレースデータを含むプロジェクトを作成します。

vtune –import <path_to_file> -result-dir <project_folder>

ここで、<project_folder> は、インテル® VTune™ プロファイラー のプロジェクト・ディレクトリーです。例えば、r001 、または結果ディレクトリーへのフルパス。例えば、Linux* では/root/intel/vtune/projects/my_project/r001 など)。

現在のディレクトリー以外のディレクトリーにプロジェクトを作成するため、プロジェクト名にパスを含めることができます。

インテル® VTune™ プロファイラーが起動して、[プラットフォーム電力解析] ビューポイントでプロジェクトが自動的に開きます。

vtune -import /home/Import/r001.tb6 -search-dir /home/import/r001hs

vtune -report callstacks -result-dir /home/import/r001hs -search-dir /home/import/binaries