_posts/2019-12-16-log4j2-2-13-0-released.html

---
layout: post
status: PUBLISHED
published: true
title: LOG4J2 2.13.0 Released
id: d07d458d-11fc-447b-bcf6-5d15196a79dd
date: '2019-12-16 01:47:16 -0500'
categories: logging
tags:
- log4j2
permalink: logging/entry/log4j2-2-13-0-released
---
<p>The Apache Log4j 2 team is pleased to announce the Log4j 2.13.0 release!</p>
<p>Apache Log4j is a well known framework for logging application behavior. Log4j 2 is an upgrade<br />
to Log4j that provides significant improvements over its predecessor, Log4j 1.x, and provides<br />
many other modern features such as support for Markers, lambda expressions for lazy logging,<br />
property substitution using Lookups, multiple patterns on a PatternLayout and asynchronous<br />
Loggers. Another notable Log4j 2 feature is the ability to be "garbage-free" (avoid allocating<br />
temporary objects) while logging. In addition, Log4j 2 will not lose events while reconfiguring.</p>
<p>The artifacts may be downloaded from <a href="https://logging.apache.org/log4j/2.x/download.html">https://logging.apache.org/log4j/2.x/download.html</a>.</p>
<p>This release contains bugfixes and minor enhancements. Some of the new features in this release are:</p>
<ol>
<li>Log4j 2 now requires Java 8 or higher to build and run.</li>
<li>Experimental support for Log4j 1 configuration files. See<br />
<a href="https://logging.apache.org/log4j/2.x/manual/compatibility.html">Log4j 2 Compatiblity with Log4j 1</a>.</li>
<li>The Logger API has been enhanced to support a builder pattern. This can dramatically improve the overhead of<br />
capturing location information. See <a href="https://logging.apache.org/log4j/2.x/manual/logbuilder.html">Log Builder</a>.</li>
<li>Better integration with Spring Boot by providing access to Spring variables in Log4j 2 configuration files and<br />
allowing Log4j 2 system properties to be defined in the Spring configuration.<br />
See <a href="https://logging.apache.org/log4j/2.x/manual/cloud.html#Managing_Logging_Configuration">Logging in the Cloud</a>.</li>
<li>Support for accessing Kubernetes information via a Log4j 2 Lookup.</li>
<li>The Gelf Layout now allows the message to be formatted using a PatternLayout pattern.<br />
<a href="https://logging.apache.org/log4j/2.x/manual/cloud.html#Log4j_Configuration">Logging in the Cloud</a> provides an example of this, as well<br />
as the use of the Spring and Kubernetes Lookups.</li>
</ol>
<p>Due to a break in compatibility in the SLF4J binding, Log4j now ships with two versions of the SLF4J to Log4j adapters.<br />
log4j-slf4j-impl should be used with SLF4J 1.7.x and earlier and log4j-slf4j18-impl should be used with SLF4J 1.8.x and<br />
later.</p>
<p>Note that the XML, JSON and YAML formats changed in the 2.11.0 release: they no longer have the "timeMillis" attribute<br />
and instead have an "Instant" element with "epochSecond" and "nanoOfSecond" attributes.</p>
<p>The Log4j 2.13.0 API, as well as many core components, maintains binary compatibility with previous releases.</p>
<h2><a id="user-content-ga-release-2130" class="anchor" aria-hidden="true" href="#ga-release-2130"><svg class="octicon octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">
<path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>GA Release 2.13.0</h2>
<p>Changes in this version include:</p>
<h3><a id="user-content-new-features" class="anchor" aria-hidden="true" href="#new-features"><svg class="octicon octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">
<path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>New Features</h3>
<ul>
<li><a href="https://issues.apache.org/jira/browse/LOG4J2-2732" rel="nofollow">LOG4J2-2732</a>:<br />
Add ThreadContext.putIfNotNull method. Thanks to Matt Pavlovich.</li>
<li><a href="https://issues.apache.org/jira/browse/LOG4J2-2731" rel="nofollow">LOG4J2-2731</a>:<br />
Add a Level Patttern Selector.</li>
<li><a href="https://issues.apache.org/jira/browse/LOG4J2-63" rel="nofollow">LOG4J2-63</a>:<br />
Add experimental support for Log4j 1 configuration files.</li>
<li><a href="https://issues.apache.org/jira/browse/LOG4J2-2716" rel="nofollow">LOG4J2-2716</a>:<br />
Add the ability to lookup Kubernetes attributes in the Log4j configuration. Allow Log4j properties to<br />
be retrieved from the Spring environment if it is available.</li>
<li><a href="https://issues.apache.org/jira/browse/LOG4J2-2710" rel="nofollow">LOG4J2-2710</a>:<br />
Allow Spring Boot application properties to be accessed in the Log4j 2 configuration. Add<br />
lower and upper case Lookups.</li>
<li><a href="https://issues.apache.org/jira/browse/LOG4J2-2639" rel="nofollow">LOG4J2-2639</a>:<br />
Add builder pattern to Logger interface.</li>
</ul>
<h3><a id="user-content-fixed-bugs" class="anchor" aria-hidden="true" href="#fixed-bugs"><svg class="octicon octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">
<path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Fixed Bugs</h3>
<ul>
<li><a href="https://issues.apache.org/jira/browse/LOG4J2-2058" rel="nofollow">LOG4J2-2058</a>:<br />
Prevent recursive calls to java.util.LogManager.getLogger().</li>
<li><a href="https://issues.apache.org/jira/browse/LOG4J2-2725" rel="nofollow">LOG4J2-2725</a>:<br />
LOG4J2-2725 - Added try/finally around event.execute() for RingBufferLogEventHandler to clear memory<br />
correctly in case of exception/error Thanks to Dzmitry Anikechanka.</li>
<li><a href="https://issues.apache.org/jira/browse/LOG4J2-2635" rel="nofollow">LOG4J2-2635</a>:<br />
Wrong java version check in ThreadNameCachingStrategy. Thanks to Filipp Gunbin.</li>
<li><a href="https://issues.apache.org/jira/browse/LOG4J2-2674" rel="nofollow">LOG4J2-2674</a>:<br />
Use a less confusing name for the CompositeConfiguration source. Thanks to Anton Korenkov.</li>
<li><a href="https://issues.apache.org/jira/browse/LOG4J2-2727" rel="nofollow">LOG4J2-2727</a>:<br />
Add setKey method to Kafka Appender Builder. Thanks to Cl&eacute;ment Mathieu.</li>
<li><a href="https://issues.apache.org/jira/browse/LOG4J2-2707" rel="nofollow">LOG4J2-2707</a>:<br />
ArrayIndexOutOfBoundsException could occur with MAC address longer than 6 bytes. Thanks to Christian Frank.</li>
<li><a href="https://issues.apache.org/jira/browse/LOG4J2-2712" rel="nofollow">LOG4J2-2712</a>:<br />
The rolling file appenders would fail to compress the file after rollover if the file name matched the<br />
file pattern.</li>
<li><a href="https://issues.apache.org/jira/browse/LOG4J2-2693" rel="nofollow">LOG4J2-2693</a>:<br />
@PluginValue does not support attribute names besides "value".</li>
<li><a href="https://issues.apache.org/jira/browse/LOG4J2-2647" rel="nofollow">LOG4J2-2647</a>:<br />
Validation blocks definition of script in properties configuration.</li>
<li><a href="https://issues.apache.org/jira/browse/LOG4J2-2680" rel="nofollow">LOG4J2-2680</a>:<br />
Set result of rename action to true if file was copied. Thanks to Guillermo Xavier Hurtado Garcia.</li>
<li><a href="https://issues.apache.org/jira/browse/LOG4J-2672" rel="nofollow">LOG4J-2672</a>:<br />
Add automatic module names where missing. Thanks to Stephen Colebourne.</li>
<li><a href="https://issues.apache.org/jira/browse/LOG4J2-2673" rel="nofollow">LOG4J2-2673</a>:<br />
OutputStreamAppender.Builder ignores setFilter(). Thanks to Yuichi Sugimura.</li>
<li><a href="https://issues.apache.org/jira/browse/LOG4J2-2725" rel="nofollow">LOG4J2-2725</a>:<br />
Prevent a memory leak when async loggers throw errors. Thanks to Dzmitry Anikechanka.</li>
</ul>
<h3><a id="user-content-changes" class="anchor" aria-hidden="true" href="#changes"><svg class="octicon octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true">
<path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Changes</h3>
<ul>
<li><a href="https://issues.apache.org/jira/browse/LOG4J2-2701" rel="nofollow">LOG4J2-2701</a>:<br />
Update Jackson to 2.9.10.</li>
<li><a href="https://issues.apache.org/jira/browse/LOG4J2-2709" rel="nofollow">LOG4J2-2709</a>:<br />
Allow message portion of GELF layout to be formatted using a PatternLayout. Allow<br />
ThreadContext attributes to be explicitly included or excluded in the GelfLayout.</li>
</ul>
<hr>
<p>Apache Log4j 2.13.0 requires a minimum of Java 8 to build and run. Log4j 2.3 was the<br />
last release that supported Java 6 and Log4j 2.11.2 is the last release to support Java 7.</p>
<p>For complete information on Apache Log4j 2, including instructions on how to submit bug<br />
reports, patches, or suggestions for improvement, see the Apache Apache Log4j 2 website:</p>
<p><a href="https://logging.apache.org/log4j/2.x/" rel="nofollow">https://logging.apache.org/log4j/2.x/</a></p>