5a7cb724ce
* External CI: rename pipeline to rocprofiler-compute (#463)
Signed-off-by: Daniel Su <danielsu@amd.com>
* Update webui branding (#459)
* Update name and icon for browser tab to rocprofiler-compute.
Signed-off-by: xuchen-amd <xuchen@amd.com>
* Update name and icon for browser tab to rocprofiler-compute.
Signed-off-by: xuchen-amd <xuchen@amd.com>
---------
Signed-off-by: xuchen-amd <xuchen@amd.com>
* Update branding in documentation (#442)
* find/replace Omniperf to ROCm Compute Profiler
Signed-off-by: Peter Park <peter.park@amd.com>
* update name in Sphinx conf
Signed-off-by: Peter Park <peter.park@amd.com>
* mv what-is-omniperf.rst -> what-is-rocprof-compute.rst
Signed-off-by: Peter Park <peter.park@amd.com>
* update Tutorials section
Signed-off-by: Peter Park <peter.park@amd.com>
* add Omniperf as keyword to Conceptual section for internal search
Signed-off-by: Peter Park <peter.park@amd.com>
* update Reference section
Signed-off-by: Peter Park <peter.park@amd.com>
* black fmt conf.py
Signed-off-by: Peter Park <peter.park@amd.com>
* update profile mode and basic usage subsections
Signed-off-by: Peter Park <peter.park@amd.com>
* update how to use analyze mode subsection
Signed-off-by: Peter Park <peter.park@amd.com>
* update install section
Signed-off-by: Peter Park <peter.park@amd.com>
* fix sphinx warnings
Signed-off-by: Peter Park <peter.park@amd.com>
* fix cmd line examples in profile/mode.rst
Signed-off-by: Peter Park <peter.park@amd.com>
* update install decision tree image
Signed-off-by: Peter Park <peter.park@amd.com>
* fix TOC and index
Signed-off-by: Peter Park <peter.park@amd.com>
fix weird wording
* fix cli text: deriving rocprofiler-compute metrics...
Signed-off-by: Peter Park <peter.park@amd.com>
* update standalone-gui.rst
Signed-off-by: Peter Park <peter.park@amd.com>
* restore removed doc updates from #428
Signed-off-by: Peter Park <peter.park@amd.com>
* update ref to Omniperf in index.rst
Signed-off-by: Peter Park <peter.park@amd.com>
* fix grafana connection name to match image
Signed-off-by: Peter Park <peter.park@amd.com>
* update cmds in tutorials
Signed-off-by: Peter Park <peter.park@amd.com>
---------
Signed-off-by: Peter Park <peter.park@amd.com>
* MI300 roofline enablement in rocprofiler-compute (#470)
* MI300 roofline enablement in rocprofiler-compute
requirements.txt
- running some modules complained about numpy version too new, adding extra requirement that numpy be 1.x
pmc_roof_perf.txt
- adding TCC_BUBBLE_sum counter to profile
soc_gfx940.py
soc_gfx941.py
soc_gfx942.py
- remove console logs reading that roofline is temporarily disabled, uncommenting blocks that check for roofline csv and run roofline post-processing
roofline_calc.py
- add mi300 to supported soc
- add new calculation for hbm_data for MI300 using tcc_bubble_sum, checks if counter > 0 to use
- add to a few comments
roofline-ubuntu-20_04-mi300-rocm6
- binary for the ubuntu systems to enable mi300 roofline calculations from rocm-amdgpu-bench
Note- other distros will get roofline bins to enable mi300, but need to be further tested before putting into branch.
Signed-off-by: Carrie Fallows <carrie.fallows@amd.com>
* Reformatting roofline_calc.py
Signed-off-by: Carrie Fallows <carrie.fallows@amd.com>
---------
Signed-off-by: Carrie Fallows <carrie.fallows@amd.com>
* Update Python format checker (#471)
* Add pre commit hook for Python formatting
Signed-off-by: coleramos425 <colramos@amd.com>
* Update formatting workflow to run on latest Python and add isort formatter
Signed-off-by: coleramos425 <colramos@amd.com>
* Fix caught yaml formatting issues
* Update pyproject file
* Add pre-commit hook instruction to CONTRIBUTING guide
* Remove target-version from black pyproject.toml
* Fixed formatting errors found with black and isort
Signed-off-by: David Galiffi <David.Galiffi@amd.com>
* Run hook: Whitespaces, fix end of file spaces
---------
Signed-off-by: coleramos425 <colramos@amd.com>
Signed-off-by: David Galiffi <David.Galiffi@amd.com>
Co-authored-by: David Galiffi <David.Galiffi@amd.com>
* Bump cryptography from 43.0.0 to 43.0.1 in /docs/sphinx (#473)
Bumps [cryptography](https://github.com/pyca/cryptography) from 43.0.0 to 43.0.1.
- [Changelog](https://github.com/pyca/cryptography/blob/main/CHANGELOG.rst)
- [Commits](https://github.com/pyca/cryptography/compare/43.0.0...43.0.1)
---
updated-dependencies:
- dependency-name: cryptography
dependency-type: indirect
...
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
* Fix file permission on MI300 roofline binary (#477)
Signed-off-by: David Galiffi <David.Galiffi@amd.com>
* Removing numpy requirements of <2 (#478)
Checks are failing if version too high and no need for lower version
Signed-off-by: Carrie Fallows <Carrie.Fallows@amd.com>
* Fix crash when loading web UI roofline for gfx942 (#479)
* Fix crash when loading web UI roofline for gfx942
* Fix formatting
Signed-off-by: benrichard-amd <ben.richard@amd.com>
* Make same changs for gfx940, gfx942.
Signed-off-by: benrichard-amd <ben.richard@amd.com>
* Fix formatting in soc_gfx940 and soc_gfx941.
Signed-off-by: benrichard-amd <ben.richard@amd.com>
---------
Signed-off-by: benrichard-amd <ben.richard@amd.com>
* Rebranding name change patch (#469)
* Patch in missed name change for rebranding.
Signed-off-by: xuchen-amd <xuchen@amd.com>
* Patch in missed name change for rebranding.
Signed-off-by: xuchen-amd <xuchen@amd.com>
---------
Signed-off-by: xuchen-amd <xuchen@amd.com>
* Move dependabot.yml to .github/ and bump rocm-docs-core (#481)
* Move dependabot.yml to .github/
* Bump rocm-docs-core to 1.8.5
* Bump rocm-docs-core to 1.9.0
* Fix packaging for upgrading (#486)
Specify that "rocprofiler-compute" replaces / obsoletes the "omniperf" package.
* Renamed extension path from omniperf to rocprofiler_compute (#487)
Signed-off-by: Tim Gu <Tim.Gu@amd.com>
* MI300 rhel and sles roofline binaries (#480)
* Roofline bins for MI300 on rhel and sles distributions
Built from rocm-amdgpu-bench, tested on respective distro systems with MI300 hardware.
Signed-off-by: Carrie Fallows <Carrie.Fallows@amd.com>
* Minor modifications removing hardcoded variables in roofline files.
Signed-off-by: Carrie Fallows <Carrie.Fallows@amd.com>
---------
Signed-off-by: Carrie Fallows <Carrie.Fallows@amd.com>
* Modify test_profile_general.py ctest to include MI300 enablement (#498)
Signed-off-by: Carrie Fallows <Carrie.Fallows@amd.com>
* part 1 to support rocprofv3 (#492)
* rocprofv3 support initial commit
-Can run rocprofv3 but ultimately fails. rocprofv3 says the counter capacity
is exceeded and the output CSV file format is different from v1/v2.
* Add rocprofv3 detection so v2 can still be used
It's hacky but it'll do for now.
* Add code path to convert rocprofv3 JSON output into CSV
* Grab correct value for Queue ID
* Use _sum suffix to sum TCC counters
Previously we were specifying each channel for TCC counters. rocprofv3 does
not support specifing each TCC channel, and instead will auto sum given
the TCC counter name. The counter name with the _sum suffix is also
supported and is also supported in v1 and v2. So we will use the TCC
counter name with the _sum suffix.
* Fix incorrect counter outputs when using rocprofv3
In the JSON output some counters appear multime times and must be
summed to get the correct value. These summed values match the
rocprofv3 output in CSV mode and also match the rocprofv2
output.
* Remove duplicate Correlation_ID and Wave_Size in output
* Handle json output that does not contain any dispatches
Omniperf was assuming each JSON output from rocprofv3 would always contain
dispatches. This is not the case. For example, in a multi-process
workload where one of the processes does not dispatch any kernels. A JSON
file will still be output for this process but it will not contain any dispatches.
* Code cleanup
* Update search path for rocprofv3 results
Rocprofv3 was updated to include the hostname in the path where
it outputs results.
* Handle accumulate counters
In v1/v2 rocprof uses the SQ_ACCUM_PREV_HIRES counter for the accumualte
counters. v3 does not have this. So we need to define our own counters
in counter_defs.yaml. For this we use the counter name + _ACCUM, for
example SQ_INSTR_LEVEL_SMEM_ACCUM.
To use rocprofv3 you will need to update counter_defs.yaml to include
these new counter definitions.
* Use correct GPU ID
When converting JSON -> CSV we were assigning node_id to GPU_ID. Since
the JSON contains non-GPU devices, the node_id for GPUs might not
start at 0 as expected.
This commit maps the agent ID to the appropriate GPU ID.
* Parse scratch memory per work item from JSON
* Support rocprofv3 CSV parsing
JSON decoding is very slow for large files. Include support for parsing
rocprofv3 CSV output and make that the default.
CSV/JSON can be toggled via the ROCPROF_OUTPUT_FORMAT environment
variable e.g. ROCPROF_OUTPUT_FORMAT=csv or ROCPROF_OUTPUT_FORMAT=json
* black format after merge
* format isort
* change return of rocprof_cmd to try to resolve test's error
* hack to pick last part of rocminfo's name
* debug log of hacks
* Modify test_profile_general.py ctest to include MI300 enablement. Currently failing because of explicitly excluded roofline files for the soc and autofailed asserts for roof-only tests- originally in place because roofline was not enabled on mi300 yet.
Signed-off-by: Carrie Fallows <Carrie.Fallows@amd.com>
* black and isort formated
* corrected line of copyright
---------
Signed-off-by: Carrie Fallows <Carrie.Fallows@amd.com>
Co-authored-by: benrichard-amd <ben.richard@amd.com>
Co-authored-by: YANG WANG <ywang@ywang-ubuntu.amd.com>
Co-authored-by: Carrie Fallows <Carrie.Fallows@amd.com>
* fix for crash of timestamp of part 1 for rocprofv3 (#499)
* fix the error caused by ignoring the lack of counter csv file from rocprofv3 for timestamp
* isort and black formated
* quick fix for gfx906 roofline (#505)
* Multi node support (#503)
* [CTest] Pipeline failures for MI300 (#483)
* Propagate new chip_id logic to testing workflow
Signed-off-by: coleramos425 <colramos@amd.com>
* Add a debug line to tests
Signed-off-by: coleramos425 <colramos@amd.com>
* Trying to set rocprofv2 generally in CTest module
Signed-off-by: coleramos425 <colramos@amd.com>
* Remove temp debugging lines from CI
Signed-off-by: coleramos425 <colramos@amd.com>
* Add roofline entry for MI300 expected files in CI tests
Signed-off-by: coleramos425 <colramos@amd.com>
* Make num_devices modifier global in scope
Signed-off-by: coleramos425 <colramos@amd.com>
* Change kernel name in PyTest to confirm rocprofv2 bug
Related to https://ontrack-internal.amd.com/browse/SWDEV-503453
Signed-off-by: coleramos425 <colramos@amd.com>
---------
Signed-off-by: coleramos425 <colramos@amd.com>
* Spatial-multiplexing: part 1 profiling stage (#465)
* rocprofv3 support initial commit
-Can run rocprofv3 but ultimately fails. rocprofv3 says the counter capacity
is exceeded and the output CSV file format is different from v1/v2.
* Add rocprofv3 detection so v2 can still be used
It's hacky but it'll do for now.
* Add code path to convert rocprofv3 JSON output into CSV
* Grab correct value for Queue ID
* Use _sum suffix to sum TCC counters
Previously we were specifying each channel for TCC counters. rocprofv3 does
not support specifing each TCC channel, and instead will auto sum given
the TCC counter name. The counter name with the _sum suffix is also
supported and is also supported in v1 and v2. So we will use the TCC
counter name with the _sum suffix.
* Fix incorrect counter outputs when using rocprofv3
In the JSON output some counters appear multime times and must be
summed to get the correct value. These summed values match the
rocprofv3 output in CSV mode and also match the rocprofv2
output.
* Remove duplicate Correlation_ID and Wave_Size in output
* Handle json output that does not contain any dispatches
Omniperf was assuming each JSON output from rocprofv3 would always contain
dispatches. This is not the case. For example, in a multi-process
workload where one of the processes does not dispatch any kernels. A JSON
file will still be output for this process but it will not contain any dispatches.
* Code cleanup
* Update search path for rocprofv3 results
Rocprofv3 was updated to include the hostname in the path where
it outputs results.
* Handle accumulate counters
In v1/v2 rocprof uses the SQ_ACCUM_PREV_HIRES counter for the accumualte
counters. v3 does not have this. So we need to define our own counters
in counter_defs.yaml. For this we use the counter name + _ACCUM, for
example SQ_INSTR_LEVEL_SMEM_ACCUM.
To use rocprofv3 you will need to update counter_defs.yaml to include
these new counter definitions.
* debug code
* add logic code for multiplexing
* minor fix
* more fixes
* rocprofv3 support initial commit
-Can run rocprofv3 but ultimately fails. rocprofv3 says the counter capacity
is exceeded and the output CSV file format is different from v1/v2.
* Add rocprofv3 detection so v2 can still be used
It's hacky but it'll do for now.
* Add code path to convert rocprofv3 JSON output into CSV
* Grab correct value for Queue ID
* Use _sum suffix to sum TCC counters
Previously we were specifying each channel for TCC counters. rocprofv3 does
not support specifing each TCC channel, and instead will auto sum given
the TCC counter name. The counter name with the _sum suffix is also
supported and is also supported in v1 and v2. So we will use the TCC
counter name with the _sum suffix.
* Fix incorrect counter outputs when using rocprofv3
In the JSON output some counters appear multime times and must be
summed to get the correct value. These summed values match the
rocprofv3 output in CSV mode and also match the rocprofv2
output.
* Remove duplicate Correlation_ID and Wave_Size in output
* Handle json output that does not contain any dispatches
Omniperf was assuming each JSON output from rocprofv3 would always contain
dispatches. This is not the case. For example, in a multi-process
workload where one of the processes does not dispatch any kernels. A JSON
file will still be output for this process but it will not contain any dispatches.
* Code cleanup
* Update search path for rocprofv3 results
Rocprofv3 was updated to include the hostname in the path where
it outputs results.
* Handle accumulate counters
In v1/v2 rocprof uses the SQ_ACCUM_PREV_HIRES counter for the accumualte
counters. v3 does not have this. So we need to define our own counters
in counter_defs.yaml. For this we use the counter name + _ACCUM, for
example SQ_INSTR_LEVEL_SMEM_ACCUM.
To use rocprofv3 you will need to update counter_defs.yaml to include
these new counter definitions.
* count accu files as well
* Use correct GPU ID
When converting JSON -> CSV we were assigning node_id to GPU_ID. Since
the JSON contains non-GPU devices, the node_id for GPUs might not
start at 0 as expected.
This commit maps the agent ID to the appropriate GPU ID.
* fix error with csv file parse from json and merge during post-processing
* implemented parsing of csv files from v3 output for optimization
* Parse scratch memory per work item from JSON
* Support rocprofv3 CSV parsing
JSON decoding is very slow for large files. Include support for parsing
rocprofv3 CSV output and make that the default.
CSV/JSON can be toggled via the ROCPROF_OUTPUT_FORMAT environment
variable e.g. ROCPROF_OUTPUT_FORMAT=csv or ROCPROF_OUTPUT_FORMAT=json
* black format after merge
* format isort
* change return of rocprof_cmd to try to resolve test's error
* hack to pick last part of rocminfo's name
* debug log of hacks
* Modify test_profile_general.py ctest to include MI300 enablement. Currently failing because of explicitly excluded roofline files for the soc and autofailed asserts for roof-only tests- originally in place because roofline was not enabled on mi300 yet.
Signed-off-by: Carrie Fallows <Carrie.Fallows@amd.com>
* black and isort formated
* formated by isort and black
* change default rocprof's output to csv
* repaired crash caused by missing csv counter file when running for timestamp
* change name to spatial-multiplexing from multiplexing
* make necessary modification for review
* set the value of spatial_multiplexing in argument defautly to None
* repair the part that blocks regular pmc files' generation
---------
Signed-off-by: Carrie Fallows <Carrie.Fallows@amd.com>
Co-authored-by: benrichard-amd <ben.richard@amd.com>
Co-authored-by: fei.zheng <fei.zheng@amd.com>
Co-authored-by: YANG WANG <ywang@ywang-ubuntu.amd.com>
Co-authored-by: Carrie Fallows <Carrie.Fallows@amd.com>
* Simple fix for gpu model value. (#508)
Signed-off-by: xuchen-amd <xuchen@amd.com>
* Add FP64 to plot adhering to pdf name (#507)
* Replacing FP32-only plot with an FP32&FP64 combo plot. Results will likely be negligible but the plot name indicates both should be graphed.
Signed-off-by: Carrie Fallows <Carrie.Fallows@amd.com>
* Remove duplicate AI plot to clean up fp32 fp64 graph
Signed-off-by: Carrie Fallows <Carrie.Fallows@amd.com>
---------
Signed-off-by: Carrie Fallows <Carrie.Fallows@amd.com>
* Add gpu series for roofline (#510)
* Add gpu_series for roofline.
* Use gpu_series in path names for roofline.
* Fix TCC on MI200 when introduce rocprofv3 (#509)
* quick fix for v2
* one more fix
* revert a bit
---------
Co-authored-by: ywang103-amd <ywang103@amd.com>
* Bump rocm-docs-core from 1.9.0 to 1.12.0 in /docs/sphinx (#511)
Bumps [rocm-docs-core](https://github.com/ROCm/rocm-docs-core) from 1.9.0 to 1.12.0.
- [Release notes](https://github.com/ROCm/rocm-docs-core/releases)
- [Changelog](https://github.com/ROCm/rocm-docs-core/blob/develop/CHANGELOG.md)
- [Commits](https://github.com/ROCm/rocm-docs-core/compare/v1.9.0...v1.12.0)
---
updated-dependencies:
- dependency-name: rocm-docs-core
dependency-type: direct:production
update-type: version-update:semver-minor
...
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
* Update sample roofline plot img (#516)
* Modify path to use gpu_model instead of gpu_series to match other workload directory path creation/search points. Affects manual testing, does not seem to affect ctests. (#513)
Signed-off-by: Carrie Fallows <Carrie.Fallows@amd.com>
* Improve formatting when displaying rocprof command. (#476)
* Improve formatting when displaying rocprof command.
Signed-off-by: xuchen-amd <xuchen@amd.com>
* Fix python formatting.
Signed-off-by: xuchen-amd <xuchen@amd.com>
* Strip unwanted characters (rocprofv1 specific) from rocprof commands.
Signed-off-by: xuchen-amd <xuchen@amd.com>
* Strip unwanted characters (rocprofv1 specific) from rocprof commands.
Signed-off-by: xuchen-amd <xuchen@amd.com>
* Save the unmodified arguments for rocprof for debug message display.
Signed-off-by: xuchen-amd <xuchen@amd.com>
---------
Signed-off-by: xuchen-amd <xuchen@amd.com>
* quick fix for mpi_support (#518)
* Pass accumulate counters to rocprofv3 using -E option (#522)
rocprofv3 has a new -E option where extra counters can be passed (see accum_counters.yaml) instead
of defining them in counter_defs.yaml.
* Unify all file handling with pathlib (#512)
* Replace occurences of os.path functions with equivalent functions from
pathlib library
* Remove unwanted imports of os.path and os
* Add coding guidelines for using pathlib instead of os.path
* Auto sync staging and mainline on a weekly cadence (#517)
Signed-off-by: coleramos425 <colramos@amd.com>
---------
Signed-off-by: Daniel Su <danielsu@amd.com>
Signed-off-by: xuchen-amd <xuchen@amd.com>
Signed-off-by: Peter Park <peter.park@amd.com>
Signed-off-by: Carrie Fallows <carrie.fallows@amd.com>
Signed-off-by: coleramos425 <colramos@amd.com>
Signed-off-by: David Galiffi <David.Galiffi@amd.com>
Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Carrie Fallows <Carrie.Fallows@amd.com>
Signed-off-by: benrichard-amd <ben.richard@amd.com>
Signed-off-by: Tim Gu <Tim.Gu@amd.com>
Co-authored-by: Daniel Su <danielsu@amd.com>
Co-authored-by: xuchen-amd <xuchen@amd.com>
Co-authored-by: Peter Park <peter.park@amd.com>
Co-authored-by: cfallows-amd <Carrie.Fallows@amd.com>
Co-authored-by: David Galiffi <David.Galiffi@amd.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Ben Richard <143630488+benrichard-amd@users.noreply.github.com>
Co-authored-by: Tim Gu <Tim.Gu@amd.com>
Co-authored-by: ywang103-amd <ywang103@amd.com>
Co-authored-by: benrichard-amd <ben.richard@amd.com>
Co-authored-by: YANG WANG <ywang@ywang-ubuntu.amd.com>
Co-authored-by: Fei Zheng <44449748+feizheng10@users.noreply.github.com>
Co-authored-by: fei.zheng <fei.zheng@amd.com>
Co-authored-by: vedithal-amd <Vignesh.Edithal@amd.com>
[ROCm/rocprofiler-compute commit: 272e5b6e32]
776 rivejä
28 KiB
ReStructuredText
776 rivejä
28 KiB
ReStructuredText
.. meta::
|
||
:description: ROCm Compute Profiler performance model: L2 cache (TCC)
|
||
:keywords: Omniperf, ROCm Compute Profiler, ROCm, profiler, tool, Instinct, accelerator, L2, cache, infinity fabric, metrics
|
||
|
||
**************
|
||
L2 cache (TCC)
|
||
**************
|
||
|
||
The L2 cache is the coherence point for current AMD Instinct™ MI-series GCN™
|
||
GPUs and CDNA™ accelerators, and is shared by all :doc:`CUs <compute-unit>`
|
||
on the device. Besides serving requests from the
|
||
:doc:`vector L1 data caches <vector-l1-cache>`, the L2 cache also is responsible
|
||
for servicing requests from the :ref:`L1 instruction caches <desc-l1i>`, the
|
||
:ref:`scalar L1 data caches <desc-sL1D>` and the
|
||
:doc:`command processor <command-processor>`. The L2 cache is composed of a
|
||
number of distinct channels (32 on MI100 and :ref:`MI2XX <mixxx-note>` series CDNA
|
||
accelerators at 256B address interleaving) which can largely operate
|
||
independently. Mapping of incoming requests to a specific L2 channel is
|
||
determined by a hashing mechanism that attempts to evenly distribute requests
|
||
across the L2 channels. Requests that miss in the L2 cache are passed out to
|
||
:ref:`Infinity Fabric™ <l2-fabric>` to be routed to the appropriate memory
|
||
location.
|
||
|
||
The L2 cache metrics reported by ROCm Compute Profiler are broken down into four
|
||
categories:
|
||
|
||
* :ref:`L2 Speed-of-Light <l2-sol>`
|
||
|
||
* :ref:`L2 cache accesses <l2-cache-accesses>`
|
||
|
||
* :ref:`L2-Fabric transactions <l2-fabric>`
|
||
|
||
* :ref:`L2-Fabric stalls <l2-fabric-stalls>`
|
||
|
||
.. _l2-sol:
|
||
|
||
L2 Speed-of-Light
|
||
=================
|
||
|
||
.. warning::
|
||
|
||
The theoretical maximum throughput for some metrics in this section
|
||
are currently computed with the maximum achievable clock frequency, as
|
||
reported by ``rocminfo``, for an accelerator. This may not be realistic for
|
||
all workloads.
|
||
|
||
The L2 cache’s speed-of-light table contains a few key metrics about the
|
||
performance of the L2 cache, aggregated over all the L2 channels, as a
|
||
comparison with the peak achievable values of those metrics:
|
||
|
||
.. list-table::
|
||
:header-rows: 1
|
||
|
||
* - Metric
|
||
|
||
- Description
|
||
|
||
- Unit
|
||
|
||
* - Utilization
|
||
|
||
- The ratio of the
|
||
:ref:`number of cycles an L2 channel was active, summed over all L2 channels on the accelerator <total-active-l2-cycles>`
|
||
over the :ref:`total L2 cycles <total-l2-cycles>`.
|
||
|
||
- Percent
|
||
|
||
* - Bandwidth
|
||
|
||
- The number of bytes looked up in the L2 cache, as a percent of the peak
|
||
theoretical bandwidth achievable on the specific accelerator. The number
|
||
of bytes is calculated as the number of cache lines requested multiplied
|
||
by the cache line size. This value does not consider partial requests, so
|
||
e.g., if only a single value is requested in a cache line, the data
|
||
movement will still be counted as a full cache line.
|
||
|
||
- Percent
|
||
|
||
* - Hit Rate
|
||
|
||
- The ratio of the number of L2 cache line requests that hit in the L2
|
||
cache over the total number of incoming cache line requests to the L2
|
||
cache.
|
||
|
||
- Percent
|
||
|
||
* - L2-Fabric Read BW
|
||
|
||
- The number of bytes read by the L2 over the
|
||
:ref:`Infinity Fabric interface <l2-fabric>` per unit time.
|
||
|
||
- GB/s
|
||
|
||
* - L2-Fabric Write and Atomic BW
|
||
|
||
- The number of bytes sent by the L2 over the
|
||
:ref:`Infinity Fabric interface <l2-fabric>` by write and atomic
|
||
operations per unit time.
|
||
|
||
- GB/s
|
||
|
||
.. note::
|
||
|
||
The L2 cache on AMD Instinct MI CDNA accelerators uses a "hit-on-miss"
|
||
approach to reporting cache hits. That is, if while satisfying a miss,
|
||
another request comes in that would hit on the same pending cache line, the
|
||
subsequent request will be counted as a 'hit'. Therefore, it is also
|
||
important to consider the latency metric in the :ref:`L2-Fabric <l2-fabric>`
|
||
section when evaluating the L2 hit rate.
|
||
|
||
.. _l2-cache-accesses:
|
||
|
||
L2 cache accesses
|
||
=================
|
||
|
||
This section details the incoming requests to the L2 cache from the
|
||
:doc:`vL1D <vector-l1-cache>` and other clients -- for instance, the
|
||
:ref:`sL1D <desc-sL1D>` and :ref:`L1I <desc-l1i>` caches.
|
||
|
||
.. list-table::
|
||
:header-rows: 1
|
||
:widths: 13 70 17
|
||
|
||
* - Metric
|
||
|
||
- Description
|
||
|
||
- Unit
|
||
|
||
* - Bandwidth
|
||
|
||
- The number of bytes looked up in the L2 cache, per
|
||
:ref:`normalization unit <normalization-units>`. The number of bytes is
|
||
calculated as the number of cache lines requested multiplied by the cache
|
||
line size. This value does not consider partial requests, so for example,
|
||
if only a single value is requested in a cache line, the data movement
|
||
will still be counted as a full cache line.
|
||
|
||
- Bytes per :ref:`normalization unit <normalization-units>`.
|
||
|
||
* - Requests
|
||
|
||
- The total number of incoming requests to the L2 from all clients for all
|
||
request types, per :ref:`normalization unit <normalization-units>`.
|
||
|
||
- Requests per :ref:`normalization unit <normalization-units>`.
|
||
|
||
* - Read Requests
|
||
|
||
- The total number of read requests to the L2 from all clients.
|
||
|
||
- Requests per :ref:`normalization unit <normalization-units>`
|
||
|
||
* - Write Requests
|
||
|
||
- The total number of write requests to the L2 from all clients.
|
||
|
||
- Requests per :ref:`normalization unit <normalization-units>`
|
||
|
||
* - Atomic Requests
|
||
|
||
- The total number of atomic requests (with and without return) to the L2
|
||
from all clients.
|
||
|
||
- Requests per :ref:`normalization unit <normalization-units>`
|
||
|
||
* - Streaming Requests
|
||
|
||
- The total number of incoming requests to the L2 that are marked as
|
||
*streaming*. The exact meaning of this may differ depending on the
|
||
targeted accelerator, however on an :ref:`MI2XX <mixxx-note>` this
|
||
corresponds to
|
||
`non-temporal load or stores <https://clang.llvm.org/docs/LanguageExtensions.html#non-temporal-load-store-builtins>`_.
|
||
The L2 cache attempts to evict *streaming* requests before normal
|
||
requests when the L2 is at capacity.
|
||
|
||
- Requests per :ref:`normalization unit <normalization-units>`
|
||
|
||
* - Probe Requests
|
||
|
||
- The number of coherence probe requests made to the L2 cache from outside
|
||
the accelerator. On an :ref:`MI2XX <mixxx-note>`, probe requests may be
|
||
generated by, for example, writes to
|
||
:ref:`fine-grained device <memory-type>` memory or by writes to
|
||
:ref:`coarse-grained <memory-type>` device memory.
|
||
|
||
- Requests per :ref:`normalization unit <normalization-units>`
|
||
|
||
* - Hit Rate
|
||
|
||
- The ratio of the number of L2 cache line requests that hit in the L2
|
||
cache over the total number of incoming cache line requests to the L2
|
||
cache.
|
||
|
||
- Percent
|
||
|
||
* - Hits
|
||
|
||
- The total number of requests to the L2 from all clients that hit in the
|
||
cache. As noted in the :ref:`Speed-of-Light <l2-sol>` section, this
|
||
includes hit-on-miss requests.
|
||
|
||
- Requests per :ref:`normalization unit <normalization-units>`
|
||
|
||
* - Misses
|
||
|
||
- The total number of requests to the L2 from all clients that miss in the
|
||
cache. As noted in the :ref:`Speed-of-Light <l2-sol>` section, these do
|
||
not include hit-on-miss requests.
|
||
|
||
- Requests per :ref:`normalization unit <normalization-units>`
|
||
|
||
* - Writebacks
|
||
|
||
- The total number of L2 cache lines written back to memory for any reason.
|
||
Write-backs may occur due to user code (such as HIP kernel calls to
|
||
``__threadfence_system`` or atomic built-ins) by the
|
||
:doc:`command processor <command-processor>`'s memory acquire/release
|
||
fences, or for other internal hardware reasons.
|
||
|
||
- Cache lines per :ref:`normalization unit <normalization-units>`
|
||
|
||
* - Writebacks (Internal)
|
||
|
||
- The total number of L2 cache lines written back to memory for internal
|
||
hardware reasons, per :ref:`normalization unit <normalization-units>`.
|
||
|
||
- Cache lines per :ref:`normalization unit <normalization-units>`.
|
||
|
||
* - Writebacks (vL1D Req)
|
||
|
||
- The total number of L2 cache lines written back to memory due to requests
|
||
initiated by the :doc:`vL1D cache <vector-l1-cache>`, per
|
||
:ref:`normalization unit <normalization-units>`.
|
||
|
||
- Cache lines per :ref:`normalization unit <normalization-units>`.
|
||
|
||
* - Evictions (Normal)
|
||
|
||
- The total number of L2 cache lines evicted from the cache due to capacity
|
||
limits, per :ref:`normalization unit <normalization-units>`.
|
||
|
||
- Cache lines per :ref:`normalization unit <normalization-units>`.
|
||
|
||
* - Evictions (vL1D Req)
|
||
|
||
- The total number of L2 cache lines evicted from the cache due to
|
||
invalidation requests initiated by the
|
||
:doc:`vL1D cache <vector-l1-cache>`, per
|
||
:ref:`normalization unit <normalization-units>`.
|
||
|
||
- Cache lines per :ref:`normalization unit <normalization-units>`.
|
||
|
||
* - Non-hardware-Coherent Requests
|
||
|
||
- The total number of requests to the L2 to Not-hardware-Coherent (NC)
|
||
memory allocations, per :ref:`normalization unit <normalization-units>`.
|
||
See the :ref:`memory-type` for more information.
|
||
|
||
- Requests per :ref:`normalization unit <normalization-units>`.
|
||
|
||
* - Uncached Requests
|
||
|
||
- The total number of requests to the L2 that go to Uncached (UC) memory
|
||
allocations. See the :ref:`memory-type` for more information.
|
||
|
||
- Requests per :ref:`normalization unit <normalization-units>`.
|
||
|
||
* - Coherently Cached Requests
|
||
|
||
- The total number of requests to the L2 that go to Coherently Cacheable (CC)
|
||
memory allocations. See the :ref:`memory-type` for more information.
|
||
|
||
- Requests per :ref:`normalization unit <normalization-units>`.
|
||
|
||
* - Read/Write Coherent Requests
|
||
|
||
- The total number of requests to the L2 that go to Read-Write coherent memory
|
||
(RW) allocations. See the :ref:`memory-type` for more information.
|
||
|
||
- Requests per :ref:`normalization unit <normalization-units>`.
|
||
|
||
.. note::
|
||
|
||
All requests to the L2 are for a single cache line's worth of data. The size
|
||
of a cache line may vary depending on the accelerator, however on an AMD
|
||
Instinct CDNA2 :ref:`MI2XX <mixxx-note>` accelerator, it is 128B, while on
|
||
an MI100, it is 64B.
|
||
|
||
.. _l2-fabric:
|
||
|
||
L2-Fabric transactions
|
||
======================
|
||
|
||
Requests/data that miss in the L2 must be routed to memory in order to
|
||
service them. The backing memory for a request may be local to this
|
||
accelerator (i.e., in the local high-bandwidth memory), in a remote
|
||
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 ROCm Compute Profiler metrics,
|
||
while :ref:`l2-request-metrics` give detailed definitions of
|
||
individual metrics.
|
||
|
||
.. _l2-request-flow:
|
||
|
||
Request flow
|
||
------------
|
||
|
||
The following is a diagram that illustrates how L2↔Fabric requests are reported
|
||
by ROCm Compute Profiler:
|
||
|
||
.. figure:: ../data/performance-model/fabric.png
|
||
:align: center
|
||
:alt: L2-Fabric transaction flow on AMD Instinct MI-series accelerators
|
||
:width: 800
|
||
|
||
L2↔Fabric transaction flow on AMD Instinct MI-series accelerators.
|
||
|
||
|
||
Requests from the L2 Cache are broken down into two major categories, read
|
||
requests and write requests (at this granularity, atomic requests are treated
|
||
as writes).
|
||
|
||
From there, these requests can additionally subdivided in a number of ways.
|
||
First, these requests may be sent across Infinity Fabric as different
|
||
transaction sizes, 32B or 64B on current CDNA accelerators.
|
||
|
||
.. note::
|
||
|
||
On current CDNA accelerators, the 32B read request path is expected to be
|
||
unused and so is disconnected in the flow diagram.
|
||
|
||
In addition, the read and write requests can be further categorized as:
|
||
|
||
* Uncached read/write requests, for instance: for access to
|
||
:ref:`fine-grained memory <memory-type>`
|
||
|
||
* Atomic requests, for instance: for atomic updates to
|
||
:ref:`fine-grained memory <memory-type>`
|
||
|
||
* HBM read/write requests OR remote read/write requests, for instance: for
|
||
requests to the accelerator’s local HBM OR requests to a remote accelerator’s
|
||
HBM or the CPU’s DRAM
|
||
|
||
These classifications are not necessarily *exclusive*. For example, a
|
||
write request can be classified as an atomic request to the
|
||
accelerator’s local HBM, and an uncached write request. The request-flow
|
||
diagram marks *exclusive* classifications as a splitting of the flow,
|
||
while *non-exclusive* requests do not split the flow line. For example,
|
||
a request is either a 32B Write Request OR a 64B Write request, as the
|
||
flow splits at this point:
|
||
|
||
.. figure:: ../data/performance-model/split.*
|
||
:align: center
|
||
:alt: Splitting request flow
|
||
:width: 800
|
||
|
||
Splitting request flow
|
||
|
||
However, continuing along, the same request might be an atomic request and an
|
||
uncached write request, as reflected by a non-split flow:
|
||
|
||
.. figure:: ../data/performance-model/nosplit.*
|
||
:align: center
|
||
:alt: Non-splitting request flow
|
||
:width: 800
|
||
|
||
Non-splitting request flow
|
||
|
||
Finally, we note that :ref:`uncached <memory-type>` read requests (e.g., to
|
||
:ref:`fine-grained memory <memory-type>`) are handled specially on CDNA
|
||
accelerators, as indicated in the request flow diagram. These are
|
||
expected to be counted as a 64B Read Request, and *if* they are requests
|
||
to uncached memory (denoted by the dashed line), they will also be
|
||
counted as *two* uncached read requests (that is, the request is split):
|
||
|
||
.. figure:: ../data/performance-model/uncached.*
|
||
:align: center
|
||
:alt: Uncached read-request splitting
|
||
:width: 800
|
||
|
||
Uncached read-request splitting.
|
||
|
||
.. _l2-request-metrics:
|
||
|
||
Metrics
|
||
-------
|
||
|
||
The following metrics are reported for the L2-Fabric interface:
|
||
|
||
.. list-table::
|
||
:header-rows: 1
|
||
|
||
* - Metric
|
||
|
||
- Description
|
||
|
||
- Unit
|
||
|
||
* - L2-Fabric Read Bandwidth
|
||
|
||
- The total number of bytes read by the L2 cache from Infinity Fabric per
|
||
:ref:`normalization unit <normalization-units>`.
|
||
|
||
- Bytes per :ref:`normalization unit <normalization-units>`.
|
||
|
||
* - HBM Read Traffic
|
||
|
||
- The percent of read requests generated by the L2 cache that are routed to
|
||
the accelerator's local high-bandwidth memory (HBM). This breakdown does
|
||
not consider the *size* of the request (meaning that 32B and 64B requests
|
||
are both counted as a single request), so this metric only *approximates*
|
||
the percent of the L2-Fabric Read bandwidth directed to the local HBM.
|
||
|
||
- Percent
|
||
|
||
* - Remote Read Traffic
|
||
|
||
- The percent of read requests generated by the L2 cache that are routed to
|
||
any memory location other than the accelerator's local high-bandwidth
|
||
memory (HBM) -- for example, the CPU's DRAM or a remote accelerator's
|
||
HBM. This breakdown does not consider the *size* of the request (meaning
|
||
that 32B and 64B requests are both counted as a single request), so this
|
||
metric only *approximates* the percent of the L2-Fabric Read bandwidth
|
||
directed to a remote location.
|
||
|
||
- Percent
|
||
|
||
* - Uncached Read Traffic
|
||
|
||
- The percent of read requests generated by the L2 cache that are reading
|
||
from an :ref:`uncached memory allocation <memory-type>`. Note, as
|
||
described in the :ref:`request flow <l2-request-flow>` section, a single
|
||
64B read request is typically counted as two uncached read requests. So,
|
||
it is possible for the Uncached Read Traffic to reach up to 200% of the
|
||
total number of read requests. This breakdown does not consider the
|
||
*size* of the request (i.e., 32B and 64B requests are both counted as a
|
||
single request), so this metric only *approximates* the percent of the
|
||
L2-Fabric read bandwidth directed to an uncached memory location.
|
||
|
||
- Percent
|
||
|
||
* - L2-Fabric Write and Atomic Bandwidth
|
||
|
||
- The total number of bytes written by the L2 over Infinity Fabric by write
|
||
and atomic operations per
|
||
:ref:`normalization unit <normalization-units>`. Note that on current
|
||
CDNA accelerators, such as the :ref:`MI2XX <mixxx-note>`, requests are
|
||
only considered *atomic* by Infinity Fabric if they are targeted at
|
||
non-write-cacheable memory, for example,
|
||
:ref:`fine-grained memory <memory-type>` allocations or
|
||
:ref:`uncached memory <memory-type>` allocations on the
|
||
MI2XX.
|
||
|
||
- Bytes per :ref:`normalization unit <normalization-units>`.
|
||
|
||
* - HBM Write and Atomic Traffic
|
||
|
||
- The percent of write and atomic requests generated by the L2 cache that
|
||
are routed to the accelerator's local high-bandwidth memory (HBM). This
|
||
breakdown does not consider the *size* of the request (meaning that 32B
|
||
and 64B requests are both counted as a single request), so this metric
|
||
only *approximates* the percent of the L2-Fabric Write and Atomic
|
||
bandwidth directed to the local HBM. Note that on current CDNA
|
||
accelerators, such as the :ref:`MI2XX <mixxx-note>`, requests are only
|
||
considered *atomic* by Infinity Fabric if they are targeted at
|
||
:ref:`fine-grained memory <memory-type>` allocations or
|
||
:ref:`uncached memory <memory-type>` allocations.
|
||
|
||
- Percent
|
||
|
||
* - Remote Write and Atomic Traffic
|
||
|
||
- The percent of read requests generated by the L2 cache that are routed to
|
||
any memory location other than the accelerator's local high-bandwidth
|
||
memory (HBM) -- for example, the CPU's DRAM or a remote accelerator's
|
||
HBM. This breakdown does not consider the *size* of the request (meaning
|
||
that 32B and 64B requests are both counted as a single request), so this
|
||
metric only *approximates* the percent of the L2-Fabric Read bandwidth
|
||
directed to a remote location. Note that on current CDNA
|
||
accelerators, such as the :ref:`MI2XX <mixxx-note>`, requests are only
|
||
considered *atomic* by Infinity Fabric if they are targeted at
|
||
:ref:`fine-grained memory <memory-type>` allocations or
|
||
:ref:`uncached memory <memory-type>` allocations.
|
||
|
||
- Percent
|
||
|
||
* - Atomic Traffic
|
||
|
||
- The percent of write requests generated by the L2 cache that are atomic
|
||
requests to *any* memory location. This breakdown does not consider the
|
||
*size* of the request (meaning that 32B and 64B requests are both counted
|
||
as a single request), so this metric only *approximates* the percent of
|
||
the L2-Fabric Read bandwidth directed to a remote location. Note that on
|
||
current CDNA accelerators, such as the :ref:`MI2XX <mixxx-note>`,
|
||
requests are only considered *atomic* by Infinity Fabric if they are
|
||
targeted at :ref:`fine-grained memory <memory-type>` allocations or
|
||
:ref:`uncached memory <memory-type>` allocations.
|
||
|
||
- Percent
|
||
|
||
* - Uncached Write and Atomic Traffic
|
||
|
||
- The percent of write and atomic requests generated by the L2 cache that
|
||
are targeting :ref:`uncached memory allocations <memory-type>`. This
|
||
breakdown does not consider the *size* of the request (meaning that 32B
|
||
and 64B requests are both counted as a single request), so this metric
|
||
only *approximates* the percent of the L2-Fabric read bandwidth directed
|
||
to uncached memory allocations.
|
||
|
||
- Percent
|
||
|
||
* - Read Latency
|
||
|
||
- The time-averaged number of cycles read requests spent in Infinity Fabric
|
||
before data was returned to the L2.
|
||
|
||
- Cycles
|
||
|
||
* - Write Latency
|
||
|
||
- The time-averaged number of cycles write requests spent in Infinity
|
||
Fabric before a completion acknowledgement was returned to the L2.
|
||
|
||
- Cycles
|
||
|
||
* - Atomic Latency
|
||
|
||
- The time-averaged number of cycles atomic requests spent in Infinity
|
||
Fabric before a completion acknowledgement (atomic without return value)
|
||
or data (atomic with return value) was returned to the L2.
|
||
|
||
- Cycles
|
||
|
||
* - Read Stall
|
||
|
||
- The ratio of the total number of cycles the L2-Fabric interface was
|
||
stalled on a read request to any destination (local HBM, remote PCIe®
|
||
connected accelerator or CPU, or remote Infinity Fabric connected
|
||
accelerator [#inf]_ or CPU) over the
|
||
:ref:`total active L2 cycles <total-active-l2-cycles>`.
|
||
|
||
- Percent
|
||
|
||
* - Write Stall
|
||
|
||
- The ratio of the total number of cycles the L2-Fabric interface was
|
||
stalled on a write or atomic request to any destination (local HBM,
|
||
remote accelerator or CPU, PCIe connected accelerator or CPU, or remote
|
||
Infinity Fabric connected accelerator [#inf]_ or CPU) over the
|
||
:ref:`total active L2 cycles <total-active-l2-cycles>`.
|
||
|
||
- Percent
|
||
|
||
.. _l2-detailed-metrics:
|
||
|
||
Detailed transaction metrics
|
||
----------------------------
|
||
|
||
The following metrics are available in the detailed L2-Fabric
|
||
transaction breakdown table:
|
||
|
||
.. list-table::
|
||
:header-rows: 1
|
||
|
||
* - Metric
|
||
|
||
- Description
|
||
|
||
- Unit
|
||
|
||
* - 32B Read Requests
|
||
|
||
- The total number of L2 requests to Infinity Fabric to read 32B of data
|
||
from any memory location, per
|
||
:ref:`normalization unit <normalization-units>`. See
|
||
:ref:`l2-request-flow` for more detail. Typically unused on CDNA
|
||
accelerators.
|
||
|
||
- Requests per :ref:`normalization unit <normalization-units>`.
|
||
|
||
* - Uncached Read Requests
|
||
|
||
- The total number of L2 requests to Infinity Fabric to read
|
||
:ref:`uncached data <memory-type>` from any memory location, per
|
||
:ref:`normalization unit <normalization-units>`. 64B requests for
|
||
uncached data are counted as two 32B uncached data requests. See
|
||
:ref:`l2-request-flow` for more detail.
|
||
|
||
- Requests per :ref:`normalization unit <normalization-units>`.
|
||
|
||
* - 64B Read Requests
|
||
|
||
- The total number of L2 requests to Infinity Fabric to read 64B of data
|
||
from any memory location, per
|
||
:ref:`normalization unit <normalization-units>`. See
|
||
:ref:`l2-request-flow` for more detail.
|
||
|
||
- Requests per :ref:`normalization unit <normalization-units>`.
|
||
|
||
* - HBM Read Requests
|
||
|
||
- The total number of L2 requests to Infinity Fabric to read 32B or 64B of
|
||
data from the accelerator's local HBM, per
|
||
:ref:`normalization unit <normalization-units>`. See
|
||
:ref:`l2-request-flow` for more detail.
|
||
|
||
- Requests per :ref:`normalization unit <normalization-units>`.
|
||
|
||
* - Remote Read Requests
|
||
|
||
- The total number of L2 requests to Infinity Fabric to read 32B or 64B of
|
||
data from any source other than the accelerator's local HBM, per
|
||
:ref:`normalization unit <normalization-units>`. See
|
||
:ref:`l2-request-flow` for more detail.
|
||
|
||
- Requests per :ref:`normalization unit <normalization-units>`.
|
||
|
||
* - 32B Write and Atomic Requests
|
||
|
||
- The total number of L2 requests to Infinity Fabric to write or atomically
|
||
update 32B of data to any memory location, per
|
||
:ref:`normalization unit <normalization-units>`. See
|
||
:ref:`l2-request-flow` for more detail.
|
||
|
||
- Requests per :ref:`normalization unit <normalization-units>`.
|
||
|
||
* - Uncached Write and Atomic Requests
|
||
|
||
- The total number of L2 requests to Infinity Fabric to write or atomically
|
||
update 32B or 64B of :ref:`uncached data <memory-type>`, per
|
||
:ref:`normalization unit <normalization-units>`. See
|
||
:ref:`l2-request-flow` for more detail.
|
||
|
||
- Requests per :ref:`normalization unit <normalization-units>`.
|
||
|
||
* - 64B Write and Atomic Requests
|
||
|
||
- The total number of L2 requests to Infinity Fabric to write or atomically
|
||
update 64B of data in any memory location, per
|
||
:ref:`normalization unit <normalization-units>`. See
|
||
:ref:`l2-request-flow` for more detail.
|
||
|
||
- Requests per :ref:`normalization unit <normalization-units>`.
|
||
|
||
* - HBM Write and Atomic Requests
|
||
|
||
- The total number of L2 requests to Infinity Fabric to write or atomically
|
||
update 32B or 64B of data in the accelerator's local HBM, per
|
||
:ref:`normalization unit <normalization-units>`. See
|
||
:ref:`l2-request-flow` for more detail.
|
||
|
||
- Requests per :ref:`normalization unit <normalization-units>`.
|
||
|
||
* - Remote Write and Atomic Requests
|
||
|
||
- The total number of L2 requests to Infinity Fabric to write or atomically
|
||
update 32B or 64B of data in any memory location other than the
|
||
accelerator's local HBM, per
|
||
:ref:`normalization unit <normalization-units>`. See
|
||
:ref:`l2-request-flow` for more detail.
|
||
|
||
- Requests per :ref:`normalization unit <normalization-units>`.
|
||
|
||
* - Atomic Requests
|
||
|
||
- The total number of L2 requests to Infinity Fabric to atomically update
|
||
32B or 64B of data in any memory location, per
|
||
:ref:`normalization unit <normalization-units>`. See
|
||
:ref:`l2-request-flow` for more detail. Note that on current CDNA
|
||
accelerators, such as the :ref:`MI2XX <mixxx-note>`, requests are only
|
||
considered *atomic* by Infinity Fabric if they are targeted at
|
||
non-write-cacheable memory, such as
|
||
:ref:`fine-grained memory <memory-type>` allocations or
|
||
:ref:`uncached memory <memory-type>` allocations on the MI2XX.
|
||
|
||
- Requests per :ref:`normalization unit <normalization-units>`.
|
||
|
||
.. _l2-fabric-stalls:
|
||
|
||
L2-Fabric interface stalls
|
||
==========================
|
||
|
||
When the interface between the L2 cache and Infinity Fabric becomes backed up by
|
||
requests, it may stall, preventing the L2 from issuing additional requests to
|
||
Infinity Fabric until prior requests complete. This section gives a breakdown of
|
||
what types of requests in a kernel caused a stall (like read versus write), and
|
||
to which locations -- for instance, to the accelerator’s local memory, or to
|
||
remote accelerators or CPUs.
|
||
|
||
.. list-table::
|
||
:header-rows: 1
|
||
|
||
* - Metric
|
||
|
||
- Description
|
||
|
||
- Unit
|
||
|
||
* - Read - PCIe Stall
|
||
|
||
- The number of cycles the L2-Fabric interface was stalled on read requests
|
||
to remote PCIe connected accelerators [#inf]_ or CPUs as a percent of the
|
||
:ref:`total active L2 cycles <total-active-l2-cycles>`.
|
||
|
||
- Percent
|
||
|
||
* - Read - Infinity Fabric Stall
|
||
|
||
- The number of cycles the L2-Fabric interface was stalled on read requests
|
||
to remote Infinity Fabric connected accelerators [#inf]_ or CPUs as a
|
||
percent of the :ref:`total active L2 cycles <total-active-l2-cycles>`.
|
||
|
||
- Percent
|
||
|
||
* - Read - HBM Stall
|
||
|
||
- The number of cycles the L2-Fabric interface was stalled on read requests
|
||
to the accelerator's local HBM as a percent of the
|
||
:ref:`total active L2 cycles <total-active-l2-cycles>`.
|
||
|
||
- Percent
|
||
|
||
* - Write - PCIe Stall
|
||
|
||
- The number of cycles the L2-Fabric interface was stalled on write or
|
||
atomic requests to remote PCIe connected accelerators [#inf]_ or CPUs as
|
||
a percent of the :ref:`total active L2 cycles <total-active-l2-cycles>`.
|
||
|
||
- Percent
|
||
|
||
* - Write - Infinity Fabric Stall
|
||
|
||
- The number of cycles the L2-Fabric interface was stalled on write or
|
||
atomic requests to remote Infinity Fabric connected accelerators [#inf]_
|
||
or CPUs as a percent of the
|
||
:ref:`total active L2 cycles <total-active-l2-cycles>`.
|
||
|
||
- Percent
|
||
|
||
* - Write - HBM Stall
|
||
|
||
- The number of cycles the L2-Fabric interface was stalled on write or
|
||
atomic requests to accelerator's local HBM as a percent of the
|
||
:ref:`total active L2 cycles <total-active-l2-cycles>`.
|
||
|
||
- Percent
|
||
|
||
* - Write - Credit Starvation
|
||
|
||
- The number of cycles the L2-Fabric interface was stalled on write or
|
||
atomic requests to any memory location because too many write/atomic
|
||
requests were currently in flight, as a percent of the
|
||
:ref:`total active L2 cycles <total-active-l2-cycles>`.
|
||
|
||
- Percent
|
||
|
||
.. warning::
|
||
|
||
On current CDNA accelerators and GCN GPUs, these L2↔Fabric stalls can be undercounted in some circumstances.
|
||
|
||
.. rubric:: Footnotes
|
||
|
||
.. [#inf] In addition to being used for on-accelerator data-traffic, AMD
|
||
`Infinity Fabric <https://www.amd.com/en/technologies/infinity-architecture>`_
|
||
technology can be used to connect multiple accelerators to achieve advanced
|
||
peer-to-peer connectivity and enhanced bandwidths over traditional PCIe
|
||
connections. Some AMD Instinct MI-series accelerators like the MI250X
|
||
`feature coherent CPU↔accelerator connections built using AMD Infinity Fabric <https://www.amd.com/system/files/documents/amd-cdna2-white-paper.pdf>`_.
|
||
|
||
.. rubric:: Disclaimer
|
||
|
||
PCIe® is a registered trademark of PCI-SIG Corporation.
|