Files
rocm-systems/docs/how-to/analyze/standalone-gui.rst
T
cfallows-amd c45e20f325 Fixes for roofline datatype plot outputs (#659)
Profile mode:
Fix roofline plots for datatypes that have peakVALU only. Check for highest roofline to plot the bandwidth lines to proper height, don't rely on existence of peakMFMA for every datatype.
Analyze mode:
Add roofline-data-type option for viewing pdfs in standalone gui. Default is same as profile mode, FP32.

---------

Signed-off-by: Carrie Fallows <Carrie.Fallows@amd.com>
2025-04-07 12:10:37 -04:00

95 lines
4.1 KiB
ReStructuredText

.. meta::
:description: ROCm Compute Profiler analysis: Standalone GUI
:keywords: Omniperf, ROCm, profiler, tool, Instinct, accelerator, GUI, standalone, filter
***********************
Standalone GUI analysis
***********************
ROCm Compute Profiler's standalone analysis GUI is a lightweight web page that you can
generate straight from the command line. The standalone analysis GUI is an
alternative to the CLI if you want to explore profiling results visually, but
without the additional setup requirements or server-side overhead of ROCm Compute Profiler's
detailed :doc:`Grafana interface <grafana-gui>` option. This analysis
option is implemented as a simple `Flask <https://flask.palletsprojects.com>`_
application that lets you view results from your preferred web browser.
.. note::
A point on *port forwarding*: the standalone GUI analyzer publishes its
web-based interface on port ``8050`` by default. On production HPC systems
where profiling jobs run under the control of a resource manager, additional
SSH tunneling between the desired web browser host (such as a login node or
remote workstation) and compute host may be required. Alternatively, you
might find it more convenient to download profiled workloads to perform
analysis on a local system.
See the :doc:`/reference/faq` for more details on SSH tunneling.
Launch the standalone GUI analyzer
----------------------------------
To launch the ROCm Compute Profiler GUI analyzer, include the ``--gui`` flag with your
desired analysis command. For example:
.. code-block:: shell-session
$ rocprof-compute analyze -p workloads/vcopy/MI200/ --gui
__ _
_ __ ___ ___ _ __ _ __ ___ / _| ___ ___ _ __ ___ _ __ _ _| |_ ___
| '__/ _ \ / __| '_ \| '__/ _ \| |_ _____ / __/ _ \| '_ ` _ \| '_ \| | | | __/ _ \
| | | (_) | (__| |_) | | | (_) | _|_____| (_| (_) | | | | | | |_) | |_| | || __/
|_| \___/ \___| .__/|_| \___/|_| \___\___/|_| |_| |_| .__/ \__,_|\__\___|
|_| |_|
Analysis mode = web_ui
[analysis] deriving rocprofiler-compute metrics...
Dash is running on http://0.0.0.0:8050/
* Serving Flask app 'rocprof_compute_analyze.analysis_webui' (lazy loading)
* Environment: production
WARNING: This is a development server. Do not use it in a production deployment.
Use a production WSGI server instead.
* Debug mode: off
* Running on all addresses (0.0.0.0)
WARNING: This is a development server. Do not use it in a production deployment.
* Running on http://127.0.0.1:8050
* Running on http://10.228.33.172:8050 (Press CTRL+C to quit)
At this point, you can launch your web browser of choice and navigate to
``http://localhost:8050/`` to view the analysis interface.
.. image:: ../../data/analyze/standalone_gui.png
:align: center
:alt: ROCm Compute Profiler standalone GUI home screen
:width: 800
.. tip::
To launch the standalone GUI analyzer web app on a port other than ``8050``,
include the optional argument ``--gui <desired port>``.
When no filters are applied, you'll see five basic sections derived from your
application's profiling data:
#. Memory Chart Analysis
#. Empirical Roofline Analysis
Use ``--roofline-data-type`` option to specify which datatype(s) you would like displayed on the roofline PDFs in the standalone analysis GUI.
Datatypes can be stacked- for example, "--roofline-data-type FP32 FP64 I32" would display one PDF with FP32 and FP64 stacked, and one PDF with INT32.
Default roofline datatype plotted is FP32.
#. Top Stats (Top Kernel Statistics)
#. System Info
#. System Speed-of-Light
To dive deeper, use the dropdown menus at the top of the screen to isolate
particular kernels or dispatches. You should see the web page update with
metrics specific to your selected filters.
Once a filter is applied, you'll see several additional sections become
available with detailed metrics specific to that area of AMD hardware. These
detailed sections mirror the data displayed in ROCm Compute Profiler's
:doc:`Grafana interface <grafana-gui>`.