commit 93dac25a5bc217be7e7c7c5aa3dacd27b3614c14
parent 23966e190bd043b50584abd6f5c9204e7b99ee73
Author: Andreas Gruhler <agruhl@gmx.ch>
Date: Sun, 26 Jun 2022 21:12:40 +0200
chore(docs): LTTng live session
Diffstat:
1 file changed, 25 insertions(+), 0 deletions(-)
diff --git a/docs/TESTING.md b/docs/TESTING.md
@@ -36,6 +36,11 @@ make CC=clang
Logs from the debug build can be recorded in a [LTTng tracing session](https://lttng.org/docs/v2.13/#doc-start-sessiond).
+Start the daemon in the background:
+```
+lttng-sessiond -b
+```
+
To start a new session use:
```bash
lttng create
@@ -84,6 +89,26 @@ killall lttng-sessiond
An example (script) for viewing the traces is also given in [./trace.sh](./trace.sh).
+## LTTng Live Tracing
+
+[Live tracing](https://lttng.org/docs/v2.13/#doc-lttng-live) is more convenient for rapid debugging.
+
+There is no need to stop the sessions to observe the logs.
+
+The setup is similar to the generic instructions above, but the session is created with the `--live` flave.
+
+```bash
+lttng-sessiond -b
+lttng create --live
+lttng start
+lttng enable-event --userspace 'diary:*'
+```
+
+Then start the diary with the shared object file in a new terminal to view the logs:
+```bash
+LD_PRELOAD=./libtpp.so ./diary
+```
+
## Send stderr to File
> :information_source: For proper tracing and logging, start diary with the LTTng tracepoint provider package (tpp) shared object file, see [LTTng](#linux-trace-toolkit-lttng).