From 34bb48f2ed353c111e029a5e7574df76e1813661 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Genevi=C3=A8ve=20Bastien?= Date: Fri, 29 Aug 2014 11:55:58 -0400 Subject: [PATCH] CTF: Add some documentation on CTF test traces MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit Sometimes, for a unit test, we just need a trace and having the trace length, size and event count may help choose the right trace for the right test. Change-Id: Ibc963509c0c7b08ab74b8a69cc34f33f5462768e Signed-off-by: Geneviève Bastien Reviewed-on: https://git.eclipse.org/r/32555 Tested-by: Hudson CI Reviewed-by: Alexandre Montplaisir --- .../ctf/core/tests/shared/CtfTestTrace.java | 147 ++++++++++++++++-- 1 file changed, 135 insertions(+), 12 deletions(-) diff --git a/org.eclipse.linuxtools.ctf.core.tests/shared/org/eclipse/linuxtools/ctf/core/tests/shared/CtfTestTrace.java b/org.eclipse.linuxtools.ctf.core.tests/shared/org/eclipse/linuxtools/ctf/core/tests/shared/CtfTestTrace.java index 71c5eeaffd..2640fa7937 100644 --- a/org.eclipse.linuxtools.ctf.core.tests/shared/org/eclipse/linuxtools/ctf/core/tests/shared/CtfTestTrace.java +++ b/org.eclipse.linuxtools.ctf.core.tests/shared/org/eclipse/linuxtools/ctf/core/tests/shared/CtfTestTrace.java @@ -26,37 +26,161 @@ import org.eclipse.linuxtools.ctf.core.trace.CTFTrace; * @author Alexandre Montplaisir */ public enum CtfTestTrace { - /** Example kernel trace */ + /** + * Example kernel trace + * + * 
+     * Trace Size: 13 MB
+     * Tracer: lttng-modules 2.0.0
+     * Event count: 695 319
+     * Kernel version: 3.0.0-16-generic-pae
+     * Trace length: 10s
+     *
+ */ KERNEL("../org.eclipse.linuxtools.ctf.core.tests/traces/kernel"), - /** Another kernel trace */ + /** + * Another kernel trace + * + * 
+     * Trace Size: 14 MB
+     * Tracer: lttng-modules 2.0.0
+     * Event count: 595 641
+     * Kernel version: 3.2.0-18-generic
+     * Trace length: 11s
+     *
+ */ TRACE2("../org.eclipse.linuxtools.ctf.core.tests/traces/trace2"), - /** Kernel trace with event contexts */ + /** + * Kernel trace with event contexts: pid, ppid, tid, procname, + * perf_page_fault, perf_major_faults, perf_minor_faults + * + * 
+     * Trace Size: 56 MB
+     * Tracer: lttng-modules 2.1.0
+     * Event count: 714 484
+     * Kernel version: 3.8.1
+     * Trace length: 29s
+     *
+ */ KERNEL_VM("../org.eclipse.linuxtools.ctf.core.tests/traces/kernel_vm"), - /** Trace synchronization: source trace */ + /** + * Kernel trace with all events enabled. Contains 'inet_sock_local_*' events + * provided by Francis's Giraldeau lttng-modules addons branch to trace TCP + * events. Can be used along with {@link CtfTestTrace#SYNC_DEST} for trace + * synchronization. + * + * 
+     * Trace Size: 2.4 MB
+     * Tracer: lttng-modules 2.1.0
+     * Event count: 110 771
+     * Kernel version: 3.6.11-1-ARCH
+     * Trace length: 22s
+     *
+ */ SYNC_SRC("../org.eclipse.linuxtools.ctf.core.tests/traces/synctraces/scp_src"), - /** Trace synchronization: destination trace */ + /** + * Kernel trace with all events enabled. Contains 'inet_sock_local_*' events + * provided by Francis's Giraldeau lttng-modules addons branch to trace TCP + * events. Can be used along with {@link CtfTestTrace#SYNC_SRC} for trace + * synchronization. + * + * 
+     * Trace Size: 1.9 MB
+     * Tracer: lttng-modules 2.1.0
+     * Event count: 85 729
+     * Kernel version: 3.6.11-1-ARCH
+     * Trace length: 17s
+     *
+ */ SYNC_DEST("../org.eclipse.linuxtools.ctf.core.tests/traces/synctraces/scp_dest"), - /** Trace synchronization (case 2): django client trace */ + /** + * LTTng Kernel trace. Contains 'inet_sock_local_*' events provided by + * Francis's Giraldeau lttng-modules addons branch to trace TCP events. Can + * be used along with {@link CtfTestTrace#DJANGO_DB} and + * {@link CtfTestTrace#DJANGO_HTTPD} for trace synchronization. + * + * 
+     * Trace Size: 33 MB
+     * Tracer: lttng-modules 2.4.0
+     * Event count: 754 787
+     * Kernel version: 3.13.0-24-generic
+     * Trace length: 15s
+     *
+ */ DJANGO_CLIENT("../org.eclipse.linuxtools.ctf.core.tests/traces/django-benchmark/django-client"), - /** Trace synchronization (case 2): django db trace */ + /** + * LTTng Kernel trace. Contains 'inet_sock_local_*' events provided by + * Francis's Giraldeau lttng-modules addons branch to trace TCP events. Can + * be used along with {@link CtfTestTrace#DJANGO_CLIENT} and + * {@link CtfTestTrace#DJANGO_HTTPD} for trace synchronization. + * + * 
+     * Trace Size: 28 MB
+     * Tracer: lttng-modules 2.4.0
+     * Event count: 692 098
+     * Kernel version: 3.13.0-24-generic
+     * Trace length: 14s
+     *
+ */ DJANGO_DB("../org.eclipse.linuxtools.ctf.core.tests/traces/django-benchmark/django-db"), - /** Trace synchronization (case 2): django web server trace */ + /** + * LTTng Kernel trace. Contains 'inet_sock_local_*' events provided by + * Francis's Giraldeau lttng-modules addons branch to trace TCP events. Can + * be used along with {@link CtfTestTrace#DJANGO_DB} and + * {@link CtfTestTrace#DJANGO_CLIENT} for trace synchronization. + * + * 
+     * Trace Size: 31 MB
+     * Tracer: lttng-modules 2.4.0
+     * Event count: 779 096
+     * Kernel version:3.13.0-24-generic
+     * Trace length: 13s
+     *
+ */ DJANGO_HTTPD("../org.eclipse.linuxtools.ctf.core.tests/traces/django-benchmark/django-httpd"), - /** UST trace with lots of lost events */ + /** + * UST trace with lots of lost events + * + * 
+     * Trace Size: 3.4 MB
+     * Tracer: lttng-ust 2.3
+     * Event count: 1 000 000, with 967 700 lost events
+     * Trace length: 279ms
+     *
+ */ HELLO_LOST("../org.eclipse.linuxtools.ctf.core.tests/traces/hello-lost"), - /** UST trace with lttng-ust-cyg-profile events (aka -finstrument-functions) */ + /** + * UST trace with lttng-ust-cyg-profile events (aka -finstrument-functions) + * + * 
+     * Trace Size: 236 KB
+     * Tracer: lttng-ust 2.3
+     * Event count: 4 977
+     * Trace length: 10s
+     *
+ */ CYG_PROFILE("../org.eclipse.linuxtools.ctf.core.tests/traces/cyg-profile/glxgears-cyg-profile"), - /** UST trace with lttng-ust-cyg-profile-fast events (no address in func_exit) */ + /** + * UST trace with lttng-ust-cyg-profile-fast events (no address in + * func_exit) + * + * 
+     * Trace Size: 184 KB
+     * Tracer: lttng-ust 2.3
+     * Event count: 5 161
+     * Trace length: 11s
+     *
+ */ CYG_PROFILE_FAST("../org.eclipse.linuxtools.ctf.core.tests/traces/cyg-profile/glxgears-cyg-profile-fast"), /** Autogenerated Syntetic trace */ @@ -68,7 +192,6 @@ public enum CtfTestTrace { /** Set of many traces, do not call getTrace */ TRACE_EXPERIMENT("../org.eclipse.linuxtools.ctf.core.tests/traces/exp"); - private final String fPath; private CTFTrace fTrace = null; private CTFTrace fTraceFromFile = null; -- 2.34.1