[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Qemu-devel] [PATCH v4 4/5] Update documentation for LTTng ust tracing
From: |
Mohamad Gebai |
Subject: |
[Qemu-devel] [PATCH v4 4/5] Update documentation for LTTng ust tracing |
Date: |
Fri, 18 Oct 2013 02:39:52 -0400 |
Signed-off-by: Mohamad Gebai <address@hidden>
---
docs/tracing.txt | 36 ++++++++++++++++++++++++++++++++++++
1 file changed, 36 insertions(+)
diff --git a/docs/tracing.txt b/docs/tracing.txt
index bfc261b..d7be2fd 100644
--- a/docs/tracing.txt
+++ b/docs/tracing.txt
@@ -214,6 +214,42 @@ The "ust" backend uses the LTTng Userspace Tracer library.
There are no
monitor commands built into QEMU, instead UST utilities should be used to list,
enable/disable, and dump traces.
+Package lttng-tools is required for userspace tracing. You must ensure that the
+current user belongs to the "tracing" group, or manually launch the
+lttng-sessiond daemon for the current user prior to running any instance of
+Qemu.
+
+While running an instrumented Qemu, LTTng should be able to list all available
+events:
+
+ lttng list -u
+
+Create tracing session:
+
+ lttng create mysession
+
+Enable events:
+
+ lttng enable-event qemu:g_malloc -u
+
+Where the events can either be a comma-separated list of events, or "-a" to
+enable all tracepoint events. Start and stop tracing as needed:
+
+ lttng start
+ lttng stop
+
+View the trace:
+
+ lttng view
+
+Destroy tracing session:
+
+ lttng destroy
+
+Babeltrace can be used at any later time to view the trace:
+
+ babeltrace $HOME/lttng-traces/mysession-<date>-<time>
+
=== SystemTap ===
The "dtrace" backend uses DTrace sdt probes but has only been tested with
--
1.7.10.4
- [Qemu-devel] [PATCH v4 0/5] Fix UST backend for LTTng 2.x, Mohamad Gebai, 2013/10/18
- [Qemu-devel] [PATCH v4 2/5] Modified the tracetool framework for LTTng 2.x., Mohamad Gebai, 2013/10/18
- [Qemu-devel] [PATCH v4 3/5] Adapt Makefiles to the new LTTng ust interface., Mohamad Gebai, 2013/10/18
- [Qemu-devel] [PATCH v4 4/5] Update documentation for LTTng ust tracing,
Mohamad Gebai <=
- [Qemu-devel] [PATCH v4 5/5] Add ust generated files to .gitignore, Mohamad Gebai, 2013/10/18
- Re: [Qemu-devel] [PATCH v4 0/5] Fix UST backend for LTTng 2.x, Alex Bennée, 2013/10/18