whats-new: update for LTTng 2.7
authorPhilippe Proulx <eeppeliteloop@gmail.com>
Fri, 4 Sep 2015 20:12:07 +0000 (16:12 -0400)
committerPhilippe Proulx <eeppeliteloop@gmail.com>
Sat, 5 Sep 2015 01:52:32 +0000 (21:52 -0400)
Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>
contents/whats-new.md
toc/docs.yml

index d5a00066ce982f091fb6888ad454ca9bbe84e69e..8cbfd21c0b1243a4165f3f3f539c4181fbbef7bd 100644 (file)
@@ -2,29 +2,58 @@
 id: whats-new
 ---
 
-Most of the changes of LTTng 2.6 are bug fixes, making the toolchain
-more stable than ever before. Still, LTTng 2.6 adds some interesting
-features to the project.
-
-LTTng 2.5 already supported the instrumentation and tracing of
-[Java applications](#doc-java-application) through `java.util.logging`
-(JUL). LTTng 2.6 goes one step further by supporting
-<a href="https://logging.apache.org/log4j/1.2/" class="ext">Apache log4j 1.2</a>.
-The new log4j domain is selected using the `--log4j` option in various
-commands of the `lttng` tool.
-
-LTTng-modules has supported system call tracing for a long time,
-but until now, it was only possible to record either all of them,
-or none of them. LTTng 2.6 allows the user to record specific
-system call events, for example:
+LTTng 2.7 ships with a generous list of new features, with essential
+additions to all the project's components.
+
+Dynamic filtering of user space tracepoints has been available for
+quite some time now
+(see [Enabling and disabling events](#doc-enabling-disabling-events)).
+LTTng 2.7 adds filtering support to kernel events as well. For example:
+
+<pre class="term">
+lttng enable-event --kernel irq_handler_entry --filter 'irq == 28'
+</pre>
+
+LTTng 2.7 also adds wildcard support for kernel event names:
 
 <pre class="term">
-lttng enable-event --kernel --syscall open,fork,chdir,pipe
+lttng enable-event --kernel 'sched_*'
 </pre>
 
-Finally, the `lttng` command line tool is not only able to communicate
-with humans as it used to do, but also with machines thanks to its new
-[machine interface](#doc-mi) feature.
+On the user space tracing side, the new [`tracelog()`](#doc-tracelog)
+facility allows users to easily migrate from logging to tracing.
+`tracelog()` is similar to [`tracef()`](#doc-tracef), but accepts
+an additional log level parameter.
+
+The new `--shm-path` option of `lttng create` can be used to specify the
+path where the shared memory holding the ring buffers are
+created. This feature is useful when used with persistent memory file
+systems to extract the latest recorded trace data in the event of a
+crash requiring a reboot. The new `lttng-crash` command line
+utility can extract trace data from such a file (see
+[Recording trace data on persistent memory file systems](#doc-persistent-memory-file-systems)).
+
+LTTng-modules 2.7 and LTTng-UST 2.7 can rely on user plugins
+to provide custom clock sources to their tracer.
+LTTng-UST can also load a user plugin to retrieve the current CPU number.
+This feature exists for very advanced use cases. See
+the <a href="https://github.com/lttng/lttng-ust/tree/master/doc/examples/clock-override" class="ext">clock-override</a>
+and <a href="https://github.com/lttng/lttng-ust/tree/master/doc/examples/getcpu-override" class="ext">getcpu-override</a>
+examples for more details.
+
+Python developers can now benefit from the new
+[LTTng-UST Python agent](#doc-python-application),
+a Python&nbsp;2/3-compatible package which allows standard Python logging
+using the `logging` module to output log entries to an LTTng trace.
+
+Last but not least, the new `lttng track` and `lttng untrack` commands
+make [<abbr title="process ID">PID</abbr> tracking](#doc-pid-tracking)
+super-fast for both the kernel and the user space domains. When one or
+more PIDs are tracked, only the processes having those PIDs are allowed
+to emit enabled events.
+
+Moreover, LTTng 2.7 boasts great stability, benifiting from piles of
+bug fixes and more-than-welcome internal refactorings.
 
-To learn more about the new features of LTTng 2.6, see
-[the release announcement](//lttng.org/blog/2015/02/27/lttng-2.6-released/).
+To learn more about the new features of LTTng 2.7, see
+<a href="" class="ext">the release announcement</a>.
index c8bfa6d10cb933d180a986dc6d5ac645f7c68245..39b13c7c2ed8c8db9ce3d42371c1a668a184f5f2 100644 (file)
@@ -1,7 +1,7 @@
 title: The <span class="reset-text-transform">LTTng</span> Documentation
 cats:
   - id: whats-new
-    title: What's new in LTTng 2.6?
+    title: What's new in LTTng 2.7?
   - id: nuts-and-bolts
     title: Nuts and bolts
     cats:
This page took 0.025177 seconds and 4 git commands to generate.