report

解析結果から指定するタイプのレポートを生成します。

GUI オプション

ビューポイント

構文

-report <report_name>

-R <report_name>

引数

引数

説明

<report_name>

作成するレポートのタイプです。
affinity
ソケット、物理コア、および論理コアへのスレッドのバインディングを表示します。
callstacks
ホットスポット関数ごとのスタックデータがすべてレポートされます。関数の CPU や待機時間で各スタックの影響を特定します。グループ化またはフィルター処理オプションを使用して次の条件でデータをソートします。
  • callstack

  • function

  • function-callstack

exec-query
gprof-cc
関数とその子関数で費やされた時間 (可能であれば、CPU と待機時間) と呼び出しツリーをレポートします。
hotspots
選択された解析タイプに対応するパフォーマンス・メトリックを表示し、最も CPU 時間がかかったプログラム単位 (ホットスポット) を特定します。
hw-events
ハードウェア・イベントの合計数を表示します。
platform-power-analysis
CPU スリープ時間、ウェイクアップの理由、CPU 周波数スケーリング時間を表示します。
summary
ターゲットのパフォーマンス概要をレポートします。
timeline
時間の経過に伴うメトリックデータと時間間隔にわたって分散されたメトリックデータを表示します。
top-down
アプリケーションの始まり (通常、main() 関数) から、収集フェーズで検出された呼び出しシーケンス (スタック) をレポートします。このレポートからプログラム単位と呼び出し先の影響を確認します。
vectspots
HW シミュレーター上でトレースするコード領域を特定するのに役立つ統計情報を表示します。

修飾子

call-stack-modecsv-delimitercumulative-threshold-percentdiscard-raw-datafilterformatgroup-byinline-modelimitquietreport-outputresult-dirsearch-dirsource-search-dirsource-objectverbosetime-filterloop-modecolumn

説明

既存の結果からレポートを生成するには、report アクションを使用します。レポートタイプは、収集で使用された解析タイプと互換性がある必要があります。

デフォルトでは、レポートは stdout に書き込まれます。ファイルに保存する場合、report-output アクションオプションを使用します。

短縮名と通常の名前では大文字と小文字が区別されます。例えば、-Rreport アクションの短縮名で、-rresult-dir アクションオプションの短縮名です。

利用可能なレポートタイプのリストを取得するには、vtune -help report コマンドを使用します。

特定のレポートタイプのヘルプを表示するには、vtune -help report <report_name> を実行します。ここで、<report_name> は生成するレポートタイプです。

この組み合わせの例では、collect アクションを使用して Linux* の sample ターゲットのホットスポット解析を実行して、その結果を現在の作業ディレクトリーに書き込みます。2 番目のコマンドは、report アクションを使用して最新の結果から hotspots レポートを生成し、stdout に書き込みます。

vtune -collect hotspots -- /home/test/sample
vtune -R hotspots

ホットスポット解析からホットスポット・レポートを作成し、モジュールごとにデータをグループ化します。

vtune -R hotspots -result-dir r001hs -group-by module

foo 関数のホットスポットのパフォーマンス・メトリックを含むソース表示を開き、ソースファイルを検索するため C:\test\my_sources ディレクトリーを使用します。

vtune -R hotspots  -source-object function=foo -r r001hs -source-search-dir C:\test\my_sources

スレッド化解析の結果 r003tr に全関数のスタック情報を書き込みます。データはコールスタックでグループ化されます。

vtune -R callstacks -r r003tr -group-by callstack

関連情報