group-by

レポートのグループ化を指定します。

GUI オプション

[ボトムアップ] タブ > [グループ化] ドロップダウン・メニュー

構文

-group-by <granularity1>,<granularity2>

引数

<granularity>

グループ化レベルはレポートタイプに依存します。

デフォルト

レポートによって異なります。function は、最も一般的なデフォルトです。

影響するアクション

report

説明

レポートのデータをグループ化する条件を指定するには、group-by アクションオプションを使用します。複数のグループレベルを指定する場合、空白なしのカンマで区切って引数を追加します。

レポートによっては (例えば、top-down レポート)、単一のグループ化レベルのみが指定できます。

特定のレポートタイプに使用できるグループを表示するには、次のように入力します。
vtune -report <report_name> -r <result_dir> group-by=?結果ディレクトリーを指定しない場合、最後に使用した結果がデフォルトで使用されます。

function 値は、関数とモジュールの両方で結果データをグループ化します。関数のみをグループ化するには、function-only を使用します。

最新の結果をモジュールごとにグループ化したホットスポット・レポートを出力します。

vtune -report hotspots -group-by module

最新の結果のホットスポット・レポートを、スレッドと関数ごとにグループ化したデータを表示します。

vtune -report hotspots -group-by thread,function

Linux* でホットスポット解析結果が利用できるすべてのホットスポット・レポート・グループを表示します。


    vtune -R hotspots -r /temp/test/r029hs/r029hs group-by=?
    vtune: Using result path '/temp/test/r029hs/r029hs'

    Available values for '-group-by' option are:

    basic-block : Basic Block
    function : Function
    function-mangled : Function
    module : Module
    module-path : Module Path
    process : Process
    thread-id : TID
    process-id : PID
    source-file : Source File
    source-line : Source Line
    source-file-path : Source File Path
    thread : Thread
    callstack : Call Stack
    cpuid : Logical Core
    address : Code Location
    function-start-address : Start Address
    source-function : Source Function
    package : Package
    source-function-stack : Source Function Stack
    core : Physical Core
    class : Class
    cacheline : Cacheline
    data-address : Data Address
    tasks-and-interrupts : Task and Interrupt
    context : Context
    vcore : VCore
    The following items can be specified only as the final grouping level: callstack, source-function-stack.

関連情報