Intel® SoC Watch and Intel® VTune™ Profiler
Step 1: Configure and Install on Target System
Select the installer for your target platform. The target installer for Intel Soc Watch is located in the folder: C:\Program Files (x86)\Intel\oneAPI\socwatch\latest\socwatch_for_target.
Copy the Intel® SoC Watch installer (<install_dir>\target\windows_socwatch\socwatch_windows_<version> .msi) to the target Windows system.
Run the installer on the target system. The package includes a user's guide, and an End User License Agreement. By default, the Intel SoC Watch collector is installed in the C:\Program Files (x86)\Intel\SoCWatch directory.
Navigate to the Intel SoC Watch installation directory.
Alternatively, set your PATH environment variable to point to the installed bin directory containing socwatch.exe any of the following ways:
- Update the PATH variable in the Control Panel.
- Execute set PATH=<value>;%PATH% command to temporarily set the variable in the current command prompt.
Now you are ready to begin collection.
NOTE:
You need root access to run Intel® SoC Watch.
- Select the installer for your target platform. The target installer for Intel Soc Watch is located in the folder: /opt/intel/oneapi/socwatch/latest/socwatch_for_target
In this example we will use your Linux host as the target, but you can copy the SoC Watch collector to a different Linux target. Extract the installer /opt/intel/oneapi/socwatch/socwatch_linux_<version>_x86_64.tar.gz to a directory.
For example, run the following command to install SoC Watch:
sudo tar zxvf socwatch_linux_<version>_x86_64.tar.gz -C /opt/intel/Navigate to the Intel SoC Watch installation directory.
Alternatively, set your PATH environment variable to point to the installed bin directory containing socwatch.
- Navigate to /opt/intel/socwatch_linux_<version>_x86_64 and source the setup_socwatch_env.sh script.
- Build the SoC Watch driver using the following command:
sudo -E ./builddriver -l -n - Install the SoC Watch driver using the following command:
sudo insmod drivers/socwatch2_10.ko
For more information, including additional configuration options, see the Intel SoC Watch User's Guide located in the directory in which the collector is installed or available onlineavailable online.
Step 2: Collect Data
- Open a command prompt with administrativeroot privileges on the target system with Intel® SoC Watch installed.
Run the command below to capture CPU time in low power states over a 60-second period and import the result to the Intel® VTune™ Profiler.
socwatch -t 60 -f cpu-cstate -m -o results/test -r vtuneThe report file is saved to the results directory as test.pwr.
Step 3: View Results
When collection completes, a message appears with the location of the result files. In this example, the summary report is located in the current directory in the results/test.pwr file.
Copy the report file test.pwr from the target system to the host system.
Import the file to the Intel® VTune™ Profiler project:
Launch Intel VTune Profiler GUI on the host system. From a terminal window, go to <install_dir>/oneapi/vtune/latest/vtune-gui
Create a new project or open an existing one.
Click
Import Result and navigate to the test.pwr file. The results are opened in the default Platform Power Analysis viewpoint.
For detailed information about using Intel SoC Watch, see the Energy Analysis User Guide .