From: Daniel Bristot de Oliveira <bristot@kernel.org>
To: Steven Rostedt <rostedt@goodmis.org>
Cc: Daniel Bristot de Oliveira <bristot@kernel.org>,
Ingo Molnar <mingo@redhat.com>, Tom Zanussi <zanussi@kernel.org>,
Masami Hiramatsu <mhiramat@kernel.org>,
Juri Lelli <juri.lelli@redhat.com>,
Clark Williams <williams@redhat.com>,
John Kacur <jkacur@redhat.com>,
Peter Zijlstra <peterz@infradead.org>,
Thomas Gleixner <tglx@linutronix.de>,
Sebastian Andrzej Siewior <bigeasy@linutronix.de>,
linux-rt-users@vger.kernel.org,
linux-trace-devel@vger.kernel.org, linux-kernel@vger.kernel.org
Subject: [PATCH V5 00/20] RTLA: An interface for osnoise/timerlat tracers
Date: Mon, 25 Oct 2021 19:40:25 +0200 [thread overview]
Message-ID: <cover.1635181938.git.bristot@kernel.org> (raw)
The rtla(1) is a meta-tool that includes a set of commands that
aims to analyze the real-time properties of Linux. But instead of
testing Linux as a black box, rtla leverages kernel tracing
capabilities to provide precise information about the properties
and root causes of unexpected results.
To start, it presents an interface to the osnoise and timerlat tracers.
In the future, it will also serve as home to the rtsl [1] and other
latency/noise tracers.
The first five patches are a re-send of [2] that enable multiple
instances for osnoise/timerlat tracers. They are required to run the -T
option - to save a trace with osnoise: events for debugging.
The next seven patches are rtla, rtla osnoise, and rtla timerlat.
The following patches are the man pages for the tools.
To compile rtla on fedora you need:
$ git clone git://git.kernel.org/pub/scm/libs/libtrace/libtraceevent.git
$ cd libtraceevent/
$ make
$ sudo make install
$ cd ..
$ git clone git://git.kernel.org/pub/scm/libs/libtrace/libtracefs.git
$ cd libtracefs/
$ make
$ sudo make install
$ cd ..
$ sudo dnf install python3-docutils procps-devel
$ cd $linux/tools/tracing/rtla/
$ make
$ sudo make install
This tool was be discussed at the RT-MC during LPC2021.
[1] rtsl: https://github.com/bristot/rtsl/
[2] https://lore.kernel.org/lkml/cover.1628775552.git.bristot@kernel.org/
[3] https://youtu.be/cZUzc0U1jJ4
Changes from v4:
- Fix comment on start_per_cpu_kthreads() (Steven)
- Fix msg log on patch 1
- Add comments about the barrier need for trace_nmi_enter/exit
- Fix RCU usage in osnoise_unregister_instance() (Steven/Paul)
- Add lockdep checks in osnoise_unregister/unregister_instance()
(Steven/Paul)
- Improve the explanation about the multi instances support (Steven)
Changes from v3:
- Add cross-compile support (Ahmed S. Darwish)
- Move documentation to Documentation/tools/rtla (Jonathan Corbet)
- Use .rst format for documentation (Jonathan Corbet)
- Use include option from .rst to group common parts of the documentation
- Makefile (main and doc) cleanups
Changes from v2:
- Fix the miss conception of the "size" for kernel histograms (Steven/Tom)
- Change the --skip-zeros to --with-zeros option as the former is better
for humans (and the latter for computers to plot charts).
- A lot of checkpatch fixes for the user-space part.
Changes from v1:
- Fixes -t options on osnoise tracers (-t means --trace for all tools now)
- Fixes --bucket-size references (not --bucket_size)
Daniel Bristot de Oliveira (20):
trace/osnoise: Do not follow tracing_cpumask
trace/osnoise: Improve comments about barrier need for NMI callbacks
trace/osnoise: Split workload start from the tracer start
trace/osnoise: Use start/stop_per_cpu_kthreads() on
osnoise_cpus_write()
trace/osnoise: Support a list of trace_array *tr
trace/osnoise: Allow multiple instances of the same tracer
rtla: Real-Time Linux Analysis tool
rtla: Helper functions for rtla
rtla: Add osnoise tool
rtla/osnoise: Add osnoise top mode
rtla/osnoise: Add the hist mode
rtla: Add timerlat tool and timelart top mode
rtla/timerlat: Add timerlat hist mode
rtla: Add Documentation
rtla: Add rtla osnoise man page
rtla: Add rtla osnoise top documentation
rtla: Add rtla osnoise hist documentation
rtla: Add rtla timerlat documentation
rtla: Add rtla timerlat top documentation
rtla: Add rtla timerlat hist documentation
Documentation/tools/rtla/Makefile | 41 +
Documentation/tools/rtla/common_appendix.rst | 12 +
.../tools/rtla/common_hist_options.rst | 23 +
Documentation/tools/rtla/common_options.rst | 24 +
.../tools/rtla/common_osnoise_description.rst | 8 +
.../tools/rtla/common_osnoise_options.rst | 17 +
.../rtla/common_timerlat_description.rst | 10 +
.../tools/rtla/common_timerlat_options.rst | 16 +
.../tools/rtla/common_top_options.rst | 3 +
.../tools/rtla/rtla-osnoise-hist.rst | 66 ++
Documentation/tools/rtla/rtla-osnoise-top.rst | 61 ++
Documentation/tools/rtla/rtla-osnoise.rst | 59 ++
.../tools/rtla/rtla-timerlat-hist.rst | 106 +++
.../tools/rtla/rtla-timerlat-top.rst | 145 +++
Documentation/tools/rtla/rtla-timerlat.rst | 57 ++
Documentation/tools/rtla/rtla.rst | 48 +
kernel/trace/trace_osnoise.c | 426 ++++++---
tools/tracing/rtla/Makefile | 102 +++
tools/tracing/rtla/src/osnoise.c | 837 ++++++++++++++++++
tools/tracing/rtla/src/osnoise.h | 87 ++
tools/tracing/rtla/src/osnoise_hist.c | 783 ++++++++++++++++
tools/tracing/rtla/src/osnoise_top.c | 567 ++++++++++++
tools/tracing/rtla/src/rtla.c | 87 ++
tools/tracing/rtla/src/timerlat.c | 72 ++
tools/tracing/rtla/src/timerlat.h | 4 +
tools/tracing/rtla/src/timerlat_hist.c | 780 ++++++++++++++++
tools/tracing/rtla/src/timerlat_top.c | 581 ++++++++++++
tools/tracing/rtla/src/trace.c | 219 +++++
tools/tracing/rtla/src/trace.h | 27 +
tools/tracing/rtla/src/utils.c | 433 +++++++++
tools/tracing/rtla/src/utils.h | 56 ++
31 files changed, 5635 insertions(+), 122 deletions(-)
create mode 100644 Documentation/tools/rtla/Makefile
create mode 100644 Documentation/tools/rtla/common_appendix.rst
create mode 100644 Documentation/tools/rtla/common_hist_options.rst
create mode 100644 Documentation/tools/rtla/common_options.rst
create mode 100644 Documentation/tools/rtla/common_osnoise_description.rst
create mode 100644 Documentation/tools/rtla/common_osnoise_options.rst
create mode 100644 Documentation/tools/rtla/common_timerlat_description.rst
create mode 100644 Documentation/tools/rtla/common_timerlat_options.rst
create mode 100644 Documentation/tools/rtla/common_top_options.rst
create mode 100644 Documentation/tools/rtla/rtla-osnoise-hist.rst
create mode 100644 Documentation/tools/rtla/rtla-osnoise-top.rst
create mode 100644 Documentation/tools/rtla/rtla-osnoise.rst
create mode 100644 Documentation/tools/rtla/rtla-timerlat-hist.rst
create mode 100644 Documentation/tools/rtla/rtla-timerlat-top.rst
create mode 100644 Documentation/tools/rtla/rtla-timerlat.rst
create mode 100644 Documentation/tools/rtla/rtla.rst
create mode 100644 tools/tracing/rtla/Makefile
create mode 100644 tools/tracing/rtla/src/osnoise.c
create mode 100644 tools/tracing/rtla/src/osnoise.h
create mode 100644 tools/tracing/rtla/src/osnoise_hist.c
create mode 100644 tools/tracing/rtla/src/osnoise_top.c
create mode 100644 tools/tracing/rtla/src/rtla.c
create mode 100644 tools/tracing/rtla/src/timerlat.c
create mode 100644 tools/tracing/rtla/src/timerlat.h
create mode 100644 tools/tracing/rtla/src/timerlat_hist.c
create mode 100644 tools/tracing/rtla/src/timerlat_top.c
create mode 100644 tools/tracing/rtla/src/trace.c
create mode 100644 tools/tracing/rtla/src/trace.h
create mode 100644 tools/tracing/rtla/src/utils.c
create mode 100644 tools/tracing/rtla/src/utils.h
--
2.31.1
next reply other threads:[~2021-10-25 17:41 UTC|newest]
Thread overview: 32+ messages / expand[flat|nested] mbox.gz Atom feed top
2021-10-25 17:40 Daniel Bristot de Oliveira [this message]
2021-10-25 17:40 ` [PATCH V5 01/20] trace/osnoise: Do not follow tracing_cpumask Daniel Bristot de Oliveira
2021-10-25 17:40 ` [PATCH V5 02/20] trace/osnoise: Improve comments about barrier need for NMI callbacks Daniel Bristot de Oliveira
2021-10-25 17:40 ` [PATCH V5 03/20] trace/osnoise: Split workload start from the tracer start Daniel Bristot de Oliveira
2021-10-25 17:40 ` [PATCH V5 04/20] trace/osnoise: Use start/stop_per_cpu_kthreads() on osnoise_cpus_write() Daniel Bristot de Oliveira
2021-10-26 1:08 ` Steven Rostedt
2021-10-26 8:23 ` Daniel Bristot de Oliveira
2021-10-25 17:40 ` [PATCH V5 05/20] trace/osnoise: Support a list of trace_array *tr Daniel Bristot de Oliveira
2021-10-25 17:40 ` [PATCH V5 06/20] trace/osnoise: Allow multiple instances of the same tracer Daniel Bristot de Oliveira
2021-10-26 2:08 ` Steven Rostedt
2021-10-26 8:38 ` Daniel Bristot de Oliveira
2021-10-26 13:02 ` Steven Rostedt
2021-10-25 17:40 ` [PATCH V5 07/20] rtla: Real-Time Linux Analysis tool Daniel Bristot de Oliveira
2021-10-25 17:40 ` [PATCH V5 08/20] rtla: Helper functions for rtla Daniel Bristot de Oliveira
2021-10-26 16:22 ` Tao Zhou
2021-10-26 16:26 ` Steven Rostedt
2021-10-26 19:45 ` Daniel Bristot de Oliveira
2021-10-26 19:43 ` Daniel Bristot de Oliveira
2021-10-25 17:40 ` [PATCH V5 09/20] rtla: Add osnoise tool Daniel Bristot de Oliveira
2021-10-25 17:40 ` [PATCH V5 10/20] rtla/osnoise: Add osnoise top mode Daniel Bristot de Oliveira
2021-10-26 16:32 ` Tao Zhou
2021-10-26 19:50 ` Daniel Bristot de Oliveira
2021-10-25 17:40 ` [PATCH V5 11/20] rtla/osnoise: Add the hist mode Daniel Bristot de Oliveira
2021-10-25 17:40 ` [PATCH V5 12/20] rtla: Add timerlat tool and timelart top mode Daniel Bristot de Oliveira
2021-10-25 17:40 ` [PATCH V5 13/20] rtla/timerlat: Add timerlat hist mode Daniel Bristot de Oliveira
2021-10-25 17:40 ` [PATCH V5 14/20] rtla: Add Documentation Daniel Bristot de Oliveira
2021-10-25 17:40 ` [PATCH V5 15/20] rtla: Add rtla osnoise man page Daniel Bristot de Oliveira
2021-10-25 17:40 ` [PATCH V5 16/20] rtla: Add rtla osnoise top documentation Daniel Bristot de Oliveira
2021-10-25 17:40 ` [PATCH V5 17/20] rtla: Add rtla osnoise hist documentation Daniel Bristot de Oliveira
2021-10-25 17:40 ` [PATCH V5 18/20] rtla: Add rtla timerlat documentation Daniel Bristot de Oliveira
2021-10-25 17:40 ` [PATCH V5 19/20] rtla: Add rtla timerlat top documentation Daniel Bristot de Oliveira
2021-10-25 17:40 ` [PATCH V5 20/20] rtla: Add rtla timerlat hist documentation Daniel Bristot de Oliveira
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=cover.1635181938.git.bristot@kernel.org \
--to=bristot@kernel.org \
--cc=bigeasy@linutronix.de \
--cc=jkacur@redhat.com \
--cc=juri.lelli@redhat.com \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-rt-users@vger.kernel.org \
--cc=linux-trace-devel@vger.kernel.org \
--cc=mhiramat@kernel.org \
--cc=mingo@redhat.com \
--cc=peterz@infradead.org \
--cc=rostedt@goodmis.org \
--cc=tglx@linutronix.de \
--cc=williams@redhat.com \
--cc=zanussi@kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).