差分レポート

例

この例は、Linux* 上で収集されたホットスポット解析結果 r001hs と r002hs を比較し、解析したアプリケーションの各関数の CPU 時間差を表示します。最適化されたアプリケーション (r002hs) の結果では、新しいメイン関数は 0.010 秒で実行されており、ホットスポット関数 algorithm_2 は 1.678 秒まで最適化されています。

vtune -report hotspots -r r001hs -r r002hs

Function Module Result 1:CPU Time Result 2:CPU Time Difference:CPU Time algorithm_1 matrix 1.225 1.222 0.003 algorithm_2 matrix 3.280 1.602 1.678 main matrix 0 0.010 -0.010

回帰テストの差分レポートを生成

vtune コマンドを使用して、コードの回帰を毎日テストします。

1. ベースラインを作成します。

   • vtune ツールを実行して、特定の解析タイプでターゲットを解析します。次に例を示します:

     Linux*:

     vtune -collect hotspots -- sample

     Windows*:

     vtune -collect hotspots -- sample.exe

     このコマンドは、sample または sample.exe ターゲットのホットスポット解析を実行し、結果を作業ディレクトリーに書き込みます。サマリーレポートは標準出力に書き込まれます。

   • 以降の解析でベースラインとして使用するレポートを生成します。次に例を示します。

     vtune -report hotspots -result-dir r001hs

     これにより、sample または sample.exe ターゲットの各関数の CPU 時間を示すホットスポット・レポートが作成されます。

2. ターゲット・アプリケーションを最適化するため、ソースコードを更新します。

3. スクリプトを作成して実行します。

   • Linux*: vtune インストール・フォルダーへのパスを設定します

   • Windows*: インテル® VTune™ プロファイラーのインストール・フォルダーの sep-vars.cmd を起動して環境を設定します。

   • vtune コマンドを起動してパフォーマンス・データを収集します。

   • vtune コマンドを実行して、現在の結果と初期のベースライン結果を比較し、その差を表示します。次に例を示します:

     vtune -R hotspots -r r001hs -r r002hs

     この例は、結果 r001hs と r002hs の各関数の CPU 時間を比較し、計算結果と両方の結果を並べて表示します。パフォーマンス値間の正差分は、結果 2 に対する改善を示します。また、負差分は回帰を示します。

     注

     同じ解析タイプまたはパフォーマンス・メトリックの結果のみを比較できます。

4. 回帰が検出されない場合、テストは合格です。

5. 定期的に 2 から 4 の手順を繰り返します。

インストール情報

インテル® VTune™ プロファイラーをインストールするには、インストール・ガイドの指示に従ってください。

• Windows* ホスト (英語)
• Linux* ホスト (英語)

インテル® VTune™ プロファイラーをスタンドアロン・コンポーネントとしてダウンロードした場合でも、インテル® oneAPI ベース・ツールキットとしてダウンロードした場合でも、デフォルトのインストール・パス <install-dir> は次のようになります。

インテル® VTune™ プロファイラーのインストール時に、データ収集に必要なサンプリング・ドライバーもインストールされていることを確認してください。