Repository: logging-log4j2 Updated Branches: refs/heads/master f8705e658 -> d5b090da3
LOG4J2-1883 updated documentation, change notes and release notes Project: http://git-wip-us.apache.org/repos/asf/logging-log4j2/repo Commit: http://git-wip-us.apache.org/repos/asf/logging-log4j2/commit/d5b090da Tree: http://git-wip-us.apache.org/repos/asf/logging-log4j2/tree/d5b090da Diff: http://git-wip-us.apache.org/repos/asf/logging-log4j2/diff/d5b090da Branch: refs/heads/master Commit: d5b090da322df83f3b687cb9acb2d5e1d73ebb3b Parents: f8705e6 Author: rpopma <[email protected]> Authored: Sun Jan 28 21:47:44 2018 +0900 Committer: rpopma <[email protected]> Committed: Sun Jan 28 21:47:44 2018 +0900 ---------------------------------------------------------------------- src/changes/announcement.vm | 9 +++++---- src/changes/changes.xml | 3 +++ src/site/xdoc/manual/layouts.xml.vm | 5 +---- 3 files changed, 9 insertions(+), 8 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/d5b090da/src/changes/announcement.vm ---------------------------------------------------------------------- diff --git a/src/changes/announcement.vm b/src/changes/announcement.vm index 8ac443a..80b00ef 100644 --- a/src/changes/announcement.vm +++ b/src/changes/announcement.vm @@ -47,10 +47,9 @@ property substitution using Lookups, multiple patterns on a PatternLayout and as Loggers. Another notable Log4j 2 feature is the ability to be "garbage-free" (avoid allocating temporary objects) while logging. In addition, Log4j 2 will not lose events while reconfiguring. -This release contains new features, bugfixes and minor enhancements. Some of the new features include support -for the Java 9 module system, support for the new SLF4j 1.8 binding mechanism, simplification of the Log4j -property naming scheme, and native support of Jetty's logger. Log4j API is now a fully compliant module -while the other Log4j jars are named automatic modules. +This release contains new features, bugfixes and minor enhancements. The Log4j Core jar is now +a multi-release jar and adds limited support for precise (micro and nanosecond) timestamps when +running on Java 9. As of Log4j 2.9.0, the Log4j API was modified to use java.util.ServiceLoader to locate Log4j implementations, although the former binding mechanism is still supported. The Log4j API jar is now a multi-release jar @@ -85,6 +84,8 @@ We do, however, discourage the use of SerializedLayout and recommend JsonLayout </Socket> </Appenders> +Note that the XML, JSON and YAML formats changed in the 2.11.0 release: they no longer have the "timeMillis" attribute and instead have an "Instant" element with "epochSecond" and "nanoOfSecond" attributes. + Note that subsequent to the 2.9.0 release, for security reasons, Log4j does not process DTD in XML files. If you used DTD for including snippets, you have to use XInclude or Composite Configuration instead. http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/d5b090da/src/changes/changes.xml ---------------------------------------------------------------------- diff --git a/src/changes/changes.xml b/src/changes/changes.xml index cd495cf..431e665 100644 --- a/src/changes/changes.xml +++ b/src/changes/changes.xml @@ -31,6 +31,9 @@ - "remove" - Removed --> <release version="2.11.0" date="2018-xx-xx" description="GA Release 2.11.0"> + <action issue="LOG4J2-1883" dev="rpopma" type="add" due-to="Anthony Maire"> + Added support for precise (micro and nanosecond) timestamps when running on Java 9. A limited number of precise %d date formats are supported with PatternLayout. POTENTIAL BREAKING CHANGE: The XML, JSON and YAML formats have changed: they no longer have the "timeMillis" attribute and instead have an "Instant" element with "epochSecond" and "nanoOfSecond" attributes. + </action> <action issue="LOG4J2-2190" dev="mikes" type="add" due-to="Franz Wong"> Output JSON object for ObjectMessage in JsonLayout. </action> http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/d5b090da/src/site/xdoc/manual/layouts.xml.vm ---------------------------------------------------------------------- diff --git a/src/site/xdoc/manual/layouts.xml.vm b/src/site/xdoc/manual/layouts.xml.vm index 3760c97..42f64aa 100644 --- a/src/site/xdoc/manual/layouts.xml.vm +++ b/src/site/xdoc/manual/layouts.xml.vm @@ -345,7 +345,6 @@ logger.debug("one={}, two={}, three={}", 1, 2, 3); Log event follows this pattern: </p> <pre class="prettyprint linenums">{ - "timeMillis" : 1493121664118, "instant" : { "epochSecond" : 1493121664, "nanoOfSecond" : 118000000 @@ -2194,7 +2193,6 @@ at org.apache.logging.log4j.core.pattern.ExtendedThrowableTest.testException(Ext A well-formed XML document follows this pattern: </p> <pre class="prettyprint linenums"><Event xmlns="http://logging.apache.org/log4j/2.0/events"; - timeMillis="1493122559666" level="INFO" loggerName="HelloWorld" endOfBatch="false" @@ -2202,7 +2200,7 @@ at org.apache.logging.log4j.core.pattern.ExtendedThrowableTest.testException(Ext loggerFqcn="org.apache.logging.log4j.spi.AbstractLogger" threadId="1" threadPriority="5"> - <Instant epochSecond="1493121664" nanoOfSecond="118000000"/> + <Instant epochSecond="1493121664" nanoOfSecond="118000000"/> <Marker name="child"> <Parents> <Marker name="parent"> @@ -2334,7 +2332,6 @@ at org.apache.logging.log4j.core.pattern.ExtendedThrowableTest.testException(Ext A YAML log event follows this pattern: </p> <pre class="prettyprint linenums">--- -timeMillis: 1493122307075 instant: epochSecond: 1493121664 nanoOfSecond: 118000000
