JIT プロファイル API を使用

JIT プロファイルを実行するには、次の操作を行います。

使用するプリミティブ

説明

int iJIT_NotifyEvent( iJIT_JVM_EVENT event_type, void *EventSpecificData );

この API を使用して、Event_type が指すデータとともに EventSpecificData の通知をエージェントに送信します。レポートされた情報は、インテル® VTune™ プロファイラーのコレクターから取得されたサンプルを関連付けるのに使用されます。

unsigned int iJIT_GetNewMethodID( void );

新しいメソッド ID を生成します。この関数を使用して、プロファイラーにレポートされたメソッドに一意で有効なメソッド ID を割り当てる必要があります。

この API は新しい一意なメソッド ID を返します。一意なメソッドが利用できない場合、API 関数は 0 (ゼロ) を返します。

iJIT_IsProfilingActiveFlags iJIT_IsProfilingActive( void );

プロファイラーの現在のモードを返します:iJIT_IsProfilingActiveFlags 列挙子を使用してオフまたはサンプリング。

この API は、デフォルトで iJIT_SAMPLING_ON を返し、サンプリングが実行されていることを示します。プロファイラーが実行されていない場合は、iJIT_NOTHING_RUNNING を返します。

割り当てられたデータの有効性

イベント固有のデータ (構造体) ととともに、エージェント (インテル® VTune™ プロファイラー) にイベント通知を送信します。構造体内のポインターは、割り当てたメモリーを指します (それを解放するのはプログラマーの責任です)。ポインターは、トレースファイル内のデータをコピーするため、iJIT_NotifyEvent メソッドで使用され、iJIT_NotifyEventから戻った後は使用されません。

JIT プロファイル API サンプル・アプリケーション

動的コードの作成と実行をエミュレートするサンプル・アプリケーション、jitprofiling_vtune_amp_xe.zip (Windows*) や jitprofiling_vtune_amp_xe.tgz (Linux*) は、インテル® VTune™ プロファイラーと共にインストールされます。また、この JIT プロファイル API は、動的コードに実行を移行した際に、インテル® VTune™ プロファイラーに通知するために使用されます。

サンプルコードをインストールしてセットアップするには:

  1. 最初に、jitprofiling_vtune_amp_xe.zip (Windows*) や jitprofiling_vtune_amp_xe.tgz (Linux*) ファイルを、<install-dir>\samples\<locale>\C++ (Windows*) または <install-dir>/samples/<locale>/C++ (Linux*) ディレクトリーから書き込み可能なディレクトリーや共有ファイルシステムにコピーします。
  2. アーカイブファイルからサンプルを展開します。

Microsoft* Visual Studio* で jitprofiling.c をビルド

  1. 最初に、jitprofiling_vtune_amp_xe.zip ファイルを、<install-dir>\samples\<locale>\C++ ディレクトリーから書き込み可能なディレクトリーや共有ファイルシステムにコピーします。
  2. サンプルを .zip ファイルから抽出します。
  3. Microsoft* Visual Studio* で jitprofiling.sln ファイルを開きます。
  4. [ソリューション エクスプローラー] で jitprofiling を右クリックして、[プロパティ] を選択します。[jitprofiling プロパティページ] ウィンドウが表示されます。
  5. [プラットフォーム] (ウィンドウの上部) を [x64] に設定します。
  6. [構成プロパティ] > [C/C++] > [全般] を選択し、[追加のインクルード・ディレクトリー] にヘッダーファイルへのパス (<install-dir>/include) を追加します。
  7. [構成プロパティ] > [リンカー] > [全般] を選択し、[追加のライブラリー・ディレクトリー] にライブラリーへのパス (<install-dir>/lib32 または <install-dir>/lib64) を追加します。
  8. [OK] をクリックして変更を適用し、ウィンドウを閉じます。
  9. 新しいプロジェクトの設定でソリューションを再ビルドします。

インストール情報

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

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

オペレーティング・システム <install-dirpath> へのパス

Windows*
  • C:\Program Files (x86)\Intel\oneAPI\
  • C:\Program Files\Intel\oneAPI\

    (特定のシステム)

Linux*
  • /opt/intel/oneapi/root ユーザー
  • $HOME/intel/oneapi/非 root ユーザー

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

上位トピック: JIT プロファイル API

関連情報

JIT プロファイル API について
JIT プロファイル API リファレンス
基本的な使い方と設定