--- title: 'Intel Trace Analyzer / Collector' taxonomy: category: - docs external_links: process: true no_follow: true target: _blank mode: active --- [toc] ## 利用環境{#enviroment} ### 利用できるバージョン・システム{#version} バージョン | システムA | システムB | システムC ---------------------------- | ----- | ----- | ----- Trace Analyzer 2022 (default) | ― | + | + Trace Analyzer 2021 | ― | + | + \+ : 利用可能 ― : 利用不可 ### 環境設定{#modules} バージョン | moduleファイル名 ------------------------ | --------------- 2022 | iutils/xe2022 2021 | iutils/xe2021 [Intelコンパイラ](/compilers/intel) が利用できる状態で、以下のようにmoduleコマンドを実行してください。 ```nohighlight $ module load iutils ``` moduleコマンドの詳細は [Modules](/config/modules) をご覧ください。 Intel Trace Analyzer / Collector を使用してプログラムを実行すると、計算ノードのテンポラリ領域(/tmp)に生成されたデータが出力されます。計算ノードの /tmp の容量には限りがあるため、データが溢れてしまい、プログラムの実行結果に影響が出る場合があります。データの出力先を、環境変数TMPDIRで指定したディレクトリに変更できますので、LARGE領域などを出力先として利用してください。 **(設定例)** ```nohighlight (tcsh の場合) $ setenv TMPDIR /LARGE0/gr19999/b59999/output (bash の場合) $ export TMPDIR=/LARGE0/gr19999/b59999/output ``` ## 利用方法{#usage} ### コマンド{#command} コマンド | 説明 --------------- | ----------------------- traceanalyzer | Trace Analyzerを起動します。 ## 利用例{#sample} ### コンパイル時にトレースファイルの取得を指示する方法{#sample_compile} 1. コンパイル Intel Trace Analyzer / Collectorを使用する場合、 **-trace** オプションを指定してコンパイルを行ってください。 ```nohighlight $ mpiicc test.c -trace ``` 2. 実行 **-trace** オプションを指定してコンパイルしたプログラムを実行すると、トレース情報が記録された **stfファイル** が作成されます。以下の例では、tssrun コマンドを使用して、会話型で実行しています。 ```nohighlight $ tssrun -A p=4 mpiexec.hydra ./a.out Job <582271> is submitted to queue <tb>. <<Waiting for dispatch ...>> <<Starting on gb-0004>> [0] Intel(R) Trace Collector INFO: Writing tracefile a.out.stf in /home/b/b59999/ ``` 2. Intel Trace Analyzer / Collector でのトレース結果確認 [Exceed onDemand](/login/eod) など X(GUI)が利用できる環境で、出力された **stfファイル** を指定して **traceanalyzer** コマンドを実行するとIntel Trace Analyzerが起動します。 ```nohighlight $ traceanalyzer a.out.stf ``` 下図は、 **Charts** => **Event Timeline** でタイムライン表示を行った例です。 ![](traceanalyzer_01.png) ### 実行時にトレースファイルの取得を指示する方法{#sample_exec} 1. コンパイル 通常と同じ手順でコンパイルを行ってください。 ```nohighlight $ mpiicc test.c ``` 2. 実行 **-trace** オプションを指定して実行すると、トレース情報が記録された **stfファイル** が作成されます。以下の例では、tssrun コマンドを使用して、会話型で実行しています。 ```nohighlight $ tssrun -A p=4 mpiexec.hydra -trace ./a.out Job <582271> is submitted to queue <tb>. <<Waiting for dispatch ...>> <<Starting on gb-0004>> [0] Intel(R) Trace Collector INFO: Writing tracefile a.out.stf in /home/b/b59999/ ``` 2. Intel Trace Analyzer / Collector でのトレース結果確認 [Exceed onDemand](/login/eod) など X(GUI)が利用できる環境で、出力された **stfファイル** を指定して **traceanalyzer** コマンドを実行するとIntel Trace Analyzerが起動します。 ```nohighlight $ traceanalyzer a.out.stf ``` ## マニュアル{#manual} <!-- no longer supprted ### バージョン8.0{#8_0} * [IntelR Trace Analyzer and Collector for Linux* OS Getting Started Guide](https://web.kudpc.kyoto-u.ac.jp/Compiler_Manual/Intel/Trace_Analyzer_and_Collector_8_0/Getting_Started.html) * IntelR Trace Analyzer Reference Guide [HTML](https://web.kudpc.kyoto-u.ac.jp/Compiler_Manual/Intel/Trace_Analyzer_and_Collector_8_0/html/) / [PDF](https://web.kudpc.kyoto-u.ac.jp/Compiler_Manual/Intel/Trace_Analyzer_and_Collector_8_0/ITA_Reference_Guide.pdf) * [IntelR Trace Collector Reference Guide](https://web.kudpc.kyoto-u.ac.jp/Compiler_Manual/Intel/Trace_Analyzer_and_Collector_8_0/ITC_Reference_Guide.pdf) * [Frequently Asked Questions for the IntelR Trace Analyzer and Collector](https://web.kudpc.kyoto-u.ac.jp/Compiler_Manual/Intel/Trace_Analyzer_and_Collector_8_0/FAQ.pdf) ### バージョン8.1{#8_1} * [IntelR Trace Analyzer and Collector for Linux* OS Getting Started Guide](https://web.kudpc.kyoto-u.ac.jp/Compiler_Manual/Intel/Trace_Analyzer_and_Collector_8_1/Getting_Started.html) * IntelR Trace Analyzer Reference Guide [HTML](https://web.kudpc.kyoto-u.ac.jp/Compiler_Manual/Intel/Trace_Analyzer_and_Collector_8_1/ITA_Reference_Guide.htm) / [PDF](https://web.kudpc.kyoto-u.ac.jp/Compiler_Manual/Intel/Trace_Analyzer_and_Collector_8_1/ITA_Reference_Guide.pdf) * IntelR Trace Collector Reference Guide [HTML](https://web.kudpc.kyoto-u.ac.jp/Compiler_Manual/Intel/Trace_Analyzer_and_Collector_8_1/ITC_Reference_Guide.htm) / [PDF](https://web.kudpc.kyoto-u.ac.jp/Compiler_Manual/Intel/Trace_Analyzer_and_Collector_8_1/ITC_Reference_Guide.pdf) * [Frequently Asked Questions for the IntelR Trace Analyzer and Collector](https://web.kudpc.kyoto-u.ac.jp/Compiler_Manual/Intel/Trace_Analyzer_and_Collector_8_1/FAQ.pdf) ### バージョン9.1{#9_1} * [IntelR Trace Analyzer and Collector for Linux](https://web.kudpc.kyoto-u.ac.jp/Compiler_Manual/Intel/Trace_Analyzer_and_Collector_9_1/Doc_Index.htm) --> ### Ver.2018 * [Intel Trace Analyzer and Collector for Linux](https://web.kudpc.kyoto-u.ac.jp/Compiler_Manual/Intel/Trace_Analyzer_and_Collector_2018/intel-trace-analyzer-2018-user-and-reference-guide.pdf) ### Ver.2019 * [Intel Trace Analyzer for Linux Reference Guide](https://web.kudpc.kyoto-u.ac.jp/Compiler_Manual/Intel/intel_parallel_studio_xe_2019_3/en/itac/ita_user_reference_guide.htm) * [Intel Trace Collector for Linux Reference Guide](https://web.kudpc.kyoto-u.ac.jp/Compiler_Manual/Intel/intel_parallel_studio_xe_2019_3/en/itac/itc_user_reference_guide.htm)