Przejdź do treści
Biblioteka skilli
Programowanie · Analiza

docker-jfr-benchmark-loop

/docker-jfr-benchmark-loop

Prowadzi powtarzalną pętlę wydajnościową RDF4J dla jednego benchmarku JMH w Dockerze z Linux Java 26 i profilowaniem CPU w JFR: baseline, poprawka i ponowny pomiar.

Repozytorium
rdf4j ↗
Licencja
BSD-3-Clause
Ostatnia zmiana repozytorium
27.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
5
Skrypty
1
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 27.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

BSD-3-Clause, otwarta.

Co sprawdzić przed instalacją
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/run-docker-jfr-loop.sh

Co robi i kiedy

Prowadzi powtarzalną pętlę wydajnościową RDF4J dla jednego benchmarku JMH w Dockerze z Linux Java 26 i profilowaniem CPU w JFR: baseline, poprawka i ponowny pomiar.

Oryginalny opis (EN)

Run a repeatable RDF4J performance loop against one JMH benchmark in Docker with Linux Java 26 and JFR CPU-time profiling. Use when working in this repo on benchmark-guided performance changes, hotspot triage, JFR reading, CPU bottleneck analysis, or repeated baseline, fix, and rerun loops. Trigger on requests mentioning benchmark, profiling, JFR, hotspot, perf loop, CPU bottleneck, or Docker benchmark runs in RDF4J.

Jak działa

  1. Quick start
  2. Repo-grounded defaults
  3. Core loop
  4. Operating rules
  5. Output contract
  6. Escalate cleanly
  7. Reference map
Sekcje z nagłówków SKILL.md, w oryginale · 87 linii, 406 słów
Podgląd SKILL.md
---
name: docker-jfr-benchmark-loop
description: Run a repeatable RDF4J performance loop against one JMH benchmark in Docker with Linux Java 26 and JFR CPU-time profiling. Use when working in this repo on benchmark-guided performance changes, hotspot triage, JFR reading, CPU bottleneck analysis, or repeated baseline, fix, and rerun loops. Trigger on requests mentioning benchmark, profiling, JFR, hotspot, perf loop, CPU bottleneck, or Docker benchmark runs in RDF4J.
---

# Docker JFR Benchmark Loop

Use this skill for one-benchmark perf work in this repo. Default runner: `scripts/run-docker-jfr-loop.sh`, not ad hoc Maven or raw JMH commands.

## Quick start

Dry-run a known selector:

```bash
.codex/skills/docker-jfr-benchmark-loop/scripts/run-docker-jfr-loop.sh \
  org.eclipse.rdf4j.model.benchmark.ValueCreationBenchmark.createBNode \
  --dry-run
```

Explicit selector plus params:

```bash
.codex/skills/docker-jfr-benchmark-loop/scripts/run-docker-jfr-loop.sh \
  --module core/model \
  --class org.eclipse.rdf4j.model.benchmark.ValueCreationBenchmark \
  --method createBNode \
  --param samples=1000
```

## Repo-grounded defaults

- The wrapper calls repo helper `scripts/run-single-benchmark-docker.sh`.
- The Docker helper already forces Linux Java 26 plus `--enable-jfr --enable-jfr-cpu-times`.
- The inner helper already enforces:
  - `settings=profile`
  - `dumponexit=true`
  - `duration=120s`
  - `warmup=0`
  - `measurement=10` iterations of `10s`
  - `forks=1`
  - `jdk.CPUTimeSample#enabled=true`
  - `report-on-exit=cpu-time-hot-methods`
- This skill wrapper adds the missing fidelity flags:
  - `-XX:FlightRecorderOptions=stackdepth=1024,samplethreads=true`
  - `-XX:+UnlockDiagnosticVMOptions`
  - `-XX:+DebugNonSafepoints`

## Core loop

1. Pick one benchmark selector. Keep selector, params, Docker image, and profiling flags constant for the whole comparison.
2. Capture a baseline run with `scripts/run-docker-jfr-loop.sh`.
3. Read the `.jfr` using [references/jfr-reading.md](references/jfr-reading.md).
4. Choose one candidate fix with material CPU share. Prefer the fix most likely to move total runtime, not just local self time.
5. Re-run the exact same selector and params.
6. Compare benchmark delta plus hotspot shift.
7. Repeat until:
   - the hotspot shifts,
   - CPU share falls below a meaningful threshold,
   - or GC / locks / memory / I/O / JIT behavior dominates instead.

## Operating rules

- Route benchmark variation through `--param`.
- Route JVM tuning through `--jvm-arg`.
- Do not use raw `--jmh-arg` during JFR runs; the helper rejects extra JMH args when JFR is enabled.
- Do not switch to a second `StartFlightRecording`; stay aligned with repo helper behavior.
- Do not treat a small benchmark gain as proof the hotspot fix failed. First check whether another bottleneck surfaced and now caps the total speedup.
- If the run is not CPU-bound, say so and pivot to lock, GC, memory, I/O, or JIT evidence instead of forcing a CPU-only story.

## Output contract

Answers using this skill should usually include:

- exact run command
- `.jfr` path
- top CPU hotspots
- confidence notes
- next-fix hypothesis
- whether a second bottleneck likely masks part of the gain

## Escalate cleanly

- Use [high-performance-java](../high-performance-java/SKILL.md) for algorithm, data-structure, and code-shape changes.
- Use [hotspot-jit-forensics](../hotspot-jit-forensics/SKILL.md) when inlining, tiering, C2, or codegen behavior is in question.
- Use [jmh-benchmark-compare](../jmh-benchmark-compare/SKILL.md) for multi-run diffs, history, and exported reports.

## Reference map

- Loop workflow: [references/perf-loop.md](references/perf-loop.md)
- JFR reading guide: [references/jfr-reading.md](references/jfr-reading.md)
Pliki w paczce (5)
  • SKILL.md 4 KB
  • agents/openai.yaml 1 KB
  • references/jfr-reading.md 2 KB
  • references/perf-loop.md 2 KB
  • scripts/run-docker-jfr-loop.sh 4 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · eclipse-rdf4j/rdf4j100BSD-3-Clause
eclipse-rdf4j/rdf4j100BSD-3-Clause
eclipse-rdf4j/rdf4j100BSD-3-Clause

Migawka bazy z 13.11.2026 · wersja paczki 057a422e6e8d (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100161-java-profiling-detect
    Konfiguruje profilowanie aplikacji Java przez async-profiler i JFR, zbiera dane o CPU, pamięci, wątkach i GC oraz flamegrafy.
  • 100profile-run
    Uruchamia projekt pod profilerem JFR lub async-profiler, np. benchmark, test lub aplikację, i analizuje wynik, żeby znaleźć gorące miejsca.
  • 95jmh-benchmarks
    Pomaga pisać mikrobenchmarki Java w JMH: pomiar czasu wykonania metod, porównanie algorytmów, profilowanie wydajności i debugowanie benchmarków (@Benchmark, warmup, Blackhole).
  • 100profile-run
    Uruchamia projekt pod profilerem i analizuje wynik: test, benchmark lub skrypt obciążeniowy, nagrany JFR albo async-profiler i przekazany do analizy.
  • 90jvm-profiling
    Profiluje usługi JVM przez async-profiler i JFR, rozdzielając dowody dotyczące CPU, alokacji i blokad, bezpiecznie na produkcji.
  • 100162-java-profiling-analyze
    Analizuje dane z profilowania Java: flamegrafy, alokacje pamięci i hotspoty CPU, a poprawki ocenia według wpływu i wysiłku.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.