spall web

раскол

Spall — это библиотека профилировщика и веб-интерфейс для изучения вашего кода и выявления потенциальных проблем с производительностью.

^ это 180 МБ (эквивалент JSON 526 МБ), 5-минутная трассировка от Happenlance, любезно предоставлено @pmttavara!

Функции

• Живой! Spall может загрузить 500 МБ данных .spall в ваш браузер за секунду или две, и вы можете прокручивать и панорамировать их со скоростью 165+ кадров в секунду.
• Легко использовать! Библиотека C с одним заголовком для инструментирования вашего кода.
• Числа в изобилии! Spall может собрать несколько очень полезных статистических данных о вашей программе, даже не вспотев.
• Светлый/Темный режимы! Вы можете вышибить глаза в светлом режиме, насладиться сладкими неоновыми цветами в темном режиме или автоматически переключиться с помощью вашей системы.
• Велоцирапторы включены! Ох, подожди, извини, мы все закончили. Здесь нет велоцирапторов. Хотя ты можешь притвориться.

Попробуйте это в Gravity Moth.

Использование

В состав spall входит небольшая библиотека C с одним заголовком, spall.h .

Spall в настоящее время поддерживает 2 различных формата файлов:

• .json, в формате трассировки Google, используемом perfetto , chrome://tracing и speedscope , описанном ниже.
• .spall, наш собственный двоичный формат

Вы можете либо оснастить свой код нашим заголовком, либо использовать существующий код дампа JSON, совместимый с chrome://tracing .

Берегись!

Если вы начинаете с нуля, вы, вероятно, захотите использовать заголовок расщепления для генерации событий. Двоичный формат требует гораздо меньших затрат на профилирование (поэтому ваши трассировки должны быть более точными) и обрабатываются примерно в 10 раз быстрее, чем формат JSON.

Обзор формата трассировки JSON

Если вы хотите использовать JSON, Spall ожидает событий в формате трассировки JSON Google. Они выглядят следующим образом:

 [
	{"cat":"function", "name":"main", "ph": "X", "pid": 0, "tid": 0, "ts": 0, "dur": 1},
	{"cat":"function", "name":"myfunction", "ph": "B", "pid": 0, "tid": 0, "ts": 0},
	{"cat":"function", "ph": "E", "pid": 0, "tid": 0, "ts": 0}
]

(spall не заботится о конечных запятых, и закрывающие скобки не требуются, чтобы упростить создание файлов/потоковую передачу событий)

Типы полей

cat - Категория события. В настоящее время не используется

name - название события, строка

ph - Тип события

Тип	Символ
Начинать	"Б"
Конец	"Э"
Полный	"Х"

tid — идентификатор потока, u32 pid — идентификатор процесса, u32

Все tids и pids должны находиться в диапазоне от 0 до u32_MAX, как целые значения.

ts — метка времени, двойная, в микросекундах dur — метка времени, двойная, в микросекундах

(Временная метка 1 начинается с 1 мкс)

Типы событий

В настоящее время Spall поддерживает только события начала, окончания и завершения.

Полный

 {"cat":"function", "name":"foo", "ph": "X", "pid": 0, "tid": 0, "ts": 0, "dur": 1},

Для полных событий требуется поле длительности, поскольку они отслеживают начало/окончание функции одновременно.

Начинать

 {"cat":"function", "name":"myfunction", "ph": "B", "pid": 0, "tid": 0, "ts": 0},

Конец

 {"cat":"function", "ph": "E", "pid": 0, "tid": 0, "ts": 0},

Конечные события автоматически закрывают самое последнее начальное событие с тем же pid и tid, поэтому им не нужны имена.

Важные примечания

Независимо от формата приема ожидается, что все начальные и конечные события в процессе/потоке (pid/tid) будут сначала иметь самую раннюю временную метку, отсортированный порядок, например:

 [
	{"cat":"function", "name":"main", "ph": "B", "pid": 0, "tid": 0, "ts": 0},
	{"cat":"function", "name":"foo", "ph": "B", "pid": 0, "tid": 0, "ts": 1},
	{"cat":"function", "ph": "E", "pid": 0, "tid": 0, "ts": 2},
	{"cat":"function", "ph": "E", "pid": 0, "tid": 0, "ts": 3}
]