A C++ library for storing and retrieving ROCm profiling data using SQLite (rocpd database format).

profiler-hub provides a high-performance storage layer for ROCm profiling tools. It offers a structured way to persist profiling data in the rocpd (SQLite) database format, enabling interoperability with ROCm profiling tools and analysis workflows.

This library is part of the rocm-systems monorepo and is used by rocprofiler-systems for trace data output.

At configure time, profiler-hub clones RocPD schema SQL from rocm-systems and embeds it as generated C++ headers. No installed rocprofiler-sdk-rocpd package is required.

These options apply on Linux and Windows.

• CMake 3.25+
• C++20 compatible compiler
• SQLite3 (bundled via CMake module)
• spdlog and fmt (system packages or FetchContent fallback)

Ubuntu/Debian:

sudo apt install libsqlite3-dev libspdlog-dev libfmt-dev

RHEL/Rocky Linux:

sudo dnf install sqlite-devel spdlog-devel fmt-devel

openSUSE:

sudo zypper install sqlite3-devel spdlog-devel fmt-devel

From the profilers/profiler-hub directory:

cmake -S . -B build
cmake --build build -j$(nproc)

cmake --install build --prefix /opt/rocm

For projects using an installed profiler-hub:

find_package(profiler-hub REQUIRED)
target_link_libraries(your_target PRIVATE profiler-hub::profiler-hub)

A native MSVC build is supported (CI runs on Linux and Windows). fmt, spdlog, nlohmann_json, GoogleTest, and Google Benchmark are fetched when they are not already installed. SQLite3 is fetched only when -DPROFILER_HUB_FETCH_DEPENDENCIES=ON is set.

1. Install the Visual Studio C++ toolchain (skip if already installed). You only need the Build Tools — the full Visual Studio IDE is not required.

   • Download from https://visualstudio.microsoft.com/downloads/ : scroll to Tools for Visual Studio Build Tools for Visual Studio 2022 (or 2026), or the full Community edition.
   • Or install from the command line with winget:

   winget install -e --id Microsoft.VisualStudio.2022.BuildTools

   • In the installer, select the Desktop development with C++ workload (this pulls in the MSVC compiler, CMake, and the Windows SDK), then click Install.

2. Open a Visual Studio developer shell so cmake and cl.exe are on PATH.

   The simplest way is to open the Start menu and launch x64 Native Tools Command Prompt for VS. This sets up the environment for you.

   Alternatively, from any cmd window, run the VsDevCmd.bat that ships with your install. Its path depends on the Visual Studio version number (2022 = 2022, 2026 = 2026) and the edition (BuildTools, Community, Professional, or Enterprise):

   "C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\Common7\Tools\VsDevCmd.bat" -arch=amd64

3. Configure and build from the profilers/profiler-hub directory:

   cd C:\path\to\rocm-systems\profilers\profiler-hub
   cmake -S . -B build -DPROFILER_HUB_FETCH_DEPENDENCIES=ON
   cmake --build build --config Release --parallel

4. Run the tests (optional):

   ctest --test-dir build -C Release --output-on-failure

With the Visual Studio generator, artifacts live under a configuration subfolder (Release/Debug), not directly under build\lib\:

On Windows a .lib can be either an import library or a static archive, so the two profiler-hub targets use distinct base names: profiler-hub.lib (import lib, pairs with the DLL) vs profiler-hub-static.lib (static archive).

• SQLite3: with PROFILER_HUB_FETCH_DEPENDENCIES=ON, Windows downloads the official amalgamation zip from SQLITE3_AMALGAMATION_URL (default matches SQLITE3_GIT_TAG version-3.45.3), verifies SQLITE3_AMALGAMATION_SHA256 over TLS, and builds profiler-hub-sqlite3.dll, which exports the SQLite C API. Keep that DLL next to profiler-hub.dll (or on PATH) at run time.
• Dependencies: fmt, spdlog, nlohmann_json, GoogleTest, and Google Benchmark are fetched via CMake FetchContent when not found on the system.
• Language standard: library, tests, and benchmarks are built as C++20.

cmake --install build --config Release --prefix C:\opt\profiler-hub

Installed layout: bin\profiler-hub.dll, lib\profiler-hub.lib (import lib), lib\profiler-hub-static.lib (static archive), include\profiler-hub\*.hpp, and the find_package config under lib\cmake\profiler-hub\. When SQLite was fetched, also ship profiler-hub-sqlite3.dll beside profiler-hub.dll.

For projects using an installed profiler-hub:

find_package(profiler-hub REQUIRED)
target_link_libraries(your_target PRIVATE profiler-hub::profiler-hub)

Point the consumer at the package with -DCMAKE_PREFIX_PATH=C:\opt\profiler-hub or -Dprofiler-hub_DIR=<build-tree> to use the build tree directly. Ensure profiler-hub.dll and, when SQLite was fetched, profiler-hub-sqlite3.dll are next to the consumer executable or on PATH at run time.

MIT License — Copyright (c) 2025 Advanced Micro Devices, Inc.

See LICENSE for details.