インテル® VTune™ プロファイラーと Docker イメージをインストールし、同じコンテナーで実行されるネイティブまたは Java* アプリケーションをプロファイルします。
Docker イメージの設定:
インテル® VTune™ プロファイラーを同梱するインテル® oneAPI ベース・ツールキットがインストールされている場合、Docker Hub リポジトリーから既存の Docker イメージを取得できます。
host> image=amr-registry.caas.intel.com/oneapi/oneapi:base-dev-ubuntu20.04 host> docker pull "$image"
コンテナーからのプロファイルを有効にし、すべてのホストプロセスを表示できるようにするには、次のように --pid=host を指定して Docker イメージを実行します。
host> docker run --pid=host --cap-add=SYS_ADMIN --cap-add=SYS_PTRACE -it "$image"
ここで、SYS_ADMIN 値はハードウェア・イベントベース・サンプリング解析の実行を有効にし、SYS_PTRACE 値はユーザー・モード・サンプリング解析を有効にします。
インテル® VTune™ プロファイラーがインストールされているコンテナーで実行されるアプリケーションをプロファイルするには、次の操作を行います。
アプリケーションを実行中の Docker コンテナーにコピーします。次に例を示します:
host> docker cp /home/samples/matrix.tar 98fec14f0c08:/var/local 、ここで 98fec14f0c08 はコンテナー ID です。
必要に応じて、コンテナーでターゲットをコンパイルします。
インテル® oneAPI ベース・ツールキットが事前インストールされた Docker イメージを使用する場合、これらの手順は必要ありません。
Docker コンテナーにインテル® VTune™ プロファイラーのコマンドライン・インターフェイスをインストールします。
[2] Custom installation > [3] Change components to install を選択して、コンテナー環境に必要がないコンポーネントのインストールを解除します: [3] Graphical user interface と [4] Platform Profiler を選択します。
インストール後、インテル® VTune™ プロファイラーの環境変数を設定します。例えば、インテル® oneAPI ベース・ツールキットのインテル® VTune™ プロファイラーでは以下を実行します。
container> source /opt/intel/oneapi/vtune/version/env/vars.sh
以下に示すターゲットと解析タイプを使用して、コンテナーで実行されるターゲットの解析を設定します。
ターゲットタイプ |
解析タイプ |
|---|---|
|
|
解析を実行するには、次のコマンドを使用します。
vtune -collect <analysis_type> [options] -- [container_target]
次に例を示します:
container> vtune -collect hotspots -knob sampling-mode=hw -- /home/samples/matrix
以下に示すターゲットと解析タイプを使用して、ホストで実行されるターゲットの解析を設定します。
ターゲットタイプ |
解析タイプ |
|---|---|
|
|
解析を実行するには、次のコマンドを使用します。
vtune -collect <analysis_type> [options] -- [host_target]
次に例を示します:
container> vtune -collect hotspots -target-process java
既知の問題:
問題: 関数レベルの解析はデフォルトでは利用できません。インテル® VTune™ プロファイラーは、サンプルをユーザーのターゲット・アプリケーションのバイナリーに対応付けますが、ホストのバイナリーをコンテナーから参照できないため、関数を解決できません。
解決方法: バイナリーを含むマウントされたホストフォルダーで Docker* コンテナーを実行し、vtune コマンドの引数に検索ディレクトリーを指定します。vtuneコマンドを実行します。
問題: インテル® VTune™ プロファイラーがコンテナー内では root ユーザーで実行され、ホスト上のアプリケーションは非 root ユーザーで実行されます。その結果、「ターゲットとインテル® VTune™ プロファイラーを同じユーザーで実行する必要があります」 というエラーメッセージが出力され実行できなくなりました。
解決方法: 同じユーザーがコンテナーでインテル® VTune™ プロファイラーを実行し、コンテナー外でターゲット・アプリケーションを実行していることを確認してください。