NPLab

You've loaded an old revision of the document! If you save it, you will create a new version with this data.

====== Flame Graph ======

Ein Flame Graph stellt zu einem Programm (z. B. dem FreeBSD‑Kernel) die Funktionsaufrufe dar und wie lange es in einer bestimmten Funktion gebraucht hat.

Der Graph zeigt Namen von Funktionen in Kästchen übereinander an, wenn die untere die obere aufgerufen hat. Über die Breite der Kästchen zeigt der Graph, wie viel Zeit die Funktion eingenommen hat. Durch Klicken auf ein Kästchen lässt sich in dem Graph zoomen.

===== Erstellen =====

Zum Erstellen eines Flame Graphs werden Daten eines Profilers benötigt. Bei FreeBSD können das z. B. DTrace oder pmcstat liefern. Hier am Beispiel von pmcstat gezeigt.

Es wird ein CPU Performance Counter verwendet. Dafür muss erst das hwpmc Modul geladen werden.

<code>
kldload -n hwpmc
</code>

Nun kann das Programm gestartet werden, zu dessen Ausführung ein Flame Graph erstellt werden soll. Das kann z. B. iperf3 sein.

<code>
iperf3 -t 20 -c 192.168.11.3 > /dev/null &
</code>

Während das Programm läuft, muss man pmcstat starten.

<code>
pmcstat -S cpu_clk_unhalted.thread_p -O cksum.pmc sleep 10
</code>

Der Aufruf nutzt den CPU Performance Counter ''cpu_clk_unhalted.thread_p'', misst für 10 Sekunden und schreibt die Daten im Binärformat in die Datei ''cksum.pmc''. Welche CPU Performance Counter verwendet werden muss, hängt von der CPU ab, siehe

Nach der Messung müssen die Daten aufbereitet werden.

<code>
pmcstat -R cksum.pmc -z100 -G cksum.graph
</code>

Der Aufruf schreibt die Callchain-Informationen in die Datei ''cksum.graph''.

Zur Visualisierung in einem Flame Graph müssen abschließend zwei Perl-Skripte ausgeführt werden, die sich in diesem GitHub-Repository befinden: [[https://github.com/brendangregg/flamegraph]].

<code>
git clone https://github.com/brendangregg/flamegraph
flamegraph/stackcollapse-pmc.pl cksum.graph | flamegraph/flamegraph.pl > cksum.graph.svg
</code>

Die SVG-Datei kann in einem Browser geöffnet werden. Die folgende Grafik zeigt ein Flame Graph.

===== CPU Performance Counter =====

Die Namen des relevanten Performance Counter unterscheidert sich je nach CPU-Hersteller.

* AMD: ''ls_not_halted_cyc''
  * Intel: ''cpu_clk_unhalted.thread_p''
  * ARM: ''CPU_CYCLES''

Nicht jede CPU bietet die gleiche Menge an Performance Counter. Eine Liste der verfügbaren Performance Counter lässt sich mit pmcstat ausgeben.

<code>
kldload -n hwpmc
pmcstat -L
...
br_misp_retired.taken
cpu_clk_thread_unhalted.one_thread_active
cpu_clk_thread_unhalted.ref_xclk
cpu_clk_thread_unhalted.ref_xclk_any
cpu_clk_unhalted.one_thread_active
cpu_clk_unhalted.ref_tsc
cpu_clk_unhalted.ref_xclk
cpu_clk_unhalted.ref_xclk_any
cpu_clk_unhalted.thread
cpu_clk_unhalted.thread_any
cpu_clk_unhalted.thread_p
cpu_clk_unhalted.thread_p_any
cycle_activity.cycles_l1d_pending
...
</code>

===== Skript =====

Das folgende Skript erstellt ein Flame Graph zu der Ausführung von iperf3. Es lässt die ersten 5 Sekunden aus, um die Effekte beim Start einer Verbindung außen vor zu lassen.

<code>
kldload -n hwpmc

file=$1
flamegraph=/home/msvoelker/FlameGraph

iperf3 -t 20 -c 192.168.11.3 > /dev/null &

sleep 5

pmcstat -S cpu_clk_unhalted.thread_p -O $file.pmc sleep 10

pmcstat -R $file.pmc -z100 -G $file.graph

$flamegraph/stackcollapse-pmc.pl $file.graph | $flamegraph/flamegraph.pl > $file.graph.svg
</code>

Edit summary

Note: By editing this page you agree to license your content under the following license: CC Attribution-Share Alike 4.0 International