From f5f0bacd53d22ed1ff25c46ea23d09cc521be589 Mon Sep 17 00:00:00 2001 From: Peter Park Date: Thu, 3 Oct 2024 13:55:30 -0400 Subject: [PATCH] find/replace Omniperf to ROCm Compute Profiler Signed-off-by: Peter Park --- docs/conceptual/command-processor.rst | 4 +- docs/conceptual/compute-unit.rst | 6 +- docs/conceptual/definitions.rst | 6 +- .../includes/normalization-units.rst | 2 +- docs/conceptual/l2-cache.rst | 10 +- docs/conceptual/local-data-share.rst | 4 +- docs/conceptual/performance-model.rst | 10 +- docs/conceptual/pipeline-descriptions.rst | 10 +- docs/conceptual/pipeline-metrics.rst | 10 +- docs/conceptual/references.rst | 4 +- docs/conceptual/shader-engine.rst | 8 +- docs/conceptual/system-speed-of-light.rst | 6 +- docs/conceptual/vector-l1-cache.rst | 12 +- docs/how-to/analyze/cli.rst | 20 ++-- docs/how-to/analyze/grafana-gui.rst | 108 +++++++++--------- docs/how-to/analyze/mode.rst | 16 +-- docs/how-to/analyze/standalone-gui.rst | 16 +-- docs/how-to/profile/mode.rst | 42 +++---- docs/how-to/use.rst | 38 +++--- docs/index.rst | 20 ++-- docs/install/core-install.rst | 60 +++++----- docs/install/grafana-setup.rst | 34 +++--- docs/license.rst | 4 +- docs/reference/compatible-accelerators.rst | 8 +- docs/reference/faq.rst | 6 +- .../includes/infinity-fabric-transactions.rst | 8 +- ...nstructions-per-cycle-and-utilizations.rst | 12 +- docs/tutorial/includes/lds-examples.rst | 12 +- .../includes/occupancy-limiters-example.rst | 10 +- .../valu-arithmetic-instruction-mix.rst | 4 +- .../vector-memory-operation-counting.rst | 16 +-- docs/tutorial/learning-resources.rst | 12 +- docs/tutorial/profiling-by-example.rst | 6 +- docs/what-is-omniperf.rst | 38 +++--- 34 files changed, 291 insertions(+), 291 deletions(-) diff --git a/docs/conceptual/command-processor.rst b/docs/conceptual/command-processor.rst index a055768a1..823ba7166 100644 --- a/docs/conceptual/command-processor.rst +++ b/docs/conceptual/command-processor.rst @@ -1,6 +1,6 @@ .. meta:: - :description: Omniperf performance model: Command processor (CP) - :keywords: Omniperf, ROCm, profiler, tool, Instinct, accelerator, command, processor, fetcher, packet processor, CPF, CPC + :description: ROCm Compute Profiler performance model: Command processor (CP) + :keywords: ROCm Compute Profiler, ROCm, profiler, tool, Instinct, accelerator, command, processor, fetcher, packet processor, CPF, CPC ********************** Command processor (CP) diff --git a/docs/conceptual/compute-unit.rst b/docs/conceptual/compute-unit.rst index e7061c814..d6e45f673 100644 --- a/docs/conceptual/compute-unit.rst +++ b/docs/conceptual/compute-unit.rst @@ -1,6 +1,6 @@ .. meta:: - :description: Omniperf performance model: Compute unit (CU) - :keywords: Omniperf, ROCm, profiler, tool, Instinct, accelerator, GCN, compute, unit, pipeline, workgroup, wavefront, + :description: ROCm Compute Profiler performance model: Compute unit (CU) + :keywords: ROCm Compute Profiler, ROCm, profiler, tool, Instinct, accelerator, GCN, compute, unit, pipeline, workgroup, wavefront, CDNA ***************** @@ -19,7 +19,7 @@ CDNA™-based accelerators. All :ref:`wavefronts ` of a The CU consists of several independent execution pipelines and functional units. The :doc:`/conceptual/pipeline-descriptions` section details the various execution pipelines -- VALU, SALU, LDS, scheduler, and so forth. The metrics -presented by Omniperf for these pipelines are described in +presented by ROCm Compute Profiler for these pipelines are described in :doc:`pipeline-metrics`. The :doc:`vL1D ` cache and :doc:`LDS ` are described in their own sections. diff --git a/docs/conceptual/definitions.rst b/docs/conceptual/definitions.rst index 8ad483094..816ce0fb2 100644 --- a/docs/conceptual/definitions.rst +++ b/docs/conceptual/definitions.rst @@ -1,13 +1,13 @@ .. meta:: - :description: Omniperf terminology and definitions - :keywords: Omniperf, ROCm, glossary, definitions, terms, profiler, tool, + :description: ROCm Compute Profiler terminology and definitions + :keywords: ROCm Compute Profiler, ROCm, glossary, definitions, terms, profiler, tool, Instinct, accelerator, AMD *********** Definitions *********** -The following table briefly defines some terminology used in Omniperf interfaces +The following table briefly defines some terminology used in ROCm Compute Profiler interfaces and in this documentation. .. include:: ./includes/terms.rst diff --git a/docs/conceptual/includes/normalization-units.rst b/docs/conceptual/includes/normalization-units.rst index 34961f7e0..365c30c0e 100644 --- a/docs/conceptual/includes/normalization-units.rst +++ b/docs/conceptual/includes/normalization-units.rst @@ -34,7 +34,7 @@ include: that is, the total runtime of the kernel in seconds, as measured by the :doc:`command processor `. -By default, Omniperf uses the ``per_wave`` normalization. +By default, ROCm Compute Profiler uses the ``per_wave`` normalization. .. tip:: diff --git a/docs/conceptual/l2-cache.rst b/docs/conceptual/l2-cache.rst index 2c4b44514..2047012eb 100644 --- a/docs/conceptual/l2-cache.rst +++ b/docs/conceptual/l2-cache.rst @@ -1,6 +1,6 @@ .. meta:: - :description: Omniperf performance model: L2 cache (TCC) - :keywords: Omniperf, ROCm, profiler, tool, Instinct, accelerator, L2, cache, infinity fabric, metrics + :description: ROCm Compute Profiler performance model: L2 cache (TCC) + :keywords: ROCm Compute Profiler, ROCm, profiler, tool, Instinct, accelerator, L2, cache, infinity fabric, metrics ************** L2 cache (TCC) @@ -21,7 +21,7 @@ across the L2 channels. Requests that miss in the L2 cache are passed out to :ref:`Infinity Fabric™ ` to be routed to the appropriate memory location. -The L2 cache metrics reported by Omniperf are broken down into four +The L2 cache metrics reported by ROCm Compute Profiler are broken down into four categories: * :ref:`L2 Speed-of-Light ` @@ -299,7 +299,7 @@ accelerator’s memory, or even in the CPU’s memory. Infinity Fabric is responsible for routing these memory requests/data to the correct location and returning any fetched data to the L2 cache. The :ref:`l2-request-flow` describes the flow of these requests through -Infinity Fabric in more detail, as described by Omniperf metrics, +Infinity Fabric in more detail, as described by ROCm Compute Profiler metrics, while :ref:`l2-request-metrics` give detailed definitions of individual metrics. @@ -309,7 +309,7 @@ Request flow ------------ The following is a diagram that illustrates how L2↔Fabric requests are reported -by Omniperf: +by ROCm Compute Profiler: .. figure:: ../data/performance-model/fabric.png :align: center diff --git a/docs/conceptual/local-data-share.rst b/docs/conceptual/local-data-share.rst index c596844dc..3549a3932 100644 --- a/docs/conceptual/local-data-share.rst +++ b/docs/conceptual/local-data-share.rst @@ -1,6 +1,6 @@ .. meta:: - :description: Omniperf performance model: Local data share (LDS) - :keywords: Omniperf, ROCm, profiler, tool, Instinct, accelerator, local, data, share, LDS + :description: ROCm Compute Profiler performance model: Local data share (LDS) + :keywords: ROCm Compute Profiler, ROCm, profiler, tool, Instinct, accelerator, local, data, share, LDS ********************** Local data share (LDS) diff --git a/docs/conceptual/performance-model.rst b/docs/conceptual/performance-model.rst index 1a94b3ed6..fa9264faf 100644 --- a/docs/conceptual/performance-model.rst +++ b/docs/conceptual/performance-model.rst @@ -1,13 +1,13 @@ .. meta:: - :description: Omniperf performance model - :keywords: Omniperf, ROCm, performance, model, profiler, tool, Instinct, + :description: ROCm Compute Profiler performance model + :keywords: ROCm Compute Profiler, ROCm, performance, model, profiler, tool, Instinct, accelerator, AMD ***************** Performance model ***************** -Omniperf makes available an extensive list of metrics to better understand +ROCm Compute Profiler makes available an extensive list of metrics to better understand achieved application performance on AMD Instinct™ MI-series accelerators including Graphics Core Next™ (GCN) GPUs like the AMD Instinct MI50, CDNA™ accelerators like the MI100, and CDNA2 accelerators such as the MI250X, MI250, @@ -18,7 +18,7 @@ hardware blocks of AMD Instinct accelerators. This section describes each hardware block on the accelerator as interacted with by a software developer to give a deeper understanding of the metrics reported by profiling data. Refer to :doc:`/tutorial/profiling-by-example` for more practical examples and details on how -to use Omniperf to optimize your code. +to use ROCm Compute Profiler to optimize your code. .. _mixxx-note: @@ -34,7 +34,7 @@ to use Omniperf to optimize your code. :prod-page:`MI250 `, and :prod-page:`MI210 ` product pages. -In this chapter, the AMD Instinct performance model used by Omniperf is divided into a handful of +In this chapter, the AMD Instinct performance model used by ROCm Compute Profiler is divided into a handful of key hardware blocks, each detailed in the following sections: * :doc:`compute-unit` diff --git a/docs/conceptual/pipeline-descriptions.rst b/docs/conceptual/pipeline-descriptions.rst index 9261421eb..ad71d94b8 100644 --- a/docs/conceptual/pipeline-descriptions.rst +++ b/docs/conceptual/pipeline-descriptions.rst @@ -1,6 +1,6 @@ .. meta:: - :description: Omniperf performance model: Shader engine (SE) - :keywords: Omniperf, ROCm, profiler, tool, Instinct, accelerator, pipeline, VALU, SALU, VMEM, SMEM, LDS, branch, + :description: ROCm Compute Profiler performance model: Shader engine (SE) + :keywords: ROCm Compute Profiler, ROCm, profiler, tool, Instinct, accelerator, pipeline, VALU, SALU, VMEM, SMEM, LDS, branch, scheduler, MFMA, AGPRs ********************* @@ -101,7 +101,7 @@ coordinate between wavefronts in a workgroup. Performance model of the local data share (LDS) on AMD Instinct MI-series accelerators. -Above is Omniperf's performance model of the LDS on CDNA accelerators (adapted +Above is ROCm Compute Profiler's performance model of the LDS on CDNA accelerators (adapted from :mantor-gcn-pdf:`20`). The SIMDs in the :ref:`VALU ` are connected to the LDS in pairs (see above). Only one SIMD per pair may issue an LDS instruction at a time, but both pairs may issue concurrently. @@ -186,7 +186,7 @@ shadow (see the :ref:`MFMA ` section for more detail). .. note:: - The IPC model used by Omniperf omits the following two complications for + The IPC model used by ROCm Compute Profiler omits the following two complications for clarity. First, CDNA accelerators contain other execution units on the CU that are unused for compute applications. Second, so-called "internal" instructions (see :gcn-crash-course:`29`) are not issued to a functional @@ -237,7 +237,7 @@ various AMD accelerators (including the CDNA line), we recommend the GPRs required for D: 4 GPR alignment requirement: 8 bytes -For the purposes of Omniperf, the MFMA unit is typically treated as a separate +For the purposes of ROCm Compute Profiler, the MFMA unit is typically treated as a separate pipeline from the :ref:`VALU `, as other VALU instructions (along with other execution pipelines such as the :ref:`SALU `) typically can be issued during a portion of the total duration of an MFMA operation. diff --git a/docs/conceptual/pipeline-metrics.rst b/docs/conceptual/pipeline-metrics.rst index f7bb4bcda..5b046adb8 100644 --- a/docs/conceptual/pipeline-metrics.rst +++ b/docs/conceptual/pipeline-metrics.rst @@ -1,13 +1,13 @@ .. meta:: - :description: Omniperf performance model: Pipeline metrics - :keywords: Omniperf, ROCm, profiler, tool, Instinct, accelerator, pipeline, wavefront, metrics, launch, runtime + :description: ROCm Compute Profiler performance model: Pipeline metrics + :keywords: ROCm Compute Profiler, ROCm, profiler, tool, Instinct, accelerator, pipeline, wavefront, metrics, launch, runtime VALU, MFMA, instruction mix, FLOPs, arithmetic, operations **************** Pipeline metrics **************** -In this section, we describe the metrics available in Omniperf to analyze the +In this section, we describe the metrics available in ROCm Compute Profiler to analyze the pipelines discussed in the :doc:`pipeline-descriptions`. .. _wavefront: @@ -233,7 +233,7 @@ Instruction mix The instruction mix panel shows a breakdown of the various types of instructions executed by the user’s kernel, and which pipelines on the -:doc:`CU ` they were executed on. In addition, Omniperf reports +:doc:`CU ` they were executed on. In addition, ROCm Compute Profiler reports further information about the breakdown of operation types for the :ref:`VALU `, vector-memory, and :ref:`MFMA ` instructions. @@ -555,7 +555,7 @@ Compute pipeline FLOP counting conventions ------------------------- -Omniperf’s conventions for VALU FLOP counting are as follows: +ROCm Compute Profiler’s conventions for VALU FLOP counting are as follows: * Addition or multiplication: 1 operation diff --git a/docs/conceptual/references.rst b/docs/conceptual/references.rst index 9f3d32cd8..9eeef9151 100644 --- a/docs/conceptual/references.rst +++ b/docs/conceptual/references.rst @@ -1,6 +1,6 @@ .. meta:: - :description: Omniperf performance model: References - :keywords: Omniperf, ROCm, profiler, tool, Instinct, accelerator, HIP, GCN, LLVM, docs, documentation, training + :description: ROCm Compute Profiler performance model: References + :keywords: ROCm Compute Profiler, ROCm, profiler, tool, Instinct, accelerator, HIP, GCN, LLVM, docs, documentation, training ********** References diff --git a/docs/conceptual/shader-engine.rst b/docs/conceptual/shader-engine.rst index 8295c4516..53fa6c2e7 100644 --- a/docs/conceptual/shader-engine.rst +++ b/docs/conceptual/shader-engine.rst @@ -1,6 +1,6 @@ .. meta:: - :description: Omniperf performance model: Shader engine (SE) - :keywords: Omniperf, ROCm, profiler, tool, Instinct, accelerator, shader, engine, sL1D, L1I, workgroup manager, SPI + :description: ROCm Compute Profiler performance model: Shader engine (SE) + :keywords: ROCm Compute Profiler, ROCm, profiler, tool, Instinct, accelerator, shader, engine, sL1D, L1I, workgroup manager, SPI ****************** Shader engine (SE) @@ -21,7 +21,7 @@ The number of CUs on a SE varies from chip to chip -- see for example :hip-training-pdf:`20`. In addition, newer accelerators such as the AMD Instinct™ MI 250X have 8 SEs per accelerator. -For the purposes of Omniperf, we consider resources that are shared between +For the purposes of ROCm Compute Profiler, we consider resources that are shared between multiple CUs on a single SE as part of the SE's metrics. These include: @@ -487,7 +487,7 @@ issuing concurrently). .. note:: - Current versions of the profiling libraries underlying Omniperf attempt to + Current versions of the profiling libraries underlying ROCm Compute Profiler attempt to serialize concurrent kernels running on the accelerator, as the performance counters on the device are global (that is, shared between concurrent kernels). This means that these scheduler-pipe utilization metrics are diff --git a/docs/conceptual/system-speed-of-light.rst b/docs/conceptual/system-speed-of-light.rst index f01be4b67..5d023f557 100644 --- a/docs/conceptual/system-speed-of-light.rst +++ b/docs/conceptual/system-speed-of-light.rst @@ -1,13 +1,13 @@ .. meta:: - :description: Omniperf performance model: System Speed-of-Light - :keywords: Omniperf, ROCm, profiler, tool, Instinct, accelerator, AMD, system, speed of light + :description: ROCm Compute Profiler performance model: System Speed-of-Light + :keywords: ROCm Compute Profiler, ROCm, profiler, tool, Instinct, accelerator, AMD, system, speed of light ********************* System Speed-of-Light ********************* System Speed-of-Light summarizes some of the key metrics from various sections -of Omniperf’s profiling report. +of ROCm Compute Profiler’s profiling report. .. warning:: diff --git a/docs/conceptual/vector-l1-cache.rst b/docs/conceptual/vector-l1-cache.rst index 086c195be..db32bb5f9 100644 --- a/docs/conceptual/vector-l1-cache.rst +++ b/docs/conceptual/vector-l1-cache.rst @@ -1,6 +1,6 @@ .. meta:: - :description: Omniperf performance model: Vector L1 cache (vL1D) - :keywords: Omniperf, ROCm, profiler, tool, Instinct, accelerator, AMD, vector, l1, cache, vl1d + :description: ROCm Compute Profiler performance model: Vector L1 cache (vL1D) + :keywords: ROCm Compute Profiler, ROCm, profiler, tool, Instinct, accelerator, AMD, vector, l1, cache, vl1d ********************** Vector L1 cache (vL1D) @@ -124,7 +124,7 @@ passes information about the commands (coalescing state, destination SIMD, etc.) to the :ref:`data processing unit ` for use after the requested data has been retrieved. -Omniperf reports several metrics to indicate performance bottlenecks in +ROCm Compute Profiler reports several metrics to indicate performance bottlenecks in the address processing unit, which are broken down into a few categories: @@ -378,7 +378,7 @@ Translation Cache (UTCL1). This cache contains a L1 Translation Lookaside Buffer (TLB) which stores recently translated addresses to reduce the cost of subsequent re-translations. -Omniperf reports the following L1 TLB metrics: +ROCm Compute Profiler reports the following L1 TLB metrics: .. list-table:: :header-rows: 1 @@ -656,7 +656,7 @@ latencies of read/write memory operations to the :doc:`L2 cache `. :ref:`Cache access metrics ` section when evaluating the vL1D hit rate. -.. [#vl1d-activity] Omniperf considers the vL1D to be active when any part of +.. [#vl1d-activity] ROCm Compute Profiler considers the vL1D to be active when any part of the vL1D (excluding the :ref:`address processor ` and :ref:`data return ` units) are active, for example, when performing a translation, waiting for data, accessing the Tag or Cache RAMs, etc. @@ -685,7 +685,7 @@ from the :ref:`VALU `. When data is returned from the :ref:`vL1D cache RAM `, it is matched to this previously stored request data, and returned to the appropriate SIMD. -Omniperf reports the following vL1D data-return path metrics: +ROCm Compute Profiler reports the following vL1D data-return path metrics: .. list-table:: :header-rows: 1 diff --git a/docs/how-to/analyze/cli.rst b/docs/how-to/analyze/cli.rst index 82185cd41..1cc22b666 100644 --- a/docs/how-to/analyze/cli.rst +++ b/docs/how-to/analyze/cli.rst @@ -1,14 +1,14 @@ .. meta:: - :description: Omniperf analysis: CLI analysis - :keywords: Omniperf, ROCm, profiler, tool, Instinct, accelerator, command line, analyze, filtering, metrics, baseline, comparison + :description: ROCm Compute Profiler analysis: CLI analysis + :keywords: ROCm Compute Profiler, ROCm, profiler, tool, Instinct, accelerator, command line, analyze, filtering, metrics, baseline, comparison ************ CLI analysis ************ -This section provides an overview of Omniperf's CLI analysis features. +This section provides an overview of ROCm Compute Profiler's CLI analysis features. -* :ref:`Derived metrics `: All of Omniperf's built-in metrics. +* :ref:`Derived metrics `: All of ROCm Compute Profiler's built-in metrics. * :ref:`Baseline comparison `: Compare multiple runs in a side-by-side manner. @@ -26,7 +26,7 @@ Run ``omniperf analyze -h`` for more details. Walkthrough =========== -1. To begin, generate a high-level analysis report using Omniperf's ``-b`` (or ``--block``) flag. +1. To begin, generate a high-level analysis report using ROCm Compute Profiler's ``-b`` (or ``--block``) flag. .. code-block:: shell @@ -40,7 +40,7 @@ Walkthrough |_| Analysis mode = cli - [analysis] deriving Omniperf metrics... + [analysis] deriving ROCm Compute Profiler metrics... -------------------------------------------------------------------------------- 0. Top Stats @@ -146,7 +146,7 @@ Walkthrough |_| Analysis mode = cli - [analysis] deriving Omniperf metrics... + [analysis] deriving ROCm Compute Profiler metrics... 0 -> Top Stats 1 -> System Info 2 -> System Speed-of-Light @@ -280,7 +280,7 @@ Walkthrough 4. Optimize the application, iterate, and re-profile to inspect performance changes. -5. Redo a comprehensive analysis with Omniperf CLI at any optimization +5. Redo a comprehensive analysis with ROCm Compute Profiler CLI at any optimization milestone. .. _cli-analysis-options: @@ -322,7 +322,7 @@ Filter kernels $ omniperf analyze -p workloads/vcopy/MI200/ --list-stats Analysis mode = cli - [analysis] deriving Omniperf metrics... + [analysis] deriving ROCm Compute Profiler metrics... -------------------------------------------------------------------------------- Detected Kernels (sorted descending by duration) @@ -349,7 +349,7 @@ Filter kernels $ omniperf analyze -p workloads/vcopy/MI200/ -k 0 Analysis mode = cli - [analysis] deriving Omniperf metrics... + [analysis] deriving ROCm Compute Profiler metrics... -------------------------------------------------------------------------------- 0. Top Stats diff --git a/docs/how-to/analyze/grafana-gui.rst b/docs/how-to/analyze/grafana-gui.rst index d5474aefb..cc767ea03 100644 --- a/docs/how-to/analyze/grafana-gui.rst +++ b/docs/how-to/analyze/grafana-gui.rst @@ -1,6 +1,6 @@ .. meta:: - :description: Omniperf analysis: Grafana GUI - :keywords: Omniperf, ROCm, profiler, tool, Instinct, accelerator, Grafana, panels, GUI, import + :description: ROCm Compute Profiler analysis: Grafana GUI + :keywords: ROCm Compute Profiler, ROCm, profiler, tool, Instinct, accelerator, Grafana, panels, GUI, import ******************** Grafana GUI analysis @@ -8,7 +8,7 @@ Grafana GUI analysis Find setup instructions in :doc:`../../install/grafana-setup`. -The Omniperf Grafana analysis dashboard GUI supports the following features to +The ROCm Compute Profiler Grafana analysis dashboard GUI supports the following features to facilitate MI accelerator performance profiling and analysis: * System and hardware component (hardware block) @@ -40,7 +40,7 @@ facilitate MI accelerator performance profiling and analysis: * L2 Cache (TCC) (both aggregated and per-channel perf info) -See the full list of :ref:`Omniperf's analysis panels `. +See the full list of :ref:`ROCm Compute Profiler's analysis panels `. .. _analysis-sol: @@ -70,14 +70,14 @@ normalizations are available. * ``per_second`` -See :ref:`normalization-units` to learn more about Omniperf normalizations. +See :ref:`normalization-units` to learn more about ROCm Compute Profiler normalizations. .. _analysis-baseline-comparison: Baseline comparison ------------------- -Omniperf enables baseline comparison to allow checking A/B effect. Currently +ROCm Compute Profiler enables baseline comparison to allow checking A/B effect. Currently baseline comparison is limited to the same :ref:`SoC `. Cross comparison between SoCs is in development. @@ -92,14 +92,14 @@ setup the following filters to allow fine grained comparisons: * Dispatch ID filtering (regex filtering) -* Omniperf Panels (multi-selection) +* ROCm Compute Profiler Panels (multi-selection) .. _analysis-regex-dispatch-id: Regex-based dispatch ID filtering --------------------------------- -Omniperf allows filtering via Regular Expressions (regex), a standard Linux +ROCm Compute Profiler allows filtering via Regular Expressions (regex), a standard Linux string matching syntax, based dispatch ID filtering to flexibly choose the kernel invocations. @@ -116,7 +116,7 @@ corresponding regex is : ``(1[7-9]|[23]\d|4[0-8])``. Incremental profiling --------------------- -Omniperf supports incremental profiling to speed up performance analysis. +ROCm Compute Profiler supports incremental profiling to speed up performance analysis. Refer to the :ref:`profiling-hw-component-filtering` section for this command. @@ -145,7 +145,7 @@ Global variables and configurations .. image:: ../../data/analyze/global_variables.png :align: center - :alt: Omniperf global variables and configurations + :alt: ROCm Compute Profiler global variables and configurations :width: 800 .. _grafana-gui-import: @@ -153,7 +153,7 @@ Global variables and configurations Grafana GUI import ------------------ -The Omniperf database ``--import`` option imports the raw profiling data to +The ROCm Compute Profiler database ``--import`` option imports the raw profiling data to Grafana's backend MongoDB database. This step is only required for Grafana GUI-based performance analysis. @@ -215,8 +215,8 @@ called ``dummybox``. -s, --specs Print system specs. Interaction Type: - -i, --import Import workload to Omniperf DB - -r, --remove Remove a workload from Omniperf DB + -i, --import Import workload to ROCm Compute Profiler DB + -r, --remove Remove a workload from ROCm Compute Profiler DB Connection Options: -H , --host Name or IP address of the server host. @@ -228,7 +228,7 @@ called ``dummybox``. --kernel-verbose Specify Kernel Name verbose level 1-5. Lower the level, shorter the kernel name. (DEFAULT: 5) (DISABLE: 5) -Omniperf import for vcopy: +ROCm Compute Profiler import for vcopy: ^^^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: shell @@ -267,7 +267,7 @@ Omniperf import for vcopy: .. _panels: -Omniperf panels +ROCm Compute Profiler panels --------------- There are currently 18 main panel categories available for analyzing the compute @@ -446,7 +446,7 @@ Kernel Time Histogram .. figure:: ../../data/analyze/grafana/Kernel_time_histogram.png :align: center - :alt: Kernel time histogram panel in Omniperf Grafana + :alt: Kernel time histogram panel in ROCm Compute Profiler Grafana :width: 800 Mapping application kernel launches to execution duration. @@ -456,7 +456,7 @@ Top Bottleneck Kernels .. figure:: ../../data/analyze/grafana/top-stat_panel.png :align: center - :alt: Top bottleneck kernels panel in Omniperf Grafana + :alt: Top bottleneck kernels panel in ROCm Compute Profiler Grafana :width: 800 Top N kernels and relevant statistics. Sorted by total duration. @@ -466,7 +466,7 @@ Top Bottleneck Dispatches .. figure:: ../../data/analyze/grafana/Top_bottleneck_dispatches.png :align: center - :alt: Top bottleneck dispatches panel in Omniperf Grafana + :alt: Top bottleneck dispatches panel in ROCm Compute Profiler Grafana :width: 800 Top N kernel dispatches and relevant statistics. Sorted by total duration. @@ -476,7 +476,7 @@ Current and Baseline Dispatch IDs (Filtered) .. figure:: ../../data/analyze/grafana/Current_and_baseline_dispatch_ids.png :align: center - :alt: Current and baseline dispatch IDs panel in Omniperf Grafana + :alt: Current and baseline dispatch IDs panel in ROCm Compute Profiler Grafana :width: 800 List of all kernel dispatches. @@ -488,10 +488,10 @@ System Speed-of-Light .. figure:: ../../data/analyze/grafana/sol_panel.png :align: center - :alt: System Speed-of-Light panel in Omniperf Grafana + :alt: System Speed-of-Light panel in ROCm Compute Profiler Grafana :width: 800 - Key metrics from various sections of Omniperf’s profiling report. + Key metrics from various sections of ROCm Compute Profiler’s profiling report. .. tip:: @@ -510,7 +510,7 @@ Memory Chart Analysis .. figure:: ../../data/analyze/grafana/memory-chart_panel.png :align: center - :alt: Memory Chart Analysis panel in Omniperf Grafana + :alt: Memory Chart Analysis panel in ROCm Compute Profiler Grafana :width: 800 A graphical representation of performance data for memory blocks on the GPU. @@ -523,7 +523,7 @@ Empirical Roofline Analysis .. figure:: ../../data/analyze/grafana/roofline_panel.png :align: center - :alt: Roofline Analysis panel in Omniperf Grafana + :alt: Roofline Analysis panel in ROCm Compute Profiler Grafana :width: 800 Visualize achieved performance relative to a benchmarked peak performance. @@ -543,7 +543,7 @@ Command Processor Fetcher .. figure:: ../../data/analyze/grafana/cpc_panel.png :align: center - :alt: Command Processor Fetcher panel in Omniperf Grafana + :alt: Command Processor Fetcher panel in ROCm Compute Profiler Grafana :width: 800 Fetches commands out of memory to hand them over to the Command Processor @@ -554,7 +554,7 @@ Command Processor Compute .. figure:: ../../data/analyze/grafana/cpf_panel.png :align: center - :alt: Command Processor Compute panel in Omniperf Grafana + :alt: Command Processor Compute panel in ROCm Compute Profiler Grafana :width: 800 The micro-controller running the command processing firmware that decodes the @@ -575,7 +575,7 @@ SPI Stats .. figure:: ../../data/analyze/grafana/spi-stats_panel.png :align: center - :alt: SPI Stats panel in Omniperf Grafana + :alt: SPI Stats panel in ROCm Compute Profiler Grafana :width: 800 .. @@ -586,7 +586,7 @@ SPI Resource Allocation .. figure:: ../../data/analyze/grafana/spi-resource-allocation_panel.png :align: center - :alt: SPI Resource Allocation panel in Omniperf Grafana + :alt: SPI Resource Allocation panel in ROCm Compute Profiler Grafana :width: 800 .. @@ -602,7 +602,7 @@ Wavefront Launch Stats .. figure:: ../../data/analyze/grafana/wavefront-launch-stats_panel.png :align: center - :alt: Wavefront Launch Stats panel in Omniperf Grafana + :alt: Wavefront Launch Stats panel in ROCm Compute Profiler Grafana :width: 800 General information about the kernel launch. @@ -616,7 +616,7 @@ Wavefront Runtime Stats .. figure:: ../../data/analyze/grafana/wavefront-runtime-stats_panel.png :align: center - :alt: Wavefront Runtime Stats panel in Omniperf Grafana. + :alt: Wavefront Runtime Stats panel in ROCm Compute Profiler Grafana. :width: 800 High-level overview of the execution of wavefronts in a kernel. @@ -635,7 +635,7 @@ Instruction Mix .. figure:: ../../data/analyze/grafana/cu-inst-mix_panel.png :align: center - :alt: Instruction Mix panel in Omniperf Grafana + :alt: Instruction Mix panel in ROCm Compute Profiler Grafana :width: 800 Breakdown of the various types of instructions executed by the user’s kernel, @@ -650,7 +650,7 @@ VALU Arithmetic Instruction Mix .. figure:: ../../data/analyze/grafana/cu-value-arith-instr-mix_panel.png :align: center - :alt: VALU Arithmetic Instruction Mix panel in Omniperf Grafana + :alt: VALU Arithmetic Instruction Mix panel in ROCm Compute Profiler Grafana :width: 800 The various types of vector instructions that were issued to the vector @@ -665,7 +665,7 @@ MFMA Arithmetic Instruction Mix .. figure:: ../../data/analyze/grafana/cu-mafma-arith-instr-mix_panel.png :align: center - :alt: MFMA Arithmetic Instruction Mix panel in Omniperf Grafana + :alt: MFMA Arithmetic Instruction Mix panel in ROCm Compute Profiler Grafana :width: 800 The types of Matrix Fused Multiply-Add (MFMA) instructions that were issued. @@ -679,7 +679,7 @@ VMEM Arithmetic Instruction Mix .. figure:: ../../data/analyze/grafana/cu-vmem-instr-mix_panel.png :align: center - :alt: VMEM Arithmetic Instruction Mix panel in Omniperf Grafana + :alt: VMEM Arithmetic Instruction Mix panel in ROCm Compute Profiler Grafana :width: 800 The types of vector memory (VMEM) instructions that were issued. @@ -698,7 +698,7 @@ Speed-of-Light .. figure:: ../../data/analyze/grafana/cu-sol_panel.png :align: center - :alt: Speed-of-Light (CU) panel in Omniperf Grafana + :alt: Speed-of-Light (CU) panel in ROCm Compute Profiler Grafana :width: 800 The number of floating-point and integer operations executed on the vector @@ -714,7 +714,7 @@ Pipeline Stats .. figure:: ../../data/analyze/grafana/cu-pipeline-stats_panel.png :align: center - :alt: Pipeline Stats panel in Omniperf Grafana + :alt: Pipeline Stats panel in ROCm Compute Profiler Grafana :width: 800 More detailed metrics to analyze the several independent pipelines found in @@ -729,7 +729,7 @@ Arithmetic Operations .. figure:: ../../data/analyze/grafana/cu-arith-ops_panel.png :align: center - :alt: Arithmetic Operations panel in Omniperf Grafana + :alt: Arithmetic Operations panel in ROCm Compute Profiler Grafana :width: 800 The total number of floating-point and integer operations executed in various @@ -749,7 +749,7 @@ Speed-of-Light .. figure:: ../../data/analyze/grafana/lds-sol_panel.png :align: center - :alt: Speed-of-Light (LDS) panel in Omniperf Grafana + :alt: Speed-of-Light (LDS) panel in ROCm Compute Profiler Grafana :width: 800 Key metrics for the Local Data Share (LDS) as a comparison with the peak @@ -764,7 +764,7 @@ LDS Stats .. figure:: ../../data/analyze/grafana/lds-stats_panel.png :align: center - :alt: LDS Stats panel in Omniperf Grafana + :alt: LDS Stats panel in ROCm Compute Profiler Grafana :width: 800 More detailed view of the Local Data Share (LDS) performance. @@ -783,7 +783,7 @@ Speed-of-Light .. figure:: ../../data/analyze/grafana/instr-cache-sol_panel.png :align: center - :alt: Speed-of-Light (instruction cache) panel in Omniperf Grafana + :alt: Speed-of-Light (instruction cache) panel in ROCm Compute Profiler Grafana :width: 800 Key metrics of the L1 Instruction (L1I) cache as a comparison with the peak @@ -798,7 +798,7 @@ Instruction Cache Stats .. figure:: ../../data/analyze/grafana/instr-cache-accesses_panel.png :align: center - :alt: Instruction Cache Stats panel in Omniperf Grafana + :alt: Instruction Cache Stats panel in ROCm Compute Profiler Grafana :width: 800 More detail on the hit/miss statistics of the L1 Instruction (L1I) cache. @@ -821,7 +821,7 @@ Speed-of-Light .. figure:: ../../data/analyze/grafana/sl1d-sol_panel.png :align: center - :alt: Speed-of-Light (SL1D) panel in Omniperf Grafana + :alt: Speed-of-Light (SL1D) panel in ROCm Compute Profiler Grafana :width: 800 Key metrics of the Scalar L1 Data (sL1D) cache as a comparison with the peak @@ -836,7 +836,7 @@ Scalar L1D Cache Accesses .. figure:: ../../data/analyze/grafana/sl1d-cache-accesses_panel.png :align: center - :alt: Scalar L1D Cache Accesses panel in Omniperf Grafana + :alt: Scalar L1D Cache Accesses panel in ROCm Compute Profiler Grafana :width: 800 More detail on the types of accesses made to the Scalar L1 Data (sL1D) cache, @@ -851,7 +851,7 @@ Scalar L1D Cache - L2 Interface .. figure:: ../../data/analyze/grafana/sl1d-l12-interface_panel.png :align: center - :alt: Scalar L1D Cache - L2 Interface panel in Omniperf Grafana + :alt: Scalar L1D Cache - L2 Interface panel in ROCm Compute Profiler Grafana :width: 800 More detail on the data requested across the Scalar L1 Data (sL1D) cache <-> @@ -871,7 +871,7 @@ Texture Addresser .. figure:: ../../data/analyze/grafana/ta_panel.png :align: center - :alt: Texture Addresser in Omniperf Grafana + :alt: Texture Addresser in ROCm Compute Profiler Grafana :width: 800 Metric specific to texture addresser (TA) which receives commands (e.g., @@ -889,7 +889,7 @@ Texture Data .. figure:: ../../data/analyze/grafana/td_panel.png :align: center - :alt: Texture Data panel in Omniperf Grafana + :alt: Texture Data panel in ROCm Compute Profiler Grafana :width: 800 Metrics specific to texture data (TD) which routes data back to the @@ -909,7 +909,7 @@ Speed-of-Light .. figure:: ../../data/analyze/grafana/vl1d-sol_panel.png :align: center - :alt: Speed-of-Light (VL1D) panel in Omniperf Grafana + :alt: Speed-of-Light (VL1D) panel in ROCm Compute Profiler Grafana :width: 800 Key metrics of the vector L1 data (vL1D) cache as a comparison with the peak @@ -924,7 +924,7 @@ L1D Cache Stalls .. figure:: ../../data/analyze/grafana/vl1d-cache-stalls_panel.png :align: center - :alt: L1D Cache Stalls panel in Omniperf Grafana + :alt: L1D Cache Stalls panel in ROCm Compute Profiler Grafana :width: 800 More detail on where vector L1 data (vL1D) cache is stalled in the pipeline, @@ -955,7 +955,7 @@ L1D - L2 Transactions .. figure:: ../../data/analyze/grafana/vl1d-l2-transactions_panel.png :align: center - :alt: L1D - L2 Transactions in Omniperf Grafana + :alt: L1D - L2 Transactions in ROCm Compute Profiler Grafana :width: 800 A more granular look at the types of requests made to the L2 cache. @@ -969,7 +969,7 @@ L1D Addr Translation .. figure:: ../../data/analyze/grafana/vl1d-addr-translation_panel.png :align: center - :alt: L1D Addr Translation panel in Omniperf Grafana + :alt: L1D Addr Translation panel in ROCm Compute Profiler Grafana :width: 800 After a vector memory instruction has been processed/coalesced by the address @@ -995,7 +995,7 @@ Speed-of-Light .. figure:: ../../data/analyze/grafana/l2-sol_panel.png :align: center - :alt: Speed-of-Light (L2 cache) panel in Omniperf Grafana + :alt: Speed-of-Light (L2 cache) panel in ROCm Compute Profiler Grafana :width: 800 Key metrics about the performance of the L2 cache, aggregated over all the @@ -1011,7 +1011,7 @@ L2 Cache Accesses .. figure:: ../../data/analyze/grafana/l2-accesses_panel.png :align: center - :alt: L2 Cache Accesses panel in Omniperf Grafana + :alt: L2 Cache Accesses panel in ROCm Compute Profiler Grafana :width: 800 Incoming requests to the L2 cache from the vector L1 data (vL1D) cache and @@ -1026,7 +1026,7 @@ L2 - Fabric Transactions .. figure:: ../../data/analyze/grafana/l2-fabric-transactions_panel.png :align: center - :alt: L2 - Fabric Transactions panel in Omniperf Grafana + :alt: L2 - Fabric Transactions panel in ROCm Compute Profiler Grafana :width: 800 More detail on the flow of requests through Infinity Fabric™. @@ -1040,7 +1040,7 @@ L2 - Fabric Interface Stalls .. figure:: ../../data/analyze/grafana/l2-fabric-interface-stalls_panel.png :align: center - :alt: L2 - Fabric Interface Stalls panel in Omniperf Grafana + :alt: L2 - Fabric Interface Stalls panel in ROCm Compute Profiler Grafana :width: 800 A breakdown of what types of requests in a kernel caused a stall @@ -1065,7 +1065,7 @@ Aggregate Stats .. figure:: ../../data/analyze/grafana/l2-per-channel-agg-stats_panel.png :align: center - :alt: Aggregate Stats (L2 cache per channel) panel in Omniperf Grafana + :alt: Aggregate Stats (L2 cache per channel) panel in ROCm Compute Profiler Grafana :width: 800 L2 Cache per channel performance at a glance. Metrics are aggregated over all available channels. diff --git a/docs/how-to/analyze/mode.rst b/docs/how-to/analyze/mode.rst index b34e1214c..d9f802cdb 100644 --- a/docs/how-to/analyze/mode.rst +++ b/docs/how-to/analyze/mode.rst @@ -1,22 +1,22 @@ .. meta:: - :description: How to use Omniperf's analyze mode - :keywords: Omniperf, ROCm, profiler, tool, Instinct, accelerator, AMD, + :description: How to use ROCm Compute Profiler's analyze mode + :keywords: ROCm Compute Profiler, ROCm, profiler, tool, Instinct, accelerator, AMD, Grafana, analysis, analyze mode ************ Analyze mode ************ -Omniperf offers several ways to interact with the metrics it generates from +ROCm Compute Profiler offers several ways to interact with the metrics it generates from profiling. Your level of familiarity with the profiled application, computing -environment, and experience with Omniperf should inform the analysis method you +environment, and experience with ROCm Compute Profiler should inform the analysis method you choose. -While analyzing with the CLI offers quick and straightforward access to Omniperf +While analyzing with the CLI offers quick and straightforward access to ROCm Compute Profiler metrics from the terminal, Grafana's dashboard GUI adds an extra layer of readability and interactivity you might prefer. -See the following sections to explore Omniperf's analysis and visualization +See the following sections to explore ROCm Compute Profiler's analysis and visualization options. * :doc:`cli` @@ -32,5 +32,5 @@ options. Unless otherwise noted, the performance analysis is done on the :ref:`MI200 platform `. -Learn about profiling with Omniperf in :doc:`../profile/mode`. For an overview of -Omniperf's other modes, see :ref:`modes`. +Learn about profiling with ROCm Compute Profiler in :doc:`../profile/mode`. For an overview of +ROCm Compute Profiler's other modes, see :ref:`modes`. diff --git a/docs/how-to/analyze/standalone-gui.rst b/docs/how-to/analyze/standalone-gui.rst index a6a3e26f3..9afd6e6fa 100644 --- a/docs/how-to/analyze/standalone-gui.rst +++ b/docs/how-to/analyze/standalone-gui.rst @@ -1,15 +1,15 @@ .. meta:: - :description: Omniperf analysis: Standalone GUI - :keywords: Omniperf, ROCm, profiler, tool, Instinct, accelerator, GUI, standalone, filter + :description: ROCm Compute Profiler analysis: Standalone GUI + :keywords: ROCm Compute Profiler, ROCm, profiler, tool, Instinct, accelerator, GUI, standalone, filter *********************** Standalone GUI analysis *********************** -Omniperf's standalone analysis GUI is a lightweight web page that you can +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 Omniperf's +without the additional setup requirements or server-side overhead of ROCm Compute Profiler's detailed :doc:`Grafana interface ` option. This analysis option is implemented as a simple `Flask `_ application that lets you view results from your preferred web browser. @@ -29,7 +29,7 @@ application that lets you view results from your preferred web browser. Launch the standalone GUI analyzer ---------------------------------- -To launch the Omniperf GUI analyzer, include the ``--gui`` flag with your +To launch the ROCm Compute Profiler GUI analyzer, include the ``--gui`` flag with your desired analysis command. For example: .. code-block:: shell @@ -44,7 +44,7 @@ desired analysis command. For example: |_| Analysis mode = web_ui - [analysis] deriving Omniperf metrics... + [analysis] deriving ROCm Compute Profiler metrics... Dash is running on http://0.0.0.0:8050/ * Serving Flask app 'omniperf_analyze.analysis_webui' (lazy loading) @@ -62,7 +62,7 @@ At this point, you can launch your web browser of choice and navigate to .. image:: ../../data/analyze/standalone_gui.png :align: center - :alt: Omniperf standalone GUI home screen + :alt: ROCm Compute Profiler standalone GUI home screen :width: 800 .. tip:: @@ -85,5 +85,5 @@ 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 Omniperf's +detailed sections mirror the data displayed in ROCm Compute Profiler's :doc:`Grafana interface `. diff --git a/docs/how-to/profile/mode.rst b/docs/how-to/profile/mode.rst index 5bc0ad6a7..46c2f1944 100644 --- a/docs/how-to/profile/mode.rst +++ b/docs/how-to/profile/mode.rst @@ -1,17 +1,17 @@ .. meta:: - :description: How to use Omniperf's profile mode - :keywords: Omniperf, ROCm, profiler, tool, Instinct, accelerator, AMD, + :description: How to use ROCm Compute Profiler's profile mode + :keywords: ROCm Compute Profiler, ROCm, profiler, tool, Instinct, accelerator, AMD, profiling, profile mode ************ Profile mode ************ -The following chapter walks you through Omniperf's core profiling features by +The following chapter walks you through ROCm Compute Profiler's core profiling features by example. -Learn about analysis with Omniperf in :doc:`../analyze/mode`. For an overview of -Omniperf's other modes, see :ref:`modes`. +Learn about analysis with ROCm Compute Profiler in :doc:`../analyze/mode`. For an overview of +ROCm Compute Profiler's other modes, see :ref:`modes`. Profiling ========= @@ -19,9 +19,9 @@ Profiling Use the ``omniperf`` executable to acquire all necessary performance monitoring data through analysis of compute workloads. -Profiling with Omniperf yields the following benefits. +Profiling with ROCm Compute Profiler yields the following benefits. -* :ref:`Automate counter collection `: Omniperf handles all +* :ref:`Automate counter collection `: ROCm Compute Profiler handles all of your profiling via pre-configured input files. * :ref:`Filtering `: Apply runtime filters to speed up the profiling @@ -41,11 +41,11 @@ Profiling example The ``__ repository includes source code for a sample GPU compute workload, ``vcopy.cpp``. A copy of this file is available in the ``share/sample`` subdirectory after a normal -Omniperf installation, or via the ``$OMNIPERF_SHARE/sample`` directory when +ROCm Compute Profiler installation, or via the ``$OMNIPERF_SHARE/sample`` directory when using the supplied modulefile. The examples in this section use a compiled version of the ``vcopy`` workload to -demonstrate the use of Omniperf in MI accelerator performance analysis. Unless +demonstrate the use of ROCm Compute Profiler in MI accelerator performance analysis. Unless otherwise noted, the performance analysis is done on the :ref:`MI200 platform `. @@ -85,7 +85,7 @@ The following sample command profiles the ``vcopy`` workload. \___/|_| |_| |_|_| |_|_| .__/ \___|_| |_| |_| - Omniperf version: 2.0.0 + ROCm Compute Profiler version: 2.0.0 Profiler choice: rocprofv1 Path: /home/auser/repos/omniperf/sample/workloads/vcopy/MI200 Target: MI200 @@ -171,9 +171,9 @@ The following sample command profiles the ``vcopy`` workload. .. _profiling-routine: -Notice the two main stages in Omniperf's *default* profiling routine. +Notice the two main stages in ROCm Compute Profiler's *default* profiling routine. -1. The first stage collects all the counters needed for Omniperf analysis +1. The first stage collects all the counters needed for ROCm Compute Profiler analysis (omitting any filters you have provided). 2. The second stage collects data for the roofline analysis (this stage can be @@ -187,7 +187,7 @@ example: * "MI200" for the AMD Instinct MI200 family of accelerators * "MI100" for the AMD Instinct MI100 family of accelerators -The SoC names are generated as a part of Omniperf, and do not *always* +The SoC names are generated as a part of ROCm Compute Profiler, and do not *always* distinguish between different accelerators in the same family; for instance, an Instinct MI210 vs an Instinct MI250. @@ -222,8 +222,8 @@ Filtering To reduce profiling time and the counters collected, you should use profiling filters. Profiling filters and their functionality depend on the underlying -profiler being used. While Omniperf is profiler-agnostic, this following is a -detailed description of profiling filters available when using Omniperf with +profiler being used. While ROCm Compute Profiler is profiler-agnostic, this following is a +detailed description of profiling filters available when using ROCm Compute Profiler with :doc:`ROCProfiler `. Filtering options @@ -255,7 +255,7 @@ Hardware component filtering ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ You can profile specific hardware components to speed up the profiling process. -In Omniperf, the term hardware block to refers to a hardware component or a +In ROCm Compute Profiler, the term hardware block to refers to a hardware component or a group of hardware components. All profiling results are accumulated in the same target directory without overwriting those for other hardware components. This enables incremental profiling and analysis. @@ -289,7 +289,7 @@ The following example only gathers hardware counters for the shader sequencer fname: pmc_sqc_perf1: Skipped fname: pmc_sq_perf6: Added fname: pmc_sq_perf2: Added - Omniperf version: 2.0.0 + ROCm Compute Profiler version: 2.0.0 Profiler choice: rocprofv1 Path: /home/auser/repos/omniperf/sample/workloads/vcopy/MI200 Target: MI200 @@ -325,7 +325,7 @@ substring ``vecCopy``. \___/|_| |_| |_|_| |_|_| .__/ \___|_| |_| |_| - Omniperf version: 2.0.0 + ROCm Compute Profiler version: 2.0.0 Profiler choice: rocprofv1 Path: /home/auser/repos/omniperf/sample/workloads/vcopy/MI200 Target: MI200 @@ -360,7 +360,7 @@ of the application (note zero-based indexing). \___/|_| |_| |_|_| |_|_| .__/ \___|_| |_| |_| - Omniperf version: 2.0.0 + ROCm Compute Profiler version: 2.0.0 Profiler choice: rocprofv1 Path: /home/auser/repos/omniperf/sample/workloads/vcopy/MI200 Target: MI200 @@ -441,7 +441,7 @@ successfully. .. note:: - Omniperf generates two roofline outputs to organize results and reduce + ROCm Compute Profiler generates two roofline outputs to organize results and reduce clutter. One chart plots FP32/FP64 performance while the other plots I8/FP16 performance. @@ -450,6 +450,6 @@ plot. .. image:: ../../data/profile/sample-roof-plot.png :align: center - :alt: Sample Omniperf roofline output + :alt: Sample ROCm Compute Profiler roofline output :width: 800 diff --git a/docs/how-to/use.rst b/docs/how-to/use.rst index 7377dd9f9..5bd86abf4 100644 --- a/docs/how-to/use.rst +++ b/docs/how-to/use.rst @@ -1,13 +1,13 @@ .. meta:: - :description: Omniperf basic usage - :keywords: Omniperf, ROCm, profiler, tool, Instinct, accelerator, AMD, + :description: ROCm Compute Profiler basic usage + :keywords: ROCm Compute Profiler, ROCm, profiler, tool, Instinct, accelerator, AMD, basics, usage, operations *********** Basic usage *********** -The following section outlines basic Omniperf workflows, modes, options, and +The following section outlines basic ROCm Compute Profiler workflows, modes, options, and operations. Command line profiler @@ -18,7 +18,7 @@ Launch and profile the target application using the command line profiler. The command line profiler launches the target application, calls the ROCProfiler API via the ``rocprof`` binary, and collects profile results for the specified kernels, dispatches, and hardware components. If not -specified, Omniperf defaults to collecting all available counters for all +specified, ROCm Compute Profiler defaults to collecting all available counters for all kernels and dispatches launched by the your executable. To collect the default set of data for all kernels in the target @@ -35,7 +35,7 @@ via the ``-n`` argument. .. note:: - To collect all requested profile information, Omniperf might replay kernels + To collect all requested profile information, ROCm Compute Profiler might replay kernels multiple times. .. _basic-filter-data-collection: @@ -87,7 +87,7 @@ To interact with profiling results from a different session, provide the workload path. ``-p``, ``--path`` - Enables you to analyze existing profiling data in the Omniperf CLI. + Enables you to analyze existing profiling data in the ROCm Compute Profiler CLI. See :doc:`analyze/cli` for more detailed information. @@ -97,11 +97,11 @@ Analyze in the Grafana GUI -------------------------- To conduct a more in-depth analysis of profiling results, it's suggested to use -a Grafana GUI with Omniperf. To interact with profiling results, import your -data to the MongoDB instance included in the Omniperf Dockerfile. See +a Grafana GUI with ROCm Compute Profiler. To interact with profiling results, import your +data to the MongoDB instance included in the ROCm Compute Profiler Dockerfile. See :doc:`/install/grafana-setup`. -To interact with Grafana data, stored in the Omniperf database, enter +To interact with Grafana data, stored in the ROCm Compute Profiler database, enter ``database`` :ref:`mode `; for example: .. code-block:: shell @@ -115,7 +115,7 @@ See :doc:`/how-to/analyze/grafana-gui` for more detailed information. Modes ===== -Modes change the fundamental behavior of the Omniperf command line tool. +Modes change the fundamental behavior of the ROCm Compute Profiler command line tool. Depending on which mode you choose, different command line options become available. @@ -136,7 +136,7 @@ Profile mode $ omniperf profile --help See :doc:`profile/mode` to learn about this mode in depth and to get started -profiling with Omniperf. +profiling with ROCm Compute Profiler. .. _modes-analyze: @@ -144,15 +144,15 @@ Analyze mode ------------ ``analyze`` - Loads profiling data from the ``--path`` (``-p``) directory into the Omniperf + Loads profiling data from the ``--path`` (``-p``) directory into the ROCm Compute Profiler CLI analyzer where you have immediate access to profiling results and generated metrics. It generates metrics from the entirety of your profiled - application or a subset identified through the Omniperf CLI analysis filters. + application or a subset identified through the ROCm Compute Profiler CLI analysis filters. To generate a lightweight GUI interface, you can add the ``--gui`` flag to your analysis command. - This mode is a middle ground to the highly detailed Omniperf Grafana GUI and + This mode is a middle ground to the highly detailed ROCm Compute Profiler Grafana GUI and is great if you want immediate access to a hardware component you’re already familiar with. @@ -161,7 +161,7 @@ Analyze mode $ omniperf analyze --help See :doc:`analyze/mode` to learn about this mode in depth and to get started -with analysis using Omniperf. +with analysis using ROCm Compute Profiler. .. _modes-database: @@ -188,11 +188,11 @@ database instance to make your profiling data more digestible and shareable. Global options ============== -The Omniperf command line tool has a set of *global* utility options that are +The ROCm Compute Profiler command line tool has a set of *global* utility options that are available across all modes. ``-v``, ``--version`` - Prints the Omniperf version and exits. + Prints the ROCm Compute Profiler version and exits. ``-V``, ``--verbose`` Increases output verbosity. Use multiple times for higher levels of @@ -206,7 +206,7 @@ available across all modes. .. note:: - Omniperf also recognizes the project variable, ``OMNIPERF_COLOR`` should you + ROCm Compute Profiler also recognizes the project variable, ``OMNIPERF_COLOR`` should you choose to disable colorful output. To disable default colorful behavior, set this variable to ``0``. @@ -215,7 +215,7 @@ available across all modes. Basic operations ================ -The following table lists Omniperf's basic operations, their +The following table lists ROCm Compute Profiler's basic operations, their :ref:`modes `, and required arguments. .. list-table:: diff --git a/docs/index.rst b/docs/index.rst index 1df329e7d..b5fcfbf08 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -1,21 +1,21 @@ .. meta:: - :description: Omniperf documentation and reference - :keywords: Omniperf, ROCm, profiler, tool, Instinct, accelerator, AMD + :description: ROCm Compute Profiler documentation and reference + :keywords: ROCm Compute Profiler, ROCm, profiler, tool, Instinct, accelerator, AMD ********************** -Omniperf documentation +ROCm Compute Profiler documentation ********************** -Omniperf documentation provides a comprehensive overview of Omniperf. +ROCm Compute Profiler documentation provides a comprehensive overview of ROCm Compute Profiler. In addition to a full deployment guide with installation instructions, this documentation also explains the ideas motivating the design behind the tool and its components. -If you're new to Omniperf, familiarize yourself with the tool by reviewing the +If you're new to ROCm Compute Profiler, familiarize yourself with the tool by reviewing the chapters that follow and gradually learn its more advanced features. To get -started, see :doc:`What is Omniperf? `. +started, see :doc:`What is ROCm Compute Profiler? `. -Omniperf is open source and hosted at ``__. +ROCm Compute Profiler is open source and hosted at ``__. .. grid:: 2 :gutter: 3 @@ -23,12 +23,12 @@ Omniperf is open source and hosted at ``__. .. grid-item-card:: Install * :doc:`install/core-install` - * :doc:`Grafana server for Omniperf ` + * :doc:`Grafana server for ROCm Compute Profiler ` .. grid-item:: -Use the following topics to learn more about the advantages of Omniperf in your -development toolkit, how it aims to model performance, and how to use Omniperf +Use the following topics to learn more about the advantages of ROCm Compute Profiler in your +development toolkit, how it aims to model performance, and how to use ROCm Compute Profiler in practice. .. grid:: 2 diff --git a/docs/install/core-install.rst b/docs/install/core-install.rst index f33b97622..e745cd57b 100644 --- a/docs/install/core-install.rst +++ b/docs/install/core-install.rst @@ -1,15 +1,15 @@ .. meta:: - :description: Omniperf installation and deployment - :keywords: Omniperf, ROCm, profiler, tool, Instinct, accelerator, AMD, + :description: ROCm Compute Profiler installation and deployment + :keywords: ROCm Compute Profiler, ROCm, profiler, tool, Instinct, accelerator, AMD, install, deploy, Grafana, client, configuration, modulefiles ********************************* -Installing and deploying Omniperf +Installing and deploying ROCm Compute Profiler ********************************* -Omniperf consists of two installation components. +ROCm Compute Profiler consists of two installation components. -* :ref:`Omniperf core installation ` (client-side) +* :ref:`ROCm Compute Profiler core installation ` (client-side) * Provides the core application profiling capability. * Allows the collection of performance counters, filtering by hardware @@ -17,18 +17,18 @@ Omniperf consists of two installation components. * Provides a CLI-based analysis mode. * Provides a standalone web interface for importing analysis metrics. -* :doc:`Grafana server for Omniperf ` (server-side) (*optional*) +* :doc:`Grafana server for ROCm Compute Profiler ` (server-side) (*optional*) * Hosts the MongoDB backend and Grafana instance. * Is packaged in a Docker container for easy setup. Determine what you need to install based on how you would like to interact with -Omniperf. See the following decision tree to help determine what installation is +ROCm Compute Profiler. See the following decision tree to help determine what installation is right for you. .. image:: ../data/install/install-decision-tree.png :align: center - :alt: Decision tree for installing and deploying Omniperf + :alt: Decision tree for installing and deploying ROCm Compute Profiler :width: 800 .. _core-install: @@ -36,8 +36,8 @@ right for you. Core installation ================= -The core Omniperf application requires the following basic software -dependencies. As of ROCm 6.2, the core Omniperf is included with your ROCm +The core ROCm Compute Profiler application requires the following basic software +dependencies. As of ROCm 6.2, the core ROCm Compute Profiler is included with your ROCm installation. * Python ``>= 3.8`` @@ -46,16 +46,16 @@ installation. .. note:: - Omniperf will use the first version of ``Python3`` found in your system's + ROCm Compute Profiler will use the first version of ``Python3`` found in your system's ``PATH``. If the default version of Python3 is older than 3.8, you may need to update your system's ``PATH`` to point to a newer version of Python3. -Omniperf depends on a number of Python packages documented in the top-level -``requirements.txt`` file. Install these *before* configuring Omniperf. +ROCm Compute Profiler depends on a number of Python packages documented in the top-level +``requirements.txt`` file. Install these *before* configuring ROCm Compute Profiler. .. tip:: - If looking to build Omniperf as a developer, consider these additional + If looking to build ROCm Compute Profiler as a developer, consider these additional requirements. .. list-table:: @@ -64,18 +64,18 @@ Omniperf depends on a number of Python packages documented in the top-level - Python packages required to build this documentation from source. * - ``requirements-test.txt`` - - Python packages required to run Omniperf's CI suite using PyTest. + - Python packages required to run ROCm Compute Profiler's CI suite using PyTest. -The recommended procedure for Omniperf usage is to install into a shared file +The recommended procedure for ROCm Compute Profiler usage is to install into a shared file system so that multiple users can access the final installation. The following steps illustrate how to install the necessary Python dependencies -using `pip `_ and Omniperf into a +using `pip `_ and ROCm Compute Profiler into a shared location controlled by the ``INSTALL_DIR`` environment variable. .. tip:: - To always run Omniperf with a particular version of python, you can create a - bash alias. For example, to run Omniperf with Python 3.10, you can run the + To always run ROCm Compute Profiler with a particular version of python, you can create a + bash alias. For example, to run ROCm Compute Profiler with Python 3.10, you can run the following command: .. code-block:: shell @@ -97,13 +97,13 @@ follows. - Description * - ``CMAKE_INSTALL_PREFIX`` - - Controls the install path for Omniperf files. + - Controls the install path for ROCm Compute Profiler files. * - ``PYTHON_DEPS`` - Specifies an optional path to resolve Python package dependencies. * - ``MOD_INSTALL_PATH`` - - Specifies an optional path for separate Omniperf modulefile installation. + - Specifies an optional path for separate ROCm Compute Profiler modulefile installation. .. _core-install-steps: @@ -115,7 +115,7 @@ Install from source navigate into the top-level directory. .. - {{ config.version }} substitutes the Omniperf version in ../conf.py + {{ config.version }} substitutes the ROCm Compute Profiler version in ../conf.py .. datatemplate:nodata:: @@ -124,7 +124,7 @@ Install from source tar xfz omniperf-v{{ config.version }}.tar.gz cd omniperf-v{{ config.version }} -#. Next, install Python dependencies and complete the Omniperf configuration and +#. Next, install Python dependencies and complete the ROCm Compute Profiler configuration and install process. .. datatemplate:nodata:: @@ -137,7 +137,7 @@ Install from source # install python deps python3 -m pip install -t ${INSTALL_DIR}/python-libs -r requirements.txt - # configure Omniperf for shared install + # configure ROCm Compute Profiler for shared install mkdir build cd build cmake -DCMAKE_INSTALL_PREFIX=${INSTALL_DIR}/{{ config.version }} \ @@ -169,8 +169,8 @@ Execution using modulefiles The installation process includes the creation of an environment modulefile for use with `Lmod `_. On systems that support Lmod, -you can register the Omniperf modulefile directory and setup your environment -for execution of Omniperf as follows. +you can register the ROCm Compute Profiler modulefile directory and setup your environment +for execution of ROCm Compute Profiler as follows. .. datatemplate:nodata:: @@ -189,13 +189,13 @@ for execution of Omniperf as follows. .. tip:: If you're relying on an Lmod Python module locally, you may wish to customize - the resulting Omniperf modulefile post-installation to include extra + the resulting ROCm Compute Profiler modulefile post-installation to include extra module dependencies. Execution without modulefiles ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -To use Omniperf without the companion modulefile, update your ``PATH`` +To use ROCm Compute Profiler without the companion modulefile, update your ``PATH`` settings to enable access to the command line binary. If you installed Python dependencies in a shared location, also update your ``PYTHONPATH`` configuration. @@ -212,7 +212,7 @@ configuration. Install via package manager --------------------------- -Once ROCm (minimum version 6.2.0) is installed, you can install Omniperf using +Once ROCm (minimum version 6.2.0) is installed, you can install ROCm Compute Profiler using your operating system's native package manager using the following commands. See :doc:`rocm-install-on-linux:index` for guidance on installing the ROCm software stack. @@ -254,7 +254,7 @@ software stack. ROCProfiler ----------- -Omniperf relies on :doc:`ROCProfiler `'s ``rocprof`` binary +ROCm Compute Profiler relies on :doc:`ROCProfiler `'s ``rocprof`` binary during the profiling process. Normally, the path to this binary is detected automatically, but you can override the path by the setting the optional ``ROCPROF`` environment variable. diff --git a/docs/install/grafana-setup.rst b/docs/install/grafana-setup.rst index a7486d286..a5e10dfd6 100644 --- a/docs/install/grafana-setup.rst +++ b/docs/install/grafana-setup.rst @@ -1,10 +1,10 @@ .. meta:: - :description: Omniperf Grafana server installation and deployment - :keywords: Omniperf, ROCm, profiler, tool, Instinct, accelerator, AMD, + :description: ROCm Compute Profiler Grafana server installation and deployment + :keywords: ROCm Compute Profiler, ROCm, profiler, tool, Instinct, accelerator, AMD, install, deploy, Grafana, server, configuration, GUI **************************************** -Setting up a Grafana server for Omniperf +Setting up a Grafana server for ROCm Compute Profiler **************************************** A Grafana server is *not required* to profile or analyze performance data @@ -12,15 +12,15 @@ from the CLI. It's a supplementary mechanism to help you import performance data and examine it in a detailed `Grafana `_ dashboard GUI. -Learn about installing and configuring the main Omniperf tool in +Learn about installing and configuring the main ROCm Compute Profiler tool in :ref:`core-install`. -Setting up a Grafana instance for Omniperf requires the following basic software +Setting up a Grafana instance for ROCm Compute Profiler requires the following basic software dependencies. * `Docker Engine `_ -The recommended process for enabling the server-side of Omniperf is to use the +The recommended process for enabling the server-side of ROCm Compute Profiler is to use the provided ``Dockerfile`` to build the Grafana and MongoDB instance. .. _grafana-mongodb-setup: @@ -34,7 +34,7 @@ the following setup instructions. Install MongoDB utilities ------------------------- -Omniperf uses the +ROCm Compute Profiler uses the `mongoimport `_ utility to upload data to your Grafana instance's backend database. @@ -70,7 +70,7 @@ crash or reset. This is called *creating a persistent volume*. Build and launch the Docker container ------------------------------------- -You're now ready to build your ``Dockerfile``. Navigate to your Omniperf install +You're now ready to build your ``Dockerfile``. Navigate to your ROCm Compute Profiler install directory to begin. .. code-block:: bash @@ -117,7 +117,7 @@ Configure the MongoDB data source --------------------------------- You must configure your MongoDB data source in Grafana before first-time use. -Navigate to Grafana's **Configuration** page to add the "Omniperf Data" +Navigate to Grafana's **Configuration** page to add the "ROCm Compute Profiler Data" connection. .. figure:: ../data/install/datasource_config.jpg @@ -158,12 +158,12 @@ connection is successful. .. _grafana-import-dashboard-file: -Import the Omniperf dashboard file +Import the ROCm Compute Profiler dashboard file ---------------------------------- From the **Create** → **Import** page, upload the dashboard file, -``/dashboards/Omniperf_v{__VERSION__}_pub.json`` from the -:doc:`Omniperf tarball `. +``/dashboards/ROCm Compute Profiler_v{__VERSION__}_pub.json`` from the +:doc:`ROCm Compute Profiler tarball `. Edit both the dashboard **Name** and the **Unique identifier (UID)** fields to uniquely identify the dashboard. Click **Import** to complete the process. @@ -177,7 +177,7 @@ uniquely identify the dashboard. Click **Import** to complete the process. .. _grafana-select-workload: -Select and load the Omniperf workload +Select and load the ROCm Compute Profiler workload ------------------------------------- Once you have imported a dashboard you're ready to begin. Start by browsing @@ -185,10 +185,10 @@ available dashboards and selecting the dashboard you have just imported. .. figure:: ../data/install/opening_dashboard.png :align: center - :alt: Opening your Omniperf dashboard in Grafana + :alt: Opening your ROCm Compute Profiler dashboard in Grafana :width: 800 - Opening your Omniperf profiling dashboard in Grafana. + Opening your ROCm Compute Profiler profiling dashboard in Grafana. Remember that you need to upload workload data to the MongoDB backend before analyzing in your Grafana interface. See a detailed example of this in @@ -199,10 +199,10 @@ from the workload dropdown located at the top of your Grafana dashboard. .. figure:: ../data/install/grafana_workload_selection.png :align: center - :alt: Omniperf workload selection in Grafana + :alt: ROCm Compute Profiler workload selection in Grafana :width: 800 - Selecting your Omniperf workload in Grafana. + Selecting your ROCm Compute Profiler workload in Grafana. For more information on how to use the Grafana interface for analysis see :doc:`/how-to/analyze/grafana-gui`. diff --git a/docs/license.rst b/docs/license.rst index c423ed34f..b64c89729 100644 --- a/docs/license.rst +++ b/docs/license.rst @@ -1,6 +1,6 @@ .. meta:: - :description: Omniperf license - :keywords: Omniperf, ROCm, profiler, tool, Instinct, accelerator, AMD, + :description: ROCm Compute Profiler license + :keywords: ROCm Compute Profiler, ROCm, profiler, tool, Instinct, accelerator, AMD, license ******* diff --git a/docs/reference/compatible-accelerators.rst b/docs/reference/compatible-accelerators.rst index b93c72032..8ffe2cd99 100644 --- a/docs/reference/compatible-accelerators.rst +++ b/docs/reference/compatible-accelerators.rst @@ -1,20 +1,20 @@ .. meta:: - :description: Omniperf support: compatible accelerators and GPUs - :keywords: Omniperf, ROCm, profiler, tool, Instinct, accelerator, AMD, GPU + :description: ROCm Compute Profiler support: compatible accelerators and GPUs + :keywords: ROCm Compute Profiler, ROCm, profiler, tool, Instinct, accelerator, AMD, GPU *********************** Compatible accelerators *********************** The following table lists SoCs (System on Chip) tested for compatibility with -Omniperf. See :doc:`rocm:reference/gpu-arch-specs` for full AMD accelerator and +ROCm Compute Profiler. See :doc:`rocm:reference/gpu-arch-specs` for full AMD accelerator and GPU specifications. .. _def-soc: .. note:: - In Omniperf documentation, the term System on Chip (SoC) refers to a + In ROCm Compute Profiler documentation, the term System on Chip (SoC) refers to a particular family of AMD accelerators. .. list-table:: diff --git a/docs/reference/faq.rst b/docs/reference/faq.rst index 3cbbe778f..f8b55d2eb 100644 --- a/docs/reference/faq.rst +++ b/docs/reference/faq.rst @@ -1,6 +1,6 @@ .. meta:: - :description: Omniperf FAQ and troubleshooting - :keywords: Omniperf, FAQ, troubleshooting, ROCm, profiler, tool, Instinct, + :description: ROCm Compute Profiler FAQ and troubleshooting + :keywords: ROCm Compute Profiler, FAQ, troubleshooting, ROCm, profiler, tool, Instinct, accelerator, AMD, SSH, error, version, workaround, help *** @@ -9,7 +9,7 @@ FAQ Frequently asked questions and troubleshooting tips. -How do I export profiling data I have already generated using Omniperf? +How do I export profiling data I have already generated using ROCm Compute Profiler? ======================================================================= To interact with the Grafana GUI, you must sync data with the MongoDB diff --git a/docs/tutorial/includes/infinity-fabric-transactions.rst b/docs/tutorial/includes/infinity-fabric-transactions.rst index fd510bd49..f2b4c8450 100644 --- a/docs/tutorial/includes/infinity-fabric-transactions.rst +++ b/docs/tutorial/includes/infinity-fabric-transactions.rst @@ -5,7 +5,7 @@ Infinity Fabric transactions For this example, consider the :dev-sample:`Infinity Fabric™ sample ` distributed as a part of - Omniperf. + ROCm Compute Profiler. This following code snippet launches a simple read-only kernel. @@ -36,7 +36,7 @@ is identically false -- and thus we expect no writes. .. note:: - The actual sample included with Omniperf also includes the ability to select + The actual sample included with ROCm Compute Profiler also includes the ability to select different operation types (such as atomics, writes). This abbreviated version is presented here for reference only. @@ -44,13 +44,13 @@ Finally, this sample code lets the user control the :ref:`granularity of an allocation `, the owner of an allocation (local HBM, CPU DRAM or remote HBM), and the size of an allocation (the default is :math:`\sim4`\ GiB) via command line arguments. In doing so, we can explore -the impact of these parameters on the L2-Fabric metrics reported by Omniperf to +the impact of these parameters on the L2-Fabric metrics reported by ROCm Compute Profiler to further understand their meaning. .. note:: All results in this section were generated an a node of Infinity - Fabric connected MI250 accelerators using ROCm version 5.6.0, and Omniperf + Fabric connected MI250 accelerators using ROCm version 5.6.0, and ROCm Compute Profiler version 2.0.0. Although results may vary with ROCm versions and accelerator connectivity, we expect the lessons learned here to be broadly applicable. diff --git a/docs/tutorial/includes/instructions-per-cycle-and-utilizations.rst b/docs/tutorial/includes/instructions-per-cycle-and-utilizations.rst index dcbf37266..bd51df110 100644 --- a/docs/tutorial/includes/instructions-per-cycle-and-utilizations.rst +++ b/docs/tutorial/includes/instructions-per-cycle-and-utilizations.rst @@ -5,7 +5,7 @@ Instructions-per-cycle and utilizations example For this example, consider the :dev-sample:`instructions-per-cycle (IPC) example ` included with -Omniperf. +ROCm Compute Profiler. This example is compiled using ``c++17`` support: @@ -64,7 +64,7 @@ operation, i.e., a ``v_mov_b32`` instruction, e.g.: This instruction simply copies the contents from the source register (``v1``) to the destination register (``v0``). Investigating this kernel -with Omniperf, we see: +with ROCm Compute Profiler, we see: .. code-block:: shell-session @@ -240,7 +240,7 @@ instructions executed over the total There are further complications of the Issued IPC metric (**11.2.1**) that make its use more complicated. We will be explore that in the :ref:`following section `. For these reasons, - Omniperf typically promotes use of the regular IPC metric (**11.2.0**), e.g., in + ROCm Compute Profiler typically promotes use of the regular IPC metric (**11.2.0**), e.g., in the top-level Speed-of-Light chart. .. _ipc-internal-instructions: @@ -261,7 +261,7 @@ Here we choose to use the following no-op to make our point: s_nop 0x0 -Running this kernel through Omniperf yields: +Running this kernel through ROCm Compute Profiler yields: .. code-block:: shell-session @@ -362,7 +362,7 @@ operation, for instance: which, in analogue to our :ref:`v_mov ` example, copies the contents of the source scalar register (``s1``) to the destination -scalar register (``s0``). Running this kernel through Omniperf yields: +scalar register (``s0``). Running this kernel through ROCm Compute Profiler yields: .. code-block:: shell-session @@ -426,7 +426,7 @@ of our :ref:`v_mov ` example: That is, we wrap our :ref:`VALU ` operation inside a conditional where only one lane in our wavefront is active. Running this kernel -through Omniperf yields: +through ROCm Compute Profiler yields: .. code-block:: shell-session diff --git a/docs/tutorial/includes/lds-examples.rst b/docs/tutorial/includes/lds-examples.rst index f6cff7b72..0ce9a5a6f 100644 --- a/docs/tutorial/includes/lds-examples.rst +++ b/docs/tutorial/includes/lds-examples.rst @@ -4,12 +4,12 @@ LDS examples ============ For this example, consider the -:dev-sample:`LDS sample ` distributed as a part of Omniperf. This +:dev-sample:`LDS sample ` distributed as a part of ROCm Compute Profiler. This code contains two kernels to explore how both :doc:`LDS ` bandwidth and -bank conflicts are calculated in Omniperf. +bank conflicts are calculated in ROCm Compute Profiler. This example was compiled and run on an MI250 accelerator using ROCm -v5.6.0, and Omniperf v2.0.0. +v5.6.0, and ROCm Compute Profiler v2.0.0. .. code-block:: shell-session @@ -93,7 +93,7 @@ Recall our definition of this metric: Here we see that this instruction *could* have loaded up to 256 bytes of data (4 bytes for each work-item in the wavefront), and therefore this -is the expected value for this metric in Omniperf, hence why this metric +is the expected value for this metric in ROCm Compute Profiler, hence why this metric is named the “theoretical” bandwidth. To further illustrate this point we plot the relationship of the @@ -104,11 +104,11 @@ launched from 1 to 256: .. figure:: ../data/profiling-by-example/ldsbandwidth.png :align: center :alt: Comparison of effective bandwidth versus the theoretical bandwidth - metric in Omniperf for our simple example. + metric in ROCm Compute Profiler for our simple example. :width: 800 Comparison of effective bandwidth versus the theoretical bandwidth - metric in Omniperf for our simple example. + metric in ROCm Compute Profiler for our simple example. Here we see that the theoretical bandwidth metric follows a step-function. It increases only when another wavefront issues an LDS instruction for up to 256 diff --git a/docs/tutorial/includes/occupancy-limiters-example.rst b/docs/tutorial/includes/occupancy-limiters-example.rst index bd8129d12..e1f77abf1 100644 --- a/docs/tutorial/includes/occupancy-limiters-example.rst +++ b/docs/tutorial/includes/occupancy-limiters-example.rst @@ -4,15 +4,15 @@ Occupancy limiters example ========================== For this example, consider the -:dev-sample:`occupancy ` included with Omniperf. We will +:dev-sample:`occupancy ` included with ROCm Compute Profiler. We will investigate the use of the resource allocation panel in the :ref:`Workgroup Manager `’s metrics section to determine occupancy limiters. This code contains several kernels to explore how both various kernel resources impact achieved occupancy, and how this is reported in -Omniperf. +ROCm Compute Profiler. This example was compiled and run on a MI250 accelerator using ROCm -v5.6.0, and Omniperf v2.0.0: +v5.6.0, and ROCm Compute Profiler v2.0.0: .. code-block:: shell @@ -21,7 +21,7 @@ v5.6.0, and Omniperf v2.0.0: We have again included the ``--save-temps`` flag to get the corresponding assembly. -Finally, we generate our Omniperf profile as: +Finally, we generate our ROCm Compute Profiler profile as: .. code-block:: shell @@ -88,7 +88,7 @@ depend on the exact ROCm/compiler version. We will use various permutations of this kernel to limit occupancy, and more importantly for the purposes of this example, demonstrate how this -is reported in Omniperf. +is reported in ROCm Compute Profiler. .. _vgpr-occupancy: diff --git a/docs/tutorial/includes/valu-arithmetic-instruction-mix.rst b/docs/tutorial/includes/valu-arithmetic-instruction-mix.rst index 785fc6ecf..e061ec346 100644 --- a/docs/tutorial/includes/valu-arithmetic-instruction-mix.rst +++ b/docs/tutorial/includes/valu-arithmetic-instruction-mix.rst @@ -5,7 +5,7 @@ VALU arithmetic instruction mix For this example, consider the :dev-sample:`instruction mix sample ` distributed as a part - of Omniperf. + of ROCm Compute Profiler. .. note:: @@ -55,7 +55,7 @@ Instruction mix ^^^^^^^^^^^^^^^ This example was compiled and run on a MI250 accelerator using ROCm - v5.6.0, and Omniperf v2.0.0. + v5.6.0, and ROCm Compute Profiler v2.0.0. .. code-block:: shell diff --git a/docs/tutorial/includes/vector-memory-operation-counting.rst b/docs/tutorial/includes/vector-memory-operation-counting.rst index 2797ed8f2..2c00efd42 100644 --- a/docs/tutorial/includes/vector-memory-operation-counting.rst +++ b/docs/tutorial/includes/vector-memory-operation-counting.rst @@ -10,7 +10,7 @@ Global / Generic (FLAT) For this example, consider the :dev-sample:`vector memory sample ` distributed as a part of -Omniperf. This code launches many different versions of a simple +ROCm Compute Profiler. This code launches many different versions of a simple read/write/atomic-only kernels targeting various address spaces. For example, below is our simple ``global_write`` kernel: @@ -24,7 +24,7 @@ below is our simple ``global_write`` kernel: .. note:: This example was compiled and run on an MI250 accelerator using ROCm - v5.6.0, and Omniperf v2.0.0. + v5.6.0, and ROCm Compute Profiler v2.0.0. .. code-block:: shell-session @@ -304,7 +304,7 @@ Here we observe a now familiar pattern: the compiler to statically eliminate, but is identically false. In this case, our ``main()`` function initializes the data in ``ptr`` to zero. -Running Omniperf on this kernel yields: +Running ROCm Compute Profiler on this kernel yields: .. code-block:: shell-session @@ -383,7 +383,7 @@ false conditional (both ``zero`` and ``filter`` are set to zero in the kernel launch). Note that this is a *different* conditional from our pointer assignment (to avoid combination of the two). -Running Omniperf on this kernel reports: +Running ROCm Compute Profiler on this kernel reports: .. code-block:: shell-session @@ -468,7 +468,7 @@ to a pointer. } -Running Omniperf on this kernel yields: +Running ROCm Compute Profiler on this kernel yields: .. code-block:: shell-session @@ -537,7 +537,7 @@ operation targets both LDS and global memory: This assigns every other work-item to atomically update global memory or local memory. -Running this kernel through Omniperf shows: +Running this kernel through ROCm Compute Profiler shows: .. code-block:: shell-session @@ -647,13 +647,13 @@ Our strategy here is to: to global memory to prevent the compiler from optimizing it out. This example was compiled and run on an MI250 accelerator using ROCm v5.6.0, and -Omniperf v2.0.0. +ROCm Compute Profiler v2.0.0. .. code-block:: shell-session $ hipcc -O3 stack.hip -o stack.hip -And profiled using Omniperf: +And profiled using ROCm Compute Profiler: .. code-block:: shell-session diff --git a/docs/tutorial/learning-resources.rst b/docs/tutorial/learning-resources.rst index 931f1f7f1..8cc7bcce2 100644 --- a/docs/tutorial/learning-resources.rst +++ b/docs/tutorial/learning-resources.rst @@ -1,6 +1,6 @@ .. meta:: - :description: Omniperf external training resources - :keywords: Omniperf, ROCm, profiler, tool, Instinct, accelerator, AMD, + :description: ROCm Compute Profiler external training resources + :keywords: ROCm Compute Profiler, ROCm, profiler, tool, Instinct, accelerator, AMD, training, examples ****************** @@ -8,14 +8,14 @@ Learning resources ****************** This section is a catalog of external resources and third-party content that -can help you learn Omniperf. Some areas of the following content might be +can help you learn ROCm Compute Profiler. Some areas of the following content might be outdated. -Introduction to Omniperf +Introduction to ROCm Compute Profiler :fab:`youtube` `AMD profiling workshop (Pawsey Supercomputing Research Centre) `_ -Omniperf example exercises - ``__ +ROCm Compute Profiler example exercises + ``__ AMD Instinct™ tuning guides :doc:`rocm:how-to/tuning-guides/mi300x/workload` diff --git a/docs/tutorial/profiling-by-example.rst b/docs/tutorial/profiling-by-example.rst index e39239b9d..1276d1b3f 100644 --- a/docs/tutorial/profiling-by-example.rst +++ b/docs/tutorial/profiling-by-example.rst @@ -1,6 +1,6 @@ .. meta:: - :description: Omniperf: Profiling by example - :keywords: Omniperf, ROCm, profiler, tool, Instinct, accelerator, AMD + :description: ROCm Compute Profiler: Profiling by example + :keywords: ROCm Compute Profiler, ROCm, profiler, tool, Instinct, accelerator, AMD ******************** Profiling by example @@ -8,7 +8,7 @@ Profiling by example The following examples refer to sample :doc:`HIP ` code located in :fab:`github` :dev-sample:`ROCm/omniperf/blob/amd-mainline/sample <>` and distributed -as part of Omniperf. +as part of ROCm Compute Profiler. .. include:: ./includes/valu-arithmetic-instruction-mix.rst diff --git a/docs/what-is-omniperf.rst b/docs/what-is-omniperf.rst index 473be896f..60d8ec0aa 100644 --- a/docs/what-is-omniperf.rst +++ b/docs/what-is-omniperf.rst @@ -1,32 +1,32 @@ .. meta:: - :description: What is Omniperf? - :keywords: Omniperf, ROCm, profiler, tool, Instinct, accelerator, AMD + :description: What is ROCm Compute Profiler? + :keywords: ROCm Compute Profiler, ROCm, profiler, tool, Instinct, accelerator, AMD ***************** -What is Omniperf? +What is ROCm Compute Profiler? ***************** -Omniperf is a kernel-level profiling tool for machine learning and high +ROCm Compute Profiler is a kernel-level profiling tool for machine learning and high performance computing (HPC) workloads running on AMD Instinct™ accelerators. AMD Instinct MI-series accelerators are data center-class GPUs designed for -compute and have some graphics capabilities disabled or removed. Omniperf +compute and have some graphics capabilities disabled or removed. ROCm Compute Profiler primarily targets use with :doc:`accelerators in the MI300, MI200, and MI100 families `. Development is in progress to support Radeon™ (RDNA) GPUs. -Omniperf is built on top of :doc:`ROCProfiler ` to +ROCm Compute Profiler is built on top of :doc:`ROCProfiler ` to monitor hardware performance counters. .. _high-level-design: -High-level design of Omniperf +High-level design of ROCm Compute Profiler ============================= -The architecture of Omniperf consists of three major components shown in the +The architecture of ROCm Compute Profiler consists of three major components shown in the following diagram. -Core Omniperf profiler +Core ROCm Compute Profiler profiler ---------------------- Acquires raw performance counters via application replay using ``rocprof``. @@ -35,43 +35,43 @@ Counters are stored in a comma-separated-values format for further micro-benchmarks to acquire hierarchical roofline data. The roofline model is not available on accelerators pre-MI200. -Grafana server for Omniperf +Grafana server for ROCm Compute Profiler --------------------------- * **Grafana database import**: All raw performance counters are imported into a :ref:`backend MongoDB database ` to support analysis and visualization in the Grafana GUI. Compatibility with - previously generated data using older Omniperf versions is not guaranteed. + previously generated data using older ROCm Compute Profiler versions is not guaranteed. * **Grafana analysis dashboard GUI**: The :doc:`Grafana dashboard ` retrieves the raw counters information from the backend database. It displays the relevant performance metrics and visualization. -Omniperf standalone GUI analyzer +ROCm Compute Profiler standalone GUI analyzer -------------------------------- -Omniperf provides a :doc:`standalone GUI ` to +ROCm Compute Profiler provides a :doc:`standalone GUI ` to enable basic performance analysis without the need to import data into a database instance. Find setup instructions in :doc:`install/grafana-setup` .. image:: data/install/omniperf_server_vs_client_install.png :align: center - :alt: Architectural design of Omniperf + :alt: Architectural design of ROCm Compute Profiler :width: 800 -Omniperf features +ROCm Compute Profiler features ================= -Omniperf offers comprehensive profiling based on all available hardware counters +ROCm Compute Profiler offers comprehensive profiling based on all available hardware counters for the target accelerator. It delivers advanced performance analysis features, such as system Speed-of-Light (SOL) and hardware block-level SOL evaluations. -Additionally, Omniperf provides in-depth memory chart analysis, roofline +Additionally, ROCm Compute Profiler provides in-depth memory chart analysis, roofline analysis, baseline comparisons, and more, ensuring a thorough understanding of system performance. -Omniperf supports analysis through both the :doc:`command line ` or a -:doc:`GUI `. The following list describes Omniperf's features at a +ROCm Compute Profiler supports analysis through both the :doc:`command line ` or a +:doc:`GUI `. The following list describes ROCm Compute Profiler's features at a high level. * :doc:`Support for AMD Instinct MI300, MI200, and MI100 accelerators `