From bd949490a82fc68f43caff9504e4150483dba2d6 Mon Sep 17 00:00:00 2001 From: Bernd Hufmann Date: Wed, 28 May 2014 14:46:53 -0400 Subject: lttng-guide: Update LTTng Kernel Analysis section Update existing sections (e.g. Control Flow view) and add new section for CPU Usage analysis and view. Change-Id: Iee748e2c9837a101760a9b5531a9c0800273378a Signed-off-by: Bernd Hufmann Reviewed-on: https://git.eclipse.org/r/27492 Reviewed-by: Marc-Andre Laperle Tested-by: Marc-Andre Laperle Tested-by: Hudson CI --- .../doc/User-Guide.mediawiki | 53 ++++++++++++++++++++- .../doc/images/Cfv_show_view.png | Bin 28960 -> 17625 bytes .../doc/images/Cfv_zoom_region.png | Bin 4975 -> 4238 bytes .../doc/images/LTTng_CpuUsageView.png | Bin 0 -> 126265 bytes .../doc/images/LTTng_CpuUsageViewToolTip.png | Bin 0 -> 49413 bytes .../doc/images/LTTng_OpenCpuUsageView.png | Bin 0 -> 16171 bytes 6 files changed, 51 insertions(+), 2 deletions(-) create mode 100644 lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng_CpuUsageView.png create mode 100644 lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng_CpuUsageViewToolTip.png create mode 100644 lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng_OpenCpuUsageView.png diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/User-Guide.mediawiki b/lttng/org.eclipse.linuxtools.lttng.help/doc/User-Guide.mediawiki index c783d0676e..125d3c6b15 100644 --- a/lttng/org.eclipse.linuxtools.lttng.help/doc/User-Guide.mediawiki +++ b/lttng/org.eclipse.linuxtools.lttng.help/doc/User-Guide.mediawiki @@ -1486,6 +1486,7 @@ The '''LTTng Kernel''' perspective is built upon the [[#Tracing_Perspective | Tr * [[#Control_Flow_View | Control Flow View]] - to visualize processes state transitions * [[#Resources_View | Resources View]] - to visualize system resources state transitions +* [[#LTTng_Tracer_Control | LTTng Tracer Control]] - to configure LTTng tracing sessions remotely [[Image:images/LTTngKernelPerspective.png]] @@ -1498,10 +1499,12 @@ The perspective can be opened from the Eclipse Open Perspective dialog ('''Windo == Control Flow View == -The '''''Control Flow''''' view is a LTTng-specific view that shows per-process events graphically. To enable it, select ''Control Flow'' under ''LTTng'' within the ''Show View'' window ('''Window''' -> '''Show View''' -> '''Other...'''): +The '''''Control Flow''''' view is a LTTng-specific view that shows per-process events graphically. The LTTng Kernel analysis is executed the first time a LTTng Kernel is opened. After opening the trace, the element '''Control Flow''' is added under the '''LTTng Kernel Analysis''' tree element in the Project Explorer. To open the view, double-click the '''Control Flow''' tree element. [[Image:images/Cfv_show_view.png]] +Alternatively, select ''Control Flow'' under ''LTTng'' within the ''Show View'' window ('''Window''' -> '''Show View''' -> '''Other...'''): + You should get something like this: [[Image:images/Cfv_global.png]] @@ -1647,7 +1650,9 @@ The Control Flow View '''toolbar''', located at the top right of the view, has s == Resources View == -This view is specific to kernel trace. To open it, go in '''Window''' -> '''Show View''' -> '''Other...''' and select '''LTTng/Resources''' in the list. +This view is specific to LTTng kernel traces. The LTTng Kernel analysis is executed the first time a LTTng Kernel is opened. After opening the trace, the element '''Resources''' is added under the '''LTTng Kernel Analysis''' tree element of the Project Explorer. To open the view, double-click the '''Resources''' tree element. + +Alternatively, go in '''Window''' -> '''Show View''' -> '''Other...''' and select '''LTTng/Resources''' in the list. [[Image:images/Rv_example.png| Example of resources view with all trace points and syscalls enabled]] @@ -1716,6 +1721,50 @@ The Resources View '''toolbar''', located at the top right of the view, has shor | Zooms out on the selection by 50% |} +== LTTng CPU Usage View == + +The CPU Usage analysis and view is specific to LTTng Kernel traces. The CPU usage is derived from a kernel trace as long as the '''sched_switch''' event was enabled during the collection of the trace. This analysis is executed the first time that the CPU Usage view is opened after opening the trace. To open the view, double-click on the '''CPU Usage''' tree element under the '''LTTng Kernel Analysis''' tree element of the Project Explorer. + +[[Image:images/LTTng_OpenCpuUsageView.png]] + +Now, the CPU Usage view will show: + +[[Image:images/LTTng_CpuUsageView.png]] + +The view is divided into the following important sections: '''Process Information''' and the '''CPU Usage Chart'''. + + +=== Process Information === +The Process Information is displayed on the left side of the view and shows all threads that were executing on all available CPUs in the current time range. For each process, it shows in different columns the thread ID (TID), process name (Process), the average (%) execution time and the actual execution time (Time) during the current time range. It shows all threads that were executing on the CPUs in the current time range. + + +=== CPU Usage Chart === + +The CPU Usage Chart on the right side of the view, plots the total time spent on all CPUs of all processes and the time of the selected process. + + +==== Using the mouse ==== + +The CPU Usage chart is usable with the mouse. The following actions are set: + +* '''left-click''': select a time or time range begin time +* '''Shift-left-click''': select a time range end time +* '''left-drag horizontally''': select a time range or change the time range begin or end time +* '''middle-drag''': pan left or right +* '''right-drag horizontally''': zoom region +* '''mouse wheel up/down''': zoom in or out + + +==== Tooltips ==== + +Hover the cursor over a line of the chart and a tooltip will pop up with the following information: +* '''time''': current time of mouse position +* '''Total''': The total CPU usage + + +[[Image:images/LTTng_CpuUsageViewToolTip.png]] + + == LTTng Kernel Events Editor == The LTTng Kernel Events editor '''is''' the plain TMF [[#Events_Editor | Events Editor]], except that it provides its own specialized viewer to replace the standard one. In short, it has exactly the same behaviour but the layout is slightly different: diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_show_view.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_show_view.png index d0fb74dd92..1ddb600a33 100644 Binary files a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_show_view.png and b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_show_view.png differ diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_zoom_region.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_zoom_region.png index ae64febdf7..f02bfdf347 100644 Binary files a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_zoom_region.png and b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/Cfv_zoom_region.png differ diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng_CpuUsageView.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng_CpuUsageView.png new file mode 100644 index 0000000000..747ab8e255 Binary files /dev/null and b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng_CpuUsageView.png differ diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng_CpuUsageViewToolTip.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng_CpuUsageViewToolTip.png new file mode 100644 index 0000000000..b09e7c002d Binary files /dev/null and b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng_CpuUsageViewToolTip.png differ diff --git a/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng_OpenCpuUsageView.png b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng_OpenCpuUsageView.png new file mode 100644 index 0000000000..f111f6050e Binary files /dev/null and b/lttng/org.eclipse.linuxtools.lttng.help/doc/images/LTTng_OpenCpuUsageView.png differ -- cgit v1.2.3