Add microprofile integration for performance profiling

Introduce microprofile for detailed performance profiling and reporting. Replace CSV-based performance tables with HTML reports, generated and published under `docs/scoreboard/profiles`. Update build system, scripts, and CI workflows to support profiling and automate report publishing.

Author: allnes

.github/workflows/perf.yml

@@ -30,14 +30,15 @@ jobs:
           PPC_NUM_THREADS: 2
           OMPI_ALLOW_RUN_AS_ROOT: 1
           OMPI_ALLOW_RUN_AS_ROOT_CONFIRM: 1
-      - name: Archive results
-        working-directory: build
-        run: zip -r ../perf-stat.zip perf_stat_dir
-      - name: Upload results
-        uses: actions/upload-artifact@v4
-        with:
-          name: perf-stat
-          path: perf-stat.zip
+      - name: Build scoreboard index
+        run: python3 scripts/scoreboard_index.py
+      - name: Publish profiles
+        run: |
+          git config user.email "ci@users.noreply.github.com"
+          git config user.name  "CI"
+          git add docs/scoreboard
+          git commit -m "Update microprofile reports [ci]" || echo "No changes"
+          git push
   macos-clang-build-perf-stats:
     runs-on: macOS-latest
     steps:
@@ -66,11 +67,12 @@ jobs:
         env:
           PPC_NUM_PROC: 1
           PPC_NUM_THREADS: 2
-      - name: Archive results
-        working-directory: build
-        run: zip -r perf-stat-macos.zip perf_stat_dir
-      - name: Upload results
-        uses: actions/upload-artifact@v4
-        with:
-          name: perf-stat-macos
-          path: perf-stat-macos.zip
+      - name: Build scoreboard index
+        run: python3 scripts/scoreboard_index.py
+      - name: Publish profiles
+        run: |
+          git config user.email "ci@users.noreply.github.com"
+          git config user.name  "CI"
+          git add docs/scoreboard
+          git commit -m "Update microprofile reports [ci]" || echo "No changes"
+          git push

.gitmodules

@@ -13,3 +13,6 @@
 [submodule "3rdparty/libenvpp"]
 	path = 3rdparty/libenvpp
 	url = https://github.com/ph3at/libenvpp
+[submodule "3rdparty/microprofile"]
+	path = 3rdparty/microprofile
+	url = https://github.com/jonasmr/microprofile

3rdparty/microprofile

@@ -6,6 +6,7 @@ endif()
 
 message( STATUS "Parallel Programming Course (PPC)" )
 project(parallel_programming_course)
+option(PPC_ENABLE_PROFILING "Enable microprofile instrumentation (perf tests only)" ON)
 
 ############################ Scoreboard #############################
 
@@ -29,6 +30,7 @@ message( STATUS "PPC step: First configures" )
 include(cmake/configure.cmake)
 include(cmake/modes.cmake)
 include(cmake/sanitizers.cmake)
+include(cmake/ppc_profiler.cmake)
 foreach(dep json libenvpp stb)
     include(cmake/${dep}.cmake)
 endforeach()

CMakeLists.txt

@@ -12,6 +12,8 @@ For more detailed documentation and resources, please visit documentation pages:
 
 Course scoreboard is available [here](https://learning-process.github.io/parallel_programming_course/scoreboard/).
 
+Note: performance CSV tables are deprecated. Microprofile HTML reports are published under `docs/scoreboard/profiles/*.html` with an index at `docs/scoreboard/README.md`.
+
 Coverage report is available [here](https://learning-process.github.io/parallel_programming_course/coverage/).
 
 ### Parallel programming technologies:

README.md

@@ -0,0 +1,17 @@
+if(PPC_ENABLE_PROFILING)
+  add_library(ppc_microprofile STATIC
+    3rdparty/microprofile/microprofile.cpp
+  )
+  target_include_directories(ppc_microprofile PUBLIC
+    ${CMAKE_SOURCE_DIR}/3rdparty/microprofile
+    ${CMAKE_SOURCE_DIR}/modules/common/include
+  )
+  target_compile_definitions(ppc_microprofile PUBLIC
+    MICROPROFILE_ENABLED=1
+    MICROPROFILE_USE_CONFIG=1
+  )
+else()
+  add_library(ppc_microprofile INTERFACE)
+  target_compile_definitions(ppc_microprofile INTERFACE MICROPROFILE_ENABLED=0)
+endif()
+

cmake/ppc_profiler.cmake

@@ -0,0 +1,5 @@
+#pragma once
+#define MICROPROFILE_WEBSERVER 0
+#define MICROPROFILE_MINIZ 0
+#define MICROPROFILE_PER_THREAD_BUFFER_SIZE (1024*1024)
+

modules/common/include/microprofile.config.h

@@ -18,6 +18,10 @@
 #include "task/include/task.hpp"
 #include "util/include/util.hpp"
 
+#if MICROPROFILE_ENABLED
+#include "microprofile.h"
+#endif
+
 namespace ppc::util {
 
 double GetTimeMPI();
@@ -46,6 +50,11 @@ class BaseRunPerfTests : public ::testing::TestWithParam<PerfTestParam<InType, O
   virtual InType GetTestInputData() = 0;
 
   virtual void SetPerfAttributes(ppc::performance::PerfAttr& perf_attrs) {
+#if MICROPROFILE_ENABLED
+    (void)perf_attrs;
+    // Timing is handled by microprofile in perf tests.
+    return;
+#else
     if (task_->GetDynamicTypeOfTask() == ppc::task::TypeOfTask::kMPI ||
         task_->GetDynamicTypeOfTask() == ppc::task::TypeOfTask::kALL) {
       const double t0 = GetTimeMPI();
@@ -65,6 +74,7 @@ class BaseRunPerfTests : public ::testing::TestWithParam<PerfTestParam<InType, O
     } else {
       throw std::runtime_error("The task type is not supported for performance testing.");
     }
+#endif
   }
 
   void ExecuteTest(const PerfTestParam<InType, OutType>& perf_test_param) {
@@ -83,18 +93,42 @@ class BaseRunPerfTests : public ::testing::TestWithParam<PerfTestParam<InType, O
     SetPerfAttributes(perf_attr);
 
     if (mode == ppc::performance::PerfResults::TypeOfRunning::kPipeline) {
+#if MICROPROFILE_ENABLED
+      {
+        MICROPROFILE_SCOPEI("perf", test_name.c_str(), MP_GREEN);
+        perf.PipelineRun(perf_attr);
+      }
+#else
       perf.PipelineRun(perf_attr);
+#endif
     } else if (mode == ppc::performance::PerfResults::TypeOfRunning::kTaskRun) {
+#if MICROPROFILE_ENABLED
+      {
+        MICROPROFILE_SCOPEI("perf", test_name.c_str(), MP_GREEN);
+        perf.TaskRun(perf_attr);
+      }
+#else
       perf.TaskRun(perf_attr);
+#endif
     } else {
       std::stringstream err_msg;
       err_msg << '\n' << "The type of performance check for the task was not selected.\n";
       throw std::runtime_error(err_msg.str().c_str());
     }
 
+#if MICROPROFILE_ENABLED
+    if (GetMPIRank() == 0) {
+      const char* out_dir = std::getenv("PPC_PROFILE_OUT");
+      if (!out_dir) out_dir = "docs/scoreboard/profiles";
+      const std::string capture = test_name + ".html";
+      const std::string out = std::string(out_dir) + "/" + capture;
+      MicroProfileDumpFileImmediately(out.c_str(), capture.c_str(), -1);
+    }
+#else
     if (GetMPIRank() == 0) {
       perf.PrintPerfStatistic(test_name);
     }
+#endif
 
     OutType output_data = task_->GetOutput();
     ASSERT_TRUE(CheckTestOutputData(output_data));

modules/util/include/perf_test_util.hpp

@@ -1,6 +1,12 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-mkdir -p build/perf_stat_dir
-scripts/run_tests.py --running-type="performance" | tee build/perf_stat_dir/perf_log.txt
-python3 scripts/create_perf_table.py --input build/perf_stat_dir/perf_log.txt --output build/perf_stat_dir
+OUT_DIR="docs/scoreboard/profiles"
+mkdir -p "${OUT_DIR}"
+
+export PPC_PROFILE_OUT="${OUT_DIR}"
+
+# Preserve the same perf binary runs as before
+scripts/run_tests.py --running-type="performance"
+
+echo "Perf runs completed. HTML profiles are in ${OUT_DIR}"

scripts/generate_perf_results.sh

@@ -0,0 +1,26 @@
+#!/usr/bin/env python3
+import pathlib, datetime
+
+PROFILES = pathlib.Path("docs/scoreboard/profiles")
+OUT_MD   = pathlib.Path("docs/scoreboard/README.md")
+
+def main():
+    PROFILES.mkdir(parents=True, exist_ok=True)
+    OUT_MD.parent.mkdir(parents=True, exist_ok=True)
+    items = sorted(p for p in PROFILES.glob("*.html"))
+    lines = [
+      "# Scoreboard\n",
+      "_Профили выполнений (microprofile). Таблица производительности отключена._\n\n",
+      f"Generated: {datetime.datetime.utcnow().isoformat()}Z\n\n",
+    ]
+    if not items:
+        lines.append("> Profiles not found.\n")
+    else:
+        lines.append("## Profiles\n\n")
+        for p in items:
+            lines.append(f"- [{p.name}]({p.name})\n")
+    OUT_MD.write_text("".join(lines), encoding="utf-8")
+
+if __name__ == "__main__":
+    main()
+