linux-kernel - [PATCH] perf timechart: explain the SVG output

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite for Android: free password hash cracker in your pocket

[<prev] [next>] [day] [month] [year] [list]

Message-Id: <20200601171015.23868-1-elazarl@gmail.com>
Date:   Mon,  1 Jun 2020 20:10:14 +0300
From:   Elazar Leibovich <elazarl@...il.com>
To:     linux-kernel@...r.kernel.org
Cc:     Elazar Leibovich <elazarl@...il.com>,
        Peter Zijlstra <peterz@...radead.org>,
        Ingo Molnar <mingo@...hat.com>,
        Arnaldo Carvalho de Melo <acme@...nel.org>,
        Mark Rutland <mark.rutland@....com>,
        Alexander Shishkin <alexander.shishkin@...ux.intel.com>,
        Jiri Olsa <jolsa@...hat.com>,
        Namhyung Kim <namhyung@...nel.org>
Subject: [PATCH] perf timechart: explain the SVG output

It is not immediately clear what the SVG output means
and how is it supposed to be used.

Add links to example SVGs, and to annotated images
explaining what each part in the SVG means.

Signed-off-by: Elazar Leibovich <elazarl@...il.com>
---
 tools/perf/Documentation/perf-timechart.txt | 22 +++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/tools/perf/Documentation/perf-timechart.txt b/tools/perf/Documentation/perf-timechart.txt
index ef0c7565bd5c..460f3bd65789 100644
--- a/tools/perf/Documentation/perf-timechart.txt
+++ b/tools/perf/Documentation/perf-timechart.txt
@@ -12,6 +12,13 @@ SYNOPSIS
 
 DESCRIPTION
 -----------
+The perf-timechart tool will visualize what the system did in a certain timespan.
+Looking at 'perf timechart' output will allow you to see at a glance:
+
+  How much time was a certain process scheduled, when was it waiting for IO?
+  How many CPUs did the process use?
+  Did my process move between CPUs?
+
 There are two variants of perf timechart:
 
   'perf timechart record <command>' to record the system level events
@@ -30,6 +37,15 @@ There are two variants of perf timechart:
   There are also poll bars which show how much time application spent
   in poll/epoll/select syscalls.
 
+See also annotated example of perf-timechart report:
+
+  http://elazarl.github.io/perf-timechart/perf_timechart_wrk_python.png
+  http://elazarl.github.io/perf-timechart/perf_timechart_cpu_chart.png
+
+Or annotated example of perf-timechart record -I:
+
+  http://elazarl.github.io/perf-timechart/perf_timechart_wrk_io.png
+
 TIMECHART OPTIONS
 -----------------
 -o::
@@ -123,6 +139,12 @@ Record system-wide IO events:
 
   $ perf timechart
 
+Example SVGs for the wrk HTTP benchmark testing python3 -m http.server
+can be found here:
+
+  http://elazarl.github.io/perf-timechart/wrk.svg
+  http://elazarl.github.io/perf-timechart/wrk-io.svg
+
 SEE ALSO
 --------
 linkperf:perf-record[1]
-- 
2.25.0