Add Stats Level config value for use with stats counter collection.

[zbyrne]

Motivation

AIHIPFILE-53 It's possible as we add more counters to ais-stats that we may start to see a performance overhead to the data collection. This setting will be used to let us control exactly how much data we collect from a given process in the event very detailed stats gathering has a large performance impact.

Technical Details

Adds an environment variable(HIPFILE_STATS_LEVEL) and Configuration method(::statsLevel()) in the same vein as HIPFILE_FORCE_COMPAT_MODE.

Test Plan

Added Environment and Configuration unit tests for the new functions.

Test Result

All unit tests pass.

Submission Checklist

• Look over the contributing guidelines at https://github.com/ROCm/ROCm/blob/develop/CONTRIBUTING.md#pull-requests.

[gaoikawa]

It's early I realize and @derobins is re-working our docs, but we probably should add something to our public facing docs on stats collection 'soon'.

hipFile -> docs -> (something related to stats, perhaps)

Also, other libraries have a standalone environment variables explainer page, we should add something too.

Okay to capture that in another follow-on story/PR.

Thanks.

[Copilot]

Pull request overview

This PR adds a HIPFILE_STATS_LEVEL environment variable and a corresponding statsLevel() configuration method to allow controlling the granularity of stats collection (for ais-stats). The feature mirrors the existing HIPFILE_FORCE_COMPAT_MODE pattern.

Changes:

• Adds Environment::get<int> specialization and stats_level() convenience function in the environment layer.
• Adds statsLevel() to the IConfiguration interface and the concrete Configuration class.
• Adds unit tests for the new get<int> environment parsing and the statsLevel() configuration getter.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
src/amd_detail/environment.h	Declares STATS_LEVEL constant and stats_level() method
src/amd_detail/environment.cpp	Implements get<int> template specialization and stats_level()
src/amd_detail/configuration.h	Adds statsLevel() pure virtual to IConfiguration and declaration to Configuration
src/amd_detail/configuration.cpp	Initializes m_statsLevel from environment and implements statsLevel()
test/amd_detail/environment.cpp	Unit tests for the new get<int> specialization
test/amd_detail/configuration.cpp	Unit tests for statsLevel() via ConfigurationExpectationBuilder

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.