www-announce mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Ralph Goers <rgo...@apache.org>
Subject [ANNOUNCEMENT] Log4j 2.6 released
Date Sun, 29 May 2016 21:23:38 GMT

              Apache Log4j 2.6 RELEASE NOTES

The Apache Log4j 2 team is pleased to announce the Log4j 2.6 release!

Apache log4j is a well known framework for logging application behavior. Log4j 2 is an upgrade
Log4j that provides significant improvements over its predecessor, Log4j 1.x, and provides
many other modern features such as support for Markers, property substitution using Lookups,
multiple patterns on
a PatternLayout and asynchronous Loggers. In addition, Log4j 2 will not lose events while

This is the tenth GA release. It contains several bugfixes and new features. The new features
the ability to be "garbage-free" (avoid allocating temporary objects) while logging if certain
conditions are met,
a new YAML Layout, the ability to merge configuration files, and documenting Log4j's performance
against other logging
frameworks and in various logging configurations. More details on the features and bugfixes
are itemized below.

Note that subsequent to the release a minor source incompatibility was found due to the addition
of new methods to
the Logger interface. If you have code that does:

logger.error(null, “This is the log message”, throwable);

or similar with any log level you will get a compiler error saying the reference is ambiguous.
 To correct this either do:

logger.error(“This is the log message”, throwable);


logger.error((Marker) null, “This is the log message”, throwable);

Log4j 2.6 maintains binary compatibility with previous releases.

GA Release 2.6

Changes in this version include:

New features:
o LOG4J2-1270:  (GC) Added support for garbage-free logging in steady state.
        This includes Async Loggers and logging synchronously to the console and to a file,
        but does not include the AsyncAppender. This release makes the GelfLayout and
        the main patterns in the PatternLayout garbage-free. 
o LOG4J2-1297:  (GC) Added manual page on garbage-free logging. 
o LOG4J2-1373:  (GC) Update Logger wrapper Generator tool to generate methods for the new
Logger methods. 
o LOG4J2-1326:  (GC) Added methods to the Logger interface for logging CharSequence messages.

o LOG4J2-1344:  (GC) FileAppender, RollingFileAppender and MemoryMappedFileAppender are now
also garbage-free by default. 
o LOG4J2-1278:  (GC) Added unrolled varargs methods to Logger API, added Unbox utility to
avoid auto-boxing when logging primitive values. 
o LOG4J2-1271:  (GC) Add MessageFactory that avoid allocation by reusing a cached ParameterizedMessage
o LOG4J2-1293:  (GC) Add interface StringBuilderFormattable to enable converting Messages
and parameters to text without allocating temporary objects.
        ParameterizedMessage, ObjectMessage, SimpleMessage and ThreadDumpMessage now implement
o LOG4J2-1274:  (GC) Add encode(LogEvent, ByteBufferDestination) method to Layout API to enable
converting LogEvents to bytes without creating temporary objects. 
o LOG4J2-1362:  Added a YAML layout. Thanks to Gary Gregory. 
o LOG4J2-1179:  Documented benchmark results comparing Log4j 2 performance to other logging
o LOG4J2-1011:  Document dependencies for layouts. 
o LOG4J2-621:  Pattern to drop first N package parts. Thanks to Lee Theobald, Kamal Mettananda,
Gary Gregory. 
o LOG4J2-494:  Support merging configurations to for a composite configuration. Thanks to
Philipp Knobel. 
o LOG4J2-1357:  Option to not log stack traces for logged Throwables in GelfLayout. 
o LOG4J2-1348:  Add an AutoCloseable ThreadContext class: CloseableThreadContext. Thanks to
Greg Thomas, Gary Gregory. 
o LOG4J2-1299:  Add pattern converter for thread id and priority in PatternLayout. 
o LOG4J2-124:  Add shutdown methods to LogManager. 
o LOG4J2-1221:  Added async logger Timeout wait strategy and made this the default wait strategy
for async loggers.
        This prevents a rare deadlock that may occur on Solaris. Thanks to Michael Barker.

o LOG4J2-1080:  Added option to discard events below a certain log level if the async logger
ring buffer
        or async appender queue is full. 
o LOG4J2-1237:  Make PatternLayout header and footer accept a pattern. Thanks to Mike Calmus,
Gary Gregory. 
o LOG4J2-1244:  Make header and footer values customizable in JSONLayout. Thanks to Anshu
Garg, Remko Popma, Gary Gregory. 
o LOG4J2-1245:  Make CSV Layout header and footers accept patterns. 
o LOG4J2-1192:  Dynamic Subject for SMTP Appender. Thanks to Jörg Bretschneider, Gary Gregory.

o LOG4J2-1277:  FormattedMessage, MessageFormatMessage and StringFormattedMessage should support
passing in a Locale to ensure appropriate formatting. Thanks to Gary Gregory, Ludovic Hochet.

o LOG4J2-1303:  Add documentation links to runtime dependencies in each component intro page.

o LOG4J2-1252:  JeroMqAppender should support layouts. 
o LOG4J2-1217:  PatternLayout option to limit length of text. Thanks to Thies Wellpott. 
o LOG4J2-1133:  Add JNDI lookup documentation. 
o LOG4J2-1169:  PatternLayout: Possible variable substitution in equals substitution parameter.
Thanks to Gerald Kritzinger. 

Fixed Bugs:
o LOG4J2-1281:  (GC) LoggerConfig.getProperties() should not allocate on each call. 
o LOG4J2-1269:  (GC) AsyncLogger should use thread-local translator by default. 
o LOG4J2-623:  Generate MDC properties as a JSON map in JSONLayout, with option to output
as list of map entries. 
o LOG4J2-1387:  Fixed memory leak related to shutdown hook. 
o LOG4J2-1382:  Copying a MutableLogEvent using Log4jLogEvent.Builder should not unnecessarily
obtain caller location information. 
o LOG4J2-1372:  XMLLayout indents, but not the first child tag (Event). Thanks to Kamal Mettananda,
Gary Gregory. 
o LOG4J2-1363:  Properties Configuration did not support includeLocation attribute on Loggers.

o LOG4J2-1263:  The ConfigurationSource was not saved for BuiltConfigurations so monitor interval
had no effect. 
o LOG4J2-1369:  "xz" compression results in plaintext, uncompressed files. Thanks to Alex
Birch, Gary Gregory. 
o LOG4J2-1368:  (Log4j-internal) StatusLogger dropped exceptions when logging parameterized
o LOG4J2-1336:  LoggerFactory in 1.2 API module is not compatible with 1.2. Thanks to Zbynek
o LOG4J2-1354:  No configuration reload is triggered under Windows when replacing the configuration
file with one that has older last modified date. Thanks to Arkadiusz Adolph. 
o LOG4J2-1346:  Exception from Log4jServletContextListener prevents jetty-maven-plugin run-forked.

o LOG4J2-1339:  (Perf) AsyncLogger performance optimization: avoid calling instanceof TimestampMessage
in hot path. 
o LOG4J2-1324:  Improve error handling in the Async Logger background thread: the new default
exception handler no longer rethrows the error. 
o LOG4J2-1309:  Configuration file error does not show cause exception. 
o LOG4J2-1289:  Change flow logging text from "entry' to "Enter" and "exit" to "Exit". 
o LOG4J2-1284:  Made default MessageFactory configurable. 
o LOG4J2-1280:  Deprecate org.apache.logging.log4j.util.MessageSupplier. 
o LOG4J2-1280:  Logger methods taking Supplier parameters now correctly handle cases where
the supplied value is a Message. 
o LOG4J2-1268:  FixedDateFormat was incorrect for formats having MMM with the French locale.

o LOG4J2-1222:  Creation of a LoggerContext will fail if shutdown is in progress. LogManager
will default to SimpleLogger instead. 
o LOG4J2-1260:  TlsSyslogFrame calculates message length incorrectly. Thanks to Blake Day,
Gary Gregory. 
o LOG4J2-1258:  Async DynamicThresholdFilter does not use the log event's context map. Thanks
to Francis Lalonde. 
o LOG4J2-1232:  Incorrect log rotation in last week of year. Thanks to Nikolai. 
o LOG4J2-1248:  Fixed broken nanotime in pattern layout. 
o LOG4J2-908:  JSONLayout doesn't add a comma between log events. Thanks to Konstantinos Liakos,
Patrick Flaherty, Robin Coe, Gary Gregory. 
o LOG4J2-1230:  Don't concatenate SYSLOG Messages. Thanks to Vladimir Hudec, Ralph Goers,
Gary Gregory. 
o LOG4J2-1238:  org.apache.logging.log4j.core.net.TcpSocketManager and other classes does
not report internal exceptions to the status logger. 
o LOG4J2-1212:  Fix documentation to specify the correct default wait strategy used by async
o LOG4J2-1215:  Documentation/XSD inconsistencies. Thanks to Erik Kemperman. 
o LOG4J2-1276:  LoggerMessageSupplierTest and LoggerSupplierTest are Locale sensitive. Thanks
to Ludovic Hochet. 
o LOG4J2-1251:  Fix JUL bridge issue where LogRecord.getParameters() is used when null. Thanks
to Romain Manni-Bucau. 
o LOG4J2-1254:  Fix typo in Flow Tracing documentation. Thanks to Josh Trow. 
o LOG4J2-920:  ClassNotFoundException for BundleContextSelector when initialising in an OSGi
environment. Thanks to Ludovic Hochet. 
o LOG4J2-1275:  Fix RollingAppenderNoUnconditionalDeleteTest repeat test runs from failing.
Thanks to Ludovic Hochet. 
o LOG4J2-1262:  Stop throwing unnecessary exception in Log4jServletContextListener.contextDestroyed().

o LOG4J2-1227:  NullPointerException in MapLookup.lookup if the event is null. Thanks to Olivier
o LOG4J2-1050:  Add a Log4jLookup class to help write log files relative to log4j2.xml. Thanks
to Adam Retter. 
o LOG4J2-1310:  JndiLookup mindlessly casts to String and should use String.valueOf(). 
o LOG4J2-248:  Log4jWebInitializerImpl: Use Thread instead of Class for fallback classloader.

o LOG4J2-1330:  Fix NoClassDefFoundError in ReflectionUtil on Google App Engine. 

o LOG4J2-1356:  (GC) GelfLayout does now support garabage-free logging (with compressionType=OFF).

o LOG4J2-1343:  (GC) ConsoleAppender is now garbage-free by default. This logic is reusable
for all AbstractOutputStreamAppender subclasses. 
o LOG4J2-1318:  (GC) Avoid allocating unnecessary temporary objects in LoggerContext's getLogger
o LOG4J2-1333:  (GC) Avoid allocating unnecessary temporary objects in MarkerManager's getMarker
o LOG4J2-1321:  (GC) Avoid allocating unnecessary temporary objects in PatternLayout's NamePatternConverter
and ClassNamePatternConverter. 
o LOG4J2-1271:  (GC) ParameterizedMessage optimizations to avoid or at least postpone allocating
temporary objects. 
o LOG4J2-1283:  (GC) Provide ThreadLocal-based gc-free caching mechanism in DatePatternConverter
for non-webapps. 
o LOG4J2-1291:  (GC) Update PatternLayout to utilize gc-free mechanism for LogEvent processing.

o LOG4J2-1292:  (GC) Update RandomAccessFileAppender and RollingRandomAccessFileAppender to
utilize gc-free Layout.encode() method. 
o LOG4J2-1272:  (GC) Improve LoggerConfig's data structure for AppenderControl objects to
avoid allocating temporary objects during
        traversal for each log event. 
o LOG4J2-1375:  Update SLF4J from 1.7.13 to 1.7.21. 
o LOG4J2-1374:  Migrate tests from Logback 1.1.3 to 1.1.7. 
o LOG4J2-1384:  Update Apache Commons CSV from 1.2 to 1.3. 
o LOG4J2-1365:  (Log4j-internal) Provide message text as CharSequence for some message types
to optimize some layouts. 
o LOG4J2-1345:  (Doc) Clarify documentation for properties that control Log4j behaviour. 
o LOG4J2-1255:  Add enhanced entry and exit methods. 
o LOG4J2-1380:  Update Jackson from 2.7.3 to 2.7.4. 
o LOG4J2-1304:  Update Jackson from 2.7.0 to 2.7.2. 
o LOG4J2-1253:  Update LMAX Disruptor from 3.3.2 to 3.3.4. 
o LOG4J2-1219:  Update SLF4J from 1.7.12 to 1.7.13. 
o LOG4J2-1239:  Update Jackson from 2.6.3 to 2.6.4. 
o LOG4J2-1249:  Update Jackson from 2.6.4 to 2.7.0. 
o LOG4J2-1351:  Update Jackson from 2.7.2 to 2.7.3. 
o LOG4J2-1240:  Update Liquibase from 3.3.5 to 3.4.2. 
o LOG4J2-1294:  Update Kafka client from to 
o LOG4J2-1352:  Update javax.mail from 1.5.4 to 1.5.5. 
o LOG4J2-1358:  Update Apache Commons Compress from 1.10 to 1.11. 
o LOG4J2-1388:  Update Google java-allocation-instrumenter from 3.0 to 3.0.1. 
o LOG4J2-1233:  Misleading Value In Properties Example. Thanks to Bahri Gencsoy. 
o LOG4J2-1300:  Remove serializability from classes that don't need it. 
o LOG4J2-1306:  JeroMqAppender should use ShutdownCallbackRegistry instead of runtime hooks.

o LOG4J2-1308:  Remove need to pre-specify appender et al. identifiers in property file config
o LOG4J2-1206:  org.apache.logging.log4j.core.LoggerContext#updateLoggers should call firePropertyChangeEvent.

o LOG4J2-1322:  Update Log4j 1.x migration guide to include information about system property
lookup syntax changes. 

Apache Log4j 2.6 requires a minimum of Java 7 to build and run. Log4j 2.3 was the last release
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:


View raw message