Use techniques in this recipe to view analysis results from Intel® VTune™ Profiler in a web browser, particularly on systems where you cannot install VTune Profiler to run the analyses.
Typically, you install VTune Profiler on a host machine and use it to profile an application target on the same machine. Sometimes the host and target operating systems may be different. Depending on the specific operating environment, you may not be able to open the VTune Profiler GUI on the host machine, with access limited to the command line only. If you use a macOS* system, you cannot run VTune Profiler for data collection or viewing, as the platform is not supported. When you are unable to use the VTune Profiler user interface, you can open analysis results in a web browser instead.
Use a web browser to view analysis results when:
Content expert: Jennifer DiMatteo
Application: matrix sample available with the installation of VTune Profiler
Tools: Intel® VTune™ Profiler version 2023 or newer
Browser: Google Chrome*
Operating system: Windows* 11 Enterprise, Ubuntu 22.04
To use Intel® VTune™ Profiler web server, choose a system that has:
Additionally, when you profile remote systems, ensure these details:
This example uses an installation of Intel® VTune™ Profiler on a Linux system.
Option | Purpose |
---|---|
web-port | This port must be accessible by remote connections. If this port is not specified, Intel® VTune™ Profiler chooses a random port that is available. |
data-directory | Intel® VTune™ Profiler searches for results in this directory. By default, this is in the home directory of the user who started the web service. If you provide a custom directory, ensure that the user starting the web service has access to the custom directory. |
enable-server-profiling | This option enables the web service to profile the server on which it runs. |
allow-remote-access | Use this option to enable browser access from systems other than localhost. |
$ vtune-backend –web-port=8080 –data-directory=/mnt/vtune-results/ --enable-server-profiling –allow-remote-access &
C:\Program Files (x86)\Intel\oneAPI\vtune\latest\bin64\vtune-backend --web-port=55012 --allow-remote-access --enable-server-profiling
When the web service begins, a URL displays which you can paste into your local browser. If this is the first time you are starting web service on the system, the URL contains a one-time token you use to set a security passphrase.
The installation package of Intel® VTune™ Profiler includes a matrix multiply sample with results. If you use the default data directory, these results display in the user interface on the browser.
You can run a data collection in these ways:
Method | Notes |
---|---|
Run a collection on the web server. | Use the default settings in the WHERE pane. |
Configure a remote system. | You must install the collection agent on the target. You can do this manually or automatically. For more information, see Deploy the Intel® VTune™ Profiler Agent . |
Run a collection on the target and copy results over. | Install Intel® VTune™ Profiler manually on the target OS. Run a data collection and then copy the results into the data directory of the server. This method is useful if remote collection is not possible due to SSH or permission issues. You can also use this method to view results without needing to run a new data collection. |
This example demonstrates the first method to run a Hotspots analysis on the matrix sample on the web server. For this purpose, create a new project (called new_test) so you can see how results are structured on the server:
Once results have been collected, they are available in the new_test data directory:
When you collect or open Intel® VTune™ Profiler results this way, you do not install or copy anything onto your local system. Intel® VTune™ Profiler and the collected results exist only on the remote devcloud system.