www-announce mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Ralph Goers <rgo...@apache.org>
Subject [ANNOUNCEMENT] Apache Log4j2 2.11.0 released
Date Sat, 17 Mar 2018 00:47:35 GMT
The Apache Log4j 2 team is pleased to announce the Log4j 2.11.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 many other modern features 
such as support for Markers, lambda expressions for lazy logging, 
property substitution using Lookups, multiple patterns on a 
PatternLayout and asynchronous 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.

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 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. More details on the new features 
and fixes are itemized below. Note that some tools are not compatible 
with multi-release jars and may fail trying to process class files in 
the META-INF/versions/9 folder. Those errors should be reported to the 
tool vendor.

Note that subsequent to the 2.9.0 release, for security reasons, 
SerializedLayout is deprecated and no longer used as default in the 
Socket and JMS appenders. SerializedLayout can still be used as before, 
but has to be specified explicitly. To retain old behaviour, you have to 
change configuration like:

<Appenders>
   <Socket name="socket" host="localhost" port="9500"/>
</Appenders>
into:

<Appenders>
   <Socket name="socket" host="localhost" port="9500">
     <SerializedLayout/>
   </Socket>
</Appenders>
We do, however, discourage the use of SerializedLayout and recommend 
JsonLayout as a replacement:

<Appenders>
   <Socket name="socket" host="localhost" port="9500">
     <JsonLayout properties="true"/>
   </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.

The Log4j 2.11.0 API, as well as many core components, maintains binary 
compatibility with previous releases with the following exceptions to 
Log4j Core. Log4j 2.11.0 moves code from log4j-core to several new Maven 
modules. Dependencies to other jars that used to be optional in 
log4j-core are now required in the new modules. The code in these 
modules have been repackaged. These changes do not affect your 
configuration files.

The new modules are:

log4j-jdbc-dbc2
     • Group ID: org.apache.logging.log4j
     • Artifact ID: log4j-jdbc-dbc2
     • Old package: org.apache.logging.log4j.core.appender.db.jdbc
     • New package: org.apache.logging.log4j.jdbc.appender

log4j-jpa
     • Group ID: org.apache.logging.log4j
     • Artifact ID: log4j-jpa
     • Old package 1: org.apache.logging.log4j.core.appender.db.jpa
     • New package 1: org.apache.logging.log4j.jpa.appender
     • Old package 2: 
org.apache.logging.log4j.core.appender.db.jpa.converter
     • New package 2: org.apache.logging.log4j.jpa.converter

log4j-mongodb2
     • Group ID: org.apache.logging.log4j
     • Artifact ID: log4j-mongodb2
     • Old package: org.apache.logging.log4j.mongodb
     • New package: org.apache.logging.log4j.mongodb2

log4j-mongodb3
     • Group ID: org.apache.logging.log4j
     • Artifact ID: log4j-mongodb3
     • Old package: org.apache.logging.log4j.mongodb
     • New package: org.apache.logging.log4j.mongodb3

GA Release 2.11.0

Changes in this version include:

New Features
LOG4J2-2253: Add API to enable iterating over message parameters without 
creating temporary objects. Thanks to Carter Kozak.
LOG4J2-1883: 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. Thanks to Anthony Maire.
LOG4J2-2190: Output JSON object for ObjectMessage in JsonLayout. Thanks 
to Franz Wong.
LOG4J2-2191: Made log4j-core a multi-release ("multi-version") jar, 
added log4j-core-java9 module.
LOG4J2-2143: Add missing converters to PatternLayout.
LOG4J2-2160: Add API 
org.apache.logging.log4j.core.lookup.Interpolator.getStrLookupMap().
LOG4J2-2179: The MongoDB Appender should use a keys and values for a 
Log4j MapMessage.
LOG4J2-2180: Add a MongoDbProvider builder for and deprecate 
org.apache.logging.log4j.mongodb.MongoDbProvider.createNoSqlProvider().
LOG4J2-2181: The JDBC Appender should use keys and values from a Log4j 
MapMessage.
LOG4J2-2185: Add a simple JDBC DriverManager-based ConnectionSource that 
uses JDBC's DriverManager#getConnection(String, String, String).
LOG4J2-2186: Add a JDBC ConnectionSource that provides pooling through 
Apache Commons DBCP 2.
LOG4J2-2187: Add a hook for a Connection Source for a JDBC Appender to 
release its resources.
LOG4J2-2203: Add 
org.apache.logging.log4j.core.util.WatchManager#unwatch(File).
LOG4J2-2206: Add method 
org.apache.logging.log4j.core.util.WatchManager.reset(File) and reset().
LOG4J2-2208: Add debug logging to 
org.apache.logging.log4j.mongodb.MongoDbConnection.
Fixed Bugs
LOG4J2-2271: Move module-info.class to META-INF/versions/9 directory.
LOG4J2-2254: Incorrect automatics module name header was being included 
in manifests.
LOG4J2-2247: NullPointerException would occur when header was provided 
to a Layout on RollingRandingAccessFileAppender with 
DirectWriteRolloverStrategy.
LOG4J2-2129: Log4j2 throws NoClassDefFoundError in Java 9 in 
java.util.ServiceLoader. Thanks to Blazej Bucko.
LOG4J2-2158: Fixed bug where ThreadContext map was cleared, resulting in 
entries being only available for one log event. Thanks to Björn Kautler.
LOG4J2-2002: Avoid null attribute values in DefaultConfigurationBuilder. 
Thanks to Paul Burrowes.
LOG4J2-2175: Fix typo in Property Substitution docs. Thanks to Behrang 
Saeedzadeh.
LOG4J2-2163: Allow SortedArrayStringMap to be filtered upon 
deserialization. Fix build error in Java 9 when compiling log4j-core 
test classes.
LOG4J2-2157: Don't create exit message in traceExit(R) when logging is 
disabled. Thanks to Malte Skoruppa.
LOG4J2-2123: DefaultMergeStrategy did not merge filters on loggers 
correctly. Thanks to Jacob Tolar.
LOG4J2-2126: Removed compile-time dependency on Java Management APIs 
from Log4J API module to improve compatibility with Android Platform 
which does not support JMX extensions. Thanks to Oleg Kalnichevski.
LOG4J2-2270: Strings::join, when called with [null] returns "null" 
instead of EMPTY. Thanks to Cyril Martin.
LOG4J2-2276: ConcurrentModificationException from 
org.apache.logging.log4j.status.StatusLogger.<clinit>(StatusLogger.java:71). 
Thanks to Sean Baxter.
LOG4J2-2274: Allow EnvironmentPropertySource to run with a 
SecurityManager that rejects environment variable access. Thanks to 
Sebastien Lannez.
LOG4J2-2279: Allow SystemPropertiesPropertySource to run with a 
SecurityManager that rejects system property access. Thanks to Gary Gregory.
Changes
LOG4J2-2273: Documentation fix in manual page for custom configurations. 
Thanks to Bruno P. Kinoshita.
LOG4J2-2252: Reusable LogEvents now pass the original format string to 
downstream components like layouts and filters. Thanks to Carter Kozak.
LOG4J2-2250: The internal status logger timestamp format is now 
configurable with system property log4j2.StatusLogger.DateFormat.
LOG4J2-2236: Removed unnecessary dependency on jcommander since Log4j 
uses embedded picocli since 2.9.
LOG4J2-2146: Update version of maven bundle plugin to 3.4.0. Convert 
bundle plugin error to a warning.
LOG4J2-2215: Reduce compiler warnings in log4j-api.
LOG4J2-2127: Removed unnecessary threadlocal StringBuilder field from 
MdcPatternConverter. Thanks to Carter Kozak.
LOG4J2-2194: Require Java 9 to compile the log4j-perf module to allow 
benchmarking with Java 9 APIs.
LOG4J2-2193: Update JMH to version 1.19 from 1.1.1.
LOG4J2-2132: Update ZeroMQ's jeromq from 0.4.2 to 0.4.3.
LOG4J2-2165: Update Jackson from 2.9.2 to 2.9.3.
LOG4J2-2184: Update MongoDB driver from 3.0.4 to 3.6.1.
LOG4J2-2197: Document default property value support. Thanks to Fabrice 
Daugan.
LOG4J2-2198: Update MongoDB dependencies from classic to modern.
LOG4J2-2204: 
org.apache.logging.log4j.core.util.WatchManager.getWatchers() should 
pre-allocate its new Map.
LOG4J2-2209: Rename existing MongoDb plugin and related artifacts from 
MongoDb to MongoDb2.
LOG4J2-2210: Fix error log message for Script which says ScriptFile 
instead. Thanks to Björn Kautler.
LOG4J2-2212: Unnecessary contention in 
CopyOnWriteSortedArrayThreadContextMap. Thanks to Daniel Feist, Gary 
Gregory.
LOG4J2-2213: Unnecessary contention in 
GarbageFreeSortedArrayThreadContextMap. Thanks to Daniel Feist, Gary 
Gregory.
LOG4J2-2214: Unnecessary contention in DefaultThreadContextMap. Thanks 
to Daniel Feist, Gary Gregory.
LOG4J2-2182: NullPointerException at 
org.apache.logging.log4j.util.Activator.loadProvider(Activator.java:81) 
in log4j 2.10.0. Thanks to liwenxian2017, Gary Gregory.
LOG4J2-2202: MarkerFilter onMismatch invalid attribute in .properties. 
Thanks to Kilian, Gary Gregory.
LOG4J2-2219: Configuration builder classes should look for "onMismatch", 
not "onMisMatch". Thanks to Kilian, Gary Gregory.
LOG4J2-2205: New module log4j-mongodb3: Remove use of deprecated MongoDB 
APIs and code to the Java driver version 3 API. Thanks to Gary Gregory.
LOG4J2-2188: Split off JPA support into a new module log4j-jpa. Thanks 
to Gary Gregory.
LOG4J2-2229: Update Jackson from 2.9.3 to 2.9.4. Thanks to Gary Gregory.
LOG4J2-2243: Cannot see or copy all of certain JAnsi exception messages 
on Windows due to NUL characters. Thanks to Gary Gregory.
LOG4J2-2245: Update Apache Commons Compress from 1.15 to 1.16.1. Thanks 
to Gary Gregory.
LOG4J2-2259: Update MongoDB 3 module from driver 3.6.1 to 3.6.3.
LOG4J2-2260: [SMTP] Update javax.mail from 1.6.0 to 1.6.1.
LOG4J2-2264: Update JAnsi from 1.16 to 1.17.

Apache Log4j 2.11.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 does not implement some of the very implementation 
specific classes and methods. The package names and Maven groupId have 
been changed to org.apache.logging.log4j to avoid any conflicts with 
log4j 1.x.

For complete information on Apache Log4j 2, including instructions on 
how to submit bug reports, patches, or suggestions for improvement, see 
the Apache Apache Log4j 2 website:

https://logging.apache.org/log4j/2.x/



Mime
View raw message