spall web

estilhaçar

spall é uma biblioteca de criação de perfil e um frontend da web para explorar seu código e investigar possíveis problemas de desempenho.

^ este é um rastreamento de 180 MB (equivalente a 526 MB JSON), de 5 minutos do Happenlance, cortesia de @pmttavara!

Características

• Zíper! spall pode carregar 500 MB de dados .spall em seu navegador em um ou dois segundos, e você pode rolar e deslocar a gloriosos 165+ FPS
• Fácil de usar! Biblioteca C de cabeçalho único para instrumentar seu código
• Números em abundância! spall pode coletar um punhado de estatísticas muito úteis sobre o seu programa sem nem suar a camisa
• Modos claro/escuro! Você pode arregalar os olhos no modo claro, saborear as doces cores neon no modo escuro ou alternar automaticamente com seu sistema
• Velociraptores incluídos! Uhh, espere, desculpe, estamos todos fora. Não há velociraptores aqui. Você pode fingir.

Experimente no Gravity Moth

Uso

spall inclui uma pequena biblioteca C de cabeçalho único, spall.h .

spall atualmente suporta 2 formatos de arquivo diferentes:

• .json, no formato de rastreamento do Google usado por perfetto , chrome://tracing e speedscope , descrito abaixo
• .spall, nosso formato binário personalizado

Você pode instrumentar seu código com nosso cabeçalho ou usar seu código de despejo JSON compatível com chrome://tracing existente.

Atenção!

Se você está começando do zero, provavelmente desejará usar o cabeçalho spall para gerar eventos. O formato binário tem uma sobrecarga de criação de perfil muito menor (portanto, seus rastreamentos devem ser mais precisos) e ingere cerca de 10 vezes mais rápido que o formato JSON.

Visão geral do formato de rastreamento JSON

Se você quiser usar JSON, o spall espera eventos seguindo o formato de rastreamento JSON do 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 não se importa com vírgulas finais e colchetes não são necessários, para facilitar a criação de arquivos/streaming de eventos)

Tipos de campo

cat - Categoria do evento. Atualmente não utilizado

name - o nome do evento, uma string

ph - O tipo de evento

Tipo	Símbolo
Começar	"B"
Fim	"E"
Completo	"X"

tid - id do thread, u32 pid - id do processo, u32

Todos os tids e pids devem estar entre 0 e u32_MAX, como valores inteiros

ts - timestamp, um duplo, em microssegundos dur - timestamp, um duplo, em microssegundos

(Um carimbo de data/hora de 1 começa em 1 μs)

Tipos de eventos

Spall atualmente suporta apenas eventos Begin, End e Complete

Completo

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

Eventos completos requerem um campo de duração, porque eles rastreiam o início/fim de uma função em um só lugar

Começar

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

Fim

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

Os eventos finais fecham automaticamente o evento inicial mais recente com o mesmo pid e tid, portanto, não precisam de nomes

Notas importantes

Independentemente do formato de ingestão, espera-se que todos os eventos de início e fim dentro de um processo/thread (pid/tid) estejam primeiro no carimbo de data/hora mais antigo, na ordem de classificação, por exemplo:

 [
	{"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}
]