spall web

Abplatzer

spall ist eine Profiler-Bibliothek und ein Web-Frontend zur Erkundung Ihres Codes und zur Untersuchung potenzieller Leistungsprobleme.

^ Dies ist ein 180 MB (526 MB JSON-Äquivalent), 5-Minuten-Trace von Happenlance, mit freundlicher Genehmigung von @pmttavara!

Merkmale

• Flink! spall kann in ein oder zwei Sekunden 500 MB .spall-Daten in Ihren Browser laden, und Sie können mit einer Geschwindigkeit von über 165 FPS scrollen und schwenken
• Einfach zu bedienen! Single-Header-C-Bibliothek zur Instrumentierung Ihres Codes
• Zahlen in Hülle und Fülle! Spall kann eine Handvoll sehr nützlicher Statistiken über Ihr Programm sammeln, ohne auch nur ins Schwitzen zu geraten
• Hell/Dunkel-Modi! Sie können sich im hellen Modus die Augen ausblasen, im dunklen Modus die süßen Neonfarben genießen oder mit Ihrem System automatisch umschalten
• Velociraptoren inklusive! Ähh, warte, tut mir leid, wir sind alle raus. Keine Velociraptoren hier. Sie können jedoch so tun, als ob.

Probieren Sie es bei Gravity Moth aus

Verwendung

spall enthält eine kleine Single-Header-C-Bibliothek, spall.h .

spall unterstützt derzeit zwei verschiedene Dateiformate:

• .json im Trace-Format von Google, das von perfetto , chrome://tracing und speedscope verwendet wird (siehe unten).
• .spall, unser benutzerdefiniertes Binärformat

Sie können Ihren Code entweder mit unserem Header instrumentieren oder Ihren vorhandenen chrome://tracing kompatiblen JSON-Dumping-Code verwenden.

Kopf hoch!

Wenn Sie bei Null anfangen, möchten Sie wahrscheinlich den Spall-Header zum Generieren von Ereignissen verwenden. Das Binärformat hat einen viel geringeren Profilierungsaufwand (daher sollten Ihre Traces genauer sein) und nimmt etwa zehnmal schneller auf als das JSON-Format.

Übersicht über das JSON-Trace-Format

Wenn Sie JSON verwenden möchten, erwartet spall Ereignisse, die dem JSON-Trace-Format von Google folgen. Sie sehen so aus:

 [
	{"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 kümmert sich nicht um abschließende Kommas und es sind keine schließenden Klammern erforderlich, um die Dateierstellung/das Ereignis-Streaming zu vereinfachen.)

Feldtypen

cat – Kategorie des Ereignisses. Derzeit unbenutzt

name – der Name des Ereignisses, eine Zeichenfolge

ph – Die Art des Ereignisses

Typ	Symbol
Beginnen	"B"
Ende	„E“
Vollständig	"X"

tid – Thread-ID, u32 pid – Prozess-ID, u32

Alle TIDs und PIDs müssen als ganze Werte zwischen 0 und u32_MAX liegen

ts – Zeitstempel, ein Double, in Mikrosekunden dur – Zeitstempel, ein Double, in Mikrosekunden

(Ein Zeitstempel von 1 beginnt bei 1 μs)

Ereignistypen

Spall unterstützt derzeit nur die Ereignisse „Begin“, „End“ und „Complete“.

Vollständig

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

Für vollständige Ereignisse ist ein Dauerfeld erforderlich, da sie den Start/das Ende einer Funktion in einem erfassen

Beginnen

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

Ende

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

Endereignisse schließen automatisch das letzte Anfangsereignis mit derselben PID und TID, sodass sie keine Namen benötigen

Wichtige Hinweise

Unabhängig vom Aufnahmeformat wird erwartet, dass alle Anfangs- und Endereignisse innerhalb eines Prozesses/Threads (PID/TID) in der Reihenfolge des frühesten Zeitstempels zuerst vorliegen, z. B.:

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