You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@logging.apache.org by rg...@apache.org on 2017/11/18 23:29:15 UTC
[3/5] logging-log4j2 git commit: Prepare for release
Prepare for release
Project: http://git-wip-us.apache.org/repos/asf/logging-log4j2/repo
Commit: http://git-wip-us.apache.org/repos/asf/logging-log4j2/commit/c8f4df1b
Tree: http://git-wip-us.apache.org/repos/asf/logging-log4j2/tree/c8f4df1b
Diff: http://git-wip-us.apache.org/repos/asf/logging-log4j2/diff/c8f4df1b
Branch: refs/heads/master
Commit: c8f4df1b13ffa085f8abfe254dbf131b8cbfbd9a
Parents: b118dc6
Author: Ralph Goers <rg...@apache.org>
Authored: Sat Nov 18 13:36:42 2017 -0700
Committer: Ralph Goers <rg...@apache.org>
Committed: Sat Nov 18 16:25:08 2017 -0700
----------------------------------------------------------------------
RELEASE-NOTES.md | 138 +++++++++++++------
src/changes/announcement.vm | 7 +-
src/changes/changes.xml | 2 +-
src/site/resources/images/logo.png | Bin 31667 -> 33655 bytes
.../resources/logo/logo-big-blue-cup-2.10.png | Bin 0 -> 33655 bytes
.../resources/logo/logo-big-blue-cup-2.10.xcf | Bin 0 -> 59855 bytes
6 files changed, 105 insertions(+), 42 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/c8f4df1b/RELEASE-NOTES.md
----------------------------------------------------------------------
diff --git a/RELEASE-NOTES.md b/RELEASE-NOTES.md
index 55cd0f9..dbe9ab6 100644
--- a/RELEASE-NOTES.md
+++ b/RELEASE-NOTES.md
@@ -1,6 +1,6 @@
-# Apache Log4j 2.9.1 Release Notes
+# Apache Log4j 2.10.0 Release Notes
-The Apache Log4j 2 team is pleased to announce the Log4j 2.9.1 release!
+The Apache Log4j 2 team is pleased to announce the Log4j 2.10.0 release!
Apache Log4j is a well known framework for logging application behavior. Log4j 2 is an upgrade
to Log4j that provides significant improvements over its predecessor, Log4j 1.x, and provides
@@ -9,10 +9,13 @@ 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 bugfixes and minor enhancements.
+This release contains new features, bugfixes and minor enhancements. Some of the new features include support
+for the Java 9 module system, 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.
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 jar is now a multi-release jar
+although the former binding mechanism is still supported. The Log4j API jar is now a multi-release jar
to provide implementations of Java 9 specific classes. Multi-release jars are not supported by
the OSGi specification so OSGi modules will not be able to take advantage of these implementations
but will not lose functionality as they will fall back to the implementations used in Java 7 and 8.
@@ -47,52 +50,109 @@ We do, however, discourage the use of SerializedLayout and recommend JsonLayout
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.
-The Log4j 2.9.1 API, as well as many core components, maintains binary compatibility with previous releases.
+The Log4j 2.10.0 API, as well as many core components, maintains binary compatibility with previous releases.
-## GA Release 2.9.1
+## GA Release 2.10.0
Changes in this version include:
+### New Features
+* [LOG4J2-2120](https://issues.apache.org/jira/browse/LOG4J2-2120):
+Properly escape newlines and other control characters in JSON. Thanks to Carter Douglas Kozak.
+* [LOG4J2-2109](https://issues.apache.org/jira/browse/LOG4J2-2109):
+Add property to disable message pattern converter lookups. Thanks to Carter Douglas Kozak.
+* [LOG4J2-2112](https://issues.apache.org/jira/browse/LOG4J2-2112):
+MapMessage should use deep toString for values. Thanks to Carter Douglas Kozak.
+* [LOG4J2-2103](https://issues.apache.org/jira/browse/LOG4J2-2103):
+XML encoding for PatternLayout.
+* [LOG4J2-2114](https://issues.apache.org/jira/browse/LOG4J2-2114):
+Provide a native Log4j 2 implementation of Eclipse Jetty's org.eclipse.jetty.util.log.Logger.
+* [LOG4J2-1203](https://issues.apache.org/jira/browse/LOG4J2-1203):
+Allow filtering of line breaks in layout pattern. Thanks to Robert Turner.
+* [LOG4J2-2098](https://issues.apache.org/jira/browse/LOG4J2-2098):
+Add a noop AppenderSkeleton for applications still using Log4j 1.x.
+* [LOG4J2-2062](https://issues.apache.org/jira/browse/LOG4J2-2062):
+Add possibility of sending the key of a message to Kafka using KafkaAppender. Thanks to Jorge Sanchez.
+* [LOG4J2-2056](https://issues.apache.org/jira/browse/LOG4J2-2056):
+Modularize Log4j-api and make most other log4j jars automatic modules.
+* [LOG4J2-1431](https://issues.apache.org/jira/browse/LOG4J2-1431):
+Simplify log4j system property naming scheme.
+* [LOG4J2-1809](https://issues.apache.org/jira/browse/LOG4J2-1809):
+Add global configuration environment SPI.
+* [LOG4J2-1694](https://issues.apache.org/jira/browse/LOG4J2-1694):
+Add fields with fixed values to JSON/XML/YAML layouts. Thanks to Michal Dvořák.
+* [LOG4J2-2054](https://issues.apache.org/jira/browse/LOG4J2-2054):
+Provide ways to configure SSL that avoid plain-text passwords in the log4j configuration. The configuration may
+ now specify a system environment variable that holds the password, or the path to a file that holds the password.
+* [LOG4J2-2071](https://issues.apache.org/jira/browse/LOG4J2-2071):
+Add org.apache.logging.log4j.core.config.composite.CompositeConfiguration#toString(). Thanks to Carter Kozak.
### Fixed Bugs
-* [LOG4J2-1988](https://issues.apache.org/jira/browse/LOG4J2-1988):
-Prevent ConcurrentModificationException with AsyncLoggerConfig.
-* [LOG4J2-1914](https://issues.apache.org/jira/browse/LOG4J2-1914):
-Prevent ConcurrentModificationException with AsyncLoggerConfig.
-* [LOG4J2-2048](https://issues.apache.org/jira/browse/LOG4J2-2048):
-Increase default queue size for AsyncAppender from 128 to 1024.
-* [LOG4J2-2035](https://issues.apache.org/jira/browse/LOG4J2-2035):
-Fix documentation to clarify disruptor-3.3.4 is now required for async loggers: disruptor-3.3.3 was never released.
-* [LOG4J2-2030](https://issues.apache.org/jira/browse/LOG4J2-2030):
-Inspect all known ClassLoaders to locate the service provider.
-* [LOG4J2-2028](https://issues.apache.org/jira/browse/LOG4J2-2028):
-Java 9 StackLocator was not properly skipping the initial stack frames. Thanks to Jason Tedor.
-* [LOG4J2-2026](https://issues.apache.org/jira/browse/LOG4J2-2026):
-java.lang.AbstractMethodError: javax.xml.parsers.DocumentBuilderFactory.setFeature(). Thanks to Leon Finker.
-* [LOG4J2-2029](https://issues.apache.org/jira/browse/LOG4J2-2029):
-Marker examples should not use deprecated flow APIs. Thanks to Fabrizio Cucci.
-* [LOG4J2-1936](https://issues.apache.org/jira/browse/LOG4J2-1936):
-ClassNotFoundException when making all loggers asynchronous under OSGi environment. Thanks to Helber Belmiro.
+* [LOG4J2-2107](https://issues.apache.org/jira/browse/LOG4J2-2107):
+MapMessage supports both StringBuilderFormattable and MultiformatMessage. Thanks to Carter Douglas Kozak.
+* [LOG4J2-2102](https://issues.apache.org/jira/browse/LOG4J2-2102):
+MapMessage JSON encoding will escape keys and values. Thanks to Carter Douglas Kozak.
+* [LOG4J2-2101](https://issues.apache.org/jira/browse/LOG4J2-2101):
+Non-string value in MapMessage caused ClassCastException. Thanks to Carter Douglas Kozak.
+* [LOG4J2-2091](https://issues.apache.org/jira/browse/LOG4J2-2091):
+Log4j respects the configured "log4j2.is.webapp" property Thanks to Carter Douglas Kozak.
+* [LOG4J2-2100](https://issues.apache.org/jira/browse/LOG4J2-2100):
+LevelMixIn class for Jackson is coded incorrectly
+* [LOG4J2-2087](https://issues.apache.org/jira/browse/LOG4J2-2087):
+Jansi now needs to be enabled explicitly (by setting system property `log4j.skipJansi` to `false`). To avoid causing problems for web applications, Log4j will no longer automatically try to load Jansi without explicit configuration. Thanks to Andy Gumbrecht.
+* [LOG4J2-2060](https://issues.apache.org/jira/browse/LOG4J2-2060):
+AbstractDatabaseManager should make a copy of LogEvents before holding references to them: AsyncLogger log events are mutable.
+* [LOG4J2-2055](https://issues.apache.org/jira/browse/LOG4J2-2055):
+If Log4j is used as the Tomcat logging implementation startup might fail if an application also uses Log4j.
+* [LOG4J2-2031](https://issues.apache.org/jira/browse/LOG4J2-2031):
+Until this change, messages appeared out of order in log file any time when the async logging queue was full.
+ With this change, messages are only logged out of order to prevent deadlock when Log4j2 detects recursive
+ logging while the queue is full.
+* [LOG4J2-2053](https://issues.apache.org/jira/browse/LOG4J2-2053):
+Exception java.nio.charset.UnsupportedCharsetException: cp65001 in 2.9.0.
+* [LOG4J2-1216](https://issues.apache.org/jira/browse/LOG4J2-1216):
+Nested pattern layout options broken. Thanks to Thies Wellpott, Barna Zsombor Klara, GFriedrich.
+* [LOG4J2-2070](https://issues.apache.org/jira/browse/LOG4J2-2070):
+Log4j1XmlLayout does not provide the entire stack trace, it is missing the caused by information. Thanks to Doug Hughes.
+* [LOG4J2-2036](https://issues.apache.org/jira/browse/LOG4J2-2036):
+CompositeConfiguration supports Reconfiguration. PR #115. Thanks to Robert Haycock.
+* [LOG4J2-2073](https://issues.apache.org/jira/browse/LOG4J2-2073):
+Log4j-config.xsd should make AppenderRef optional for each Logger element. Thanks to Patrick Lucas.
+* [LOG4J2-2074](https://issues.apache.org/jira/browse/LOG4J2-2074):
+The console appender should say why it cannot load JAnsi.
+* [LOG4J2-2085](https://issues.apache.org/jira/browse/LOG4J2-2085):
+Wrong Apache Commons CSV version referenced in the Javadoc of CsvParameterLayout. Thanks to István Neuwirth.
### Changes
-* [LOG4J2-2023](https://issues.apache.org/jira/browse/LOG4J2-2023):
-Use a class' canonical name instead of name to create its logger name.
-* [LOG4J2-2043](https://issues.apache.org/jira/browse/LOG4J2-2043):
-Update Jackson from 2.9.0 to 2.9.1 (fix for Java 9.)
-* [LOG4J2-2044](https://issues.apache.org/jira/browse/LOG4J2-2044):
-Update Apache Commons CSV from 1.4 to 1.5.
-* [LOG4J2-2045](https://issues.apache.org/jira/browse/LOG4J2-2045):
-Update javax.mail from 1.5.6 to 1.6.0.
-* [LOG4J2-2046](https://issues.apache.org/jira/browse/LOG4J2-2046):
-Update Apache Commons Compress from 1.13 to 1.14.
-* [LOG4J2-2047](https://issues.apache.org/jira/browse/LOG4J2-2047):
-Update Cassandra driver from 3.1.0 to 3.1.4.
-* [LOG4J2-2049](https://issues.apache.org/jira/browse/LOG4J2-2049):
-Update Apache Kafka Client from 0.11.0.0 to 0.11.0.1.
+* [LOG4J2-2076](https://issues.apache.org/jira/browse/LOG4J2-2076):
+Split up log4j-nosql into one module per appender.
+* [LOG4J2-2088](https://issues.apache.org/jira/browse/LOG4J2-2088):
+Upgrade picocli to 2.0.3 from 0.9.8.
+* [LOG4J2-2025](https://issues.apache.org/jira/browse/LOG4J2-2025):
+Provide support for overriding the Tomcat Log class in Tomcat 8.5+.
+* [LOG4J2-2057](https://issues.apache.org/jira/browse/LOG4J2-2057):
+Support new SLF4J binding mechanism introduced in SLF4J 1.8.
+* [LOG4J2-2052](https://issues.apache.org/jira/browse/LOG4J2-2052):
+Disable thread name caching by default when running on Java 8u102 or later.
+* [LOG4J2-1896](https://issues.apache.org/jira/browse/LOG4J2-1896):
+Update classes in org.apache.logging.log4j.core.net.ssl in APIs from String to a PasswordProvider producing
+ char[] for passwords.
+* [LOG4J2-2078](https://issues.apache.org/jira/browse/LOG4J2-2078):
+Update LMAX disruptor from 3.3.6 to 3.3.7.
+* [LOG4J2-2081](https://issues.apache.org/jira/browse/LOG4J2-2081):
+Update Apache Commons Compress from 1.14 to 1.15.
+* [LOG4J2-2089](https://issues.apache.org/jira/browse/LOG4J2-2089):
+[TagLib] Update servlet-api provided dependency from 2.5 to 3.0.1.
+* [LOG4J2-2096](https://issues.apache.org/jira/browse/LOG4J2-2096):
+Update Apache Kafka kafka-clients from 0.11.0.1 to 1.0.0.
+* [LOG4J2-2077](https://issues.apache.org/jira/browse/LOG4J2-2077):
+Update from Jackson 2.9.1 to 2.9.2.
+* [LOG4J2-2117](https://issues.apache.org/jira/browse/LOG4J2-2117):
+Jackson dependencies for 2.9.2 incorrectly bring in jackson-annotations 2.9.0 instead of 2.9.2.
---
-Apache Log4j 2.9.1 requires a minimum of Java 7 to build and run. Log4j 2.3 was the
+Apache Log4j 2.10.0 requires a minimum of Java 7 to build and run. Log4j 2.3 was the
last release that supported Java 6.
Basic compatibility with Log4j 1.x is provided through the log4j-1.2-api component, however it
http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/c8f4df1b/src/changes/announcement.vm
----------------------------------------------------------------------
diff --git a/src/changes/announcement.vm b/src/changes/announcement.vm
index 98f8ab4..e2da7d2 100644
--- a/src/changes/announcement.vm
+++ b/src/changes/announcement.vm
@@ -47,10 +47,13 @@ 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 bugfixes and minor enhancements.
+This release contains new features, bugfixes and minor enhancements. Some of the new features include support
+for the Java 9 module system, 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.
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 jar is now a multi-release jar
+although the former binding mechanism is still supported. The Log4j API jar is now a multi-release jar
to provide implementations of Java 9 specific classes. Multi-release jars are not supported by
the OSGi specification so OSGi modules will not be able to take advantage of these implementations
but will not lose functionality as they will fall back to the implementations used in Java 7 and 8.
http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/c8f4df1b/src/changes/changes.xml
----------------------------------------------------------------------
diff --git a/src/changes/changes.xml b/src/changes/changes.xml
index 2972991..6328706 100644
--- a/src/changes/changes.xml
+++ b/src/changes/changes.xml
@@ -30,7 +30,7 @@
- "update" - Change
- "remove" - Removed
-->
- <release version="2.10.0" date="2017-MM-DD" description="GA Release 2.10.0">
+ <release version="2.10.0" date="2017-11-18" description="GA Release 2.10.0">
<action issue="LOG4J2-2120" dev="mikes" type="add" due-to="Carter Douglas Kozak ">
Properly escape newlines and other control characters in JSON.
</action>
http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/c8f4df1b/src/site/resources/images/logo.png
----------------------------------------------------------------------
diff --git a/src/site/resources/images/logo.png b/src/site/resources/images/logo.png
index 1a850fc..5759868 100644
Binary files a/src/site/resources/images/logo.png and b/src/site/resources/images/logo.png differ
http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/c8f4df1b/src/site/resources/logo/logo-big-blue-cup-2.10.png
----------------------------------------------------------------------
diff --git a/src/site/resources/logo/logo-big-blue-cup-2.10.png b/src/site/resources/logo/logo-big-blue-cup-2.10.png
new file mode 100644
index 0000000..5759868
Binary files /dev/null and b/src/site/resources/logo/logo-big-blue-cup-2.10.png differ
http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/c8f4df1b/src/site/resources/logo/logo-big-blue-cup-2.10.xcf
----------------------------------------------------------------------
diff --git a/src/site/resources/logo/logo-big-blue-cup-2.10.xcf b/src/site/resources/logo/logo-big-blue-cup-2.10.xcf
new file mode 100644
index 0000000..0d33bbb
Binary files /dev/null and b/src/site/resources/logo/logo-big-blue-cup-2.10.xcf differ