# Profiler: čí to byl kód

> /keystone profile vzorkuje vlákno serveru přes Flight Recorder a řekne po modech, kolik stál každý tick – s flame graphem, nejdražšími entitami a nejžhavějšími chunky i s tím, čí claim to je. Novinka v 0.3.

Source: https://stygion.eu/cs/docs/keystone/profiler
Updated: 2026-10-25

Novinka v 0.3, modul `profiler`. Vzorkuje vlákno serveru přes Flight Recorder v Javě – nic se nezpomalí – a výsledek uloží jako stránku.

## Spuštění

- `/keystone profile [vteřiny]` (nejvýš `max-seconds`, 300) spustí měření; `/keystone profile last` řekne, co našlo poslední (`keystone.profile`).
- Obrazovka **Profiler** v editoru spouští měření, ukazuje všechny reporty a má živý režim, který opakuje desetivteřinová měření, dokud je obrazovka otevřená.
- `POST /v1/profiler/start` (`operations.run`), `GET /v1/profiler`, `GET /v1/profiler/report`, `POST /v1/profiler/live` (`status.read`).

## Co report řekne

- Každý mod v milisekundách každého ticku, sám i s tím, co volal.
- Flame graph vlákna serveru.
- Nejdražší druhy entit a blokových entit (proudový motor, vrták).
- Nejžhavější chunky, čí claim to je, a teleport, ať se můžeš jít podívat.

V `keystone/profiler` se drží `keep` (20) reportů; nejstarší mizí.

## Sdílení

Report nikdy neopustí server, dokud nezapneš `share.enabled` a nenastavíš `share.url`: https adresu, která přijme report jako JSON (POST) a odpoví odkazem v `{"url": …}` – tvoje vlastní stránka nebo služba, které věříš, se `share.key` jako Bearer tokenem. Pak ho pošle `/keystone profile share <id>` nebo tlačítko v editoru.