Google Git
Sign in
apache / logging-log4j-site / c83555f00ebe8967fddd9bc20e8f01bbccf81ea2 / . / 2.x / _release-notes / _2.13.1.html
blob: ab070fffd50f1c60e4449cc1de3d4b2ef6308fe0 [file] [log] [blame]
<!DOCTYPE html>
<!--
| Generated by Apache Maven Doxia Site Renderer 1.11.1 from target/generated-sources/site/asciidoc/_release-notes/_2.13.1.adoc at 2024-03-06
| Rendered using Apache Maven Fluido Skin 1.11.2
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<meta name="generator" content="Apache Maven Doxia Site Renderer 1.11.1" />
<title>Log4j &#x2013; </title>
<link rel="stylesheet" href="../css/apache-maven-fluido-1.11.2.min.css" />
<link rel="stylesheet" href="../css/site.css" />
<link rel="stylesheet" href="../css/print.css" media="print" />
<script src="../js/apache-maven-fluido-1.11.2.min.js"></script>
</head>
<body class="topBarDisabled">
<div class="container-fluid">
<header>
<div id="banner">
<div class="pull-left"><a href="../../.." id="bannerLeft"><img src="../images/ls-logo.jpg" alt="" style="" /></a></div>
<div class="pull-right"><a href=".././" id="bannerRight"><img src="../images/logo.png" alt="" style="" /></a></div>
<div class="clear"><hr/></div>
</div>
<div id="breadcrumbs">
<ul class="breadcrumb">
<li id="publishDate">Last Published: 2024-03-06<span class="divider">|</span>
</li>
<li id="projectVersion">Version: 2.23.1</li>
<li class="pull-right"><span class="divider">|</span>
<a href="https://github.com/apache/logging-log4j2" class="externalLink" title="GitHub">GitHub</a></li>
<li class="pull-right"><span class="divider">|</span>
<a href="../../../" title="Logging Services">Logging Services</a></li>
<li class="pull-right"><span class="divider">|</span>
<a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a></li>
<li class="pull-right"><a href="https://cwiki.apache.org/confluence/display/LOGGING/Log4j" class="externalLink" title="Logging Wiki">Logging Wiki</a></li>
</ul>
</div>
</header>
<div class="row-fluid">
<header id="leftColumn" class="span2">
<nav class="well sidebar-nav">
<ul class="nav nav-list">
<li class="nav-header"><img class="imageLink" src="../img/glyphicons/home.png" alt="Apache Log4j™ 2" style="border: 0;" /> Apache Log4j™ 2</li>
<li><a href="../index.html" title="About"><span class="none"></span>About</a></li>
<li><a href="../download.html" title="Download"><span class="none"></span>Download</a></li>
<li><a href="../support.html" title="Support"><span class="none"></span>Support</a></li>
<li><a href="../maven-artifacts.html" title="Maven, Ivy, Gradle Artifacts"><span class="icon-chevron-right"></span>Maven, Ivy, Gradle Artifacts</a></li>
<li><a href="../release-notes.html" title="Release Notes"><span class="none"></span>Release Notes</a></li>
<li><a href="../faq.html" title="FAQ"><span class="none"></span>FAQ</a></li>
<li><a href="../performance.html" title="Performance"><span class="icon-chevron-right"></span>Performance</a></li>
<li><a href="../articles.html" title="Articles and Tutorials"><span class="none"></span>Articles and Tutorials</a></li>
<li><a href="../security.html" title="Security"><span class="icon-chevron-right"></span>Security</a></li>
<li class="nav-header"><img class="imageLink" src="../img/glyphicons/book.png" alt="Manual" style="border: 0;" /> Manual</li>
<li><a href="../manual/index.html" title="Introduction"><span class="none"></span>Introduction</a></li>
<li><a href="../manual/architecture.html" title="Architecture"><span class="none"></span>Architecture</a></li>
<li><a href="../manual/api-separation.html" title="API Separation"><span class="none"></span>API Separation</a></li>
<li><a href="../manual/migration.html" title="Log4j 1.x Migration"><span class="icon-chevron-right"></span>Log4j 1.x Migration</a></li>
<li><a href="../manual/api.html" title="Java API"><span class="icon-chevron-right"></span>Java API</a></li>
<li><a href="../../kotlin" title="Kotlin API"><span class="none"></span>Kotlin API</a></li>
<li><a href="../../scala" title="Scala API"><span class="none"></span>Scala API</a></li>
<li><a href="../manual/configuration.html" title="Configuration"><span class="icon-chevron-right"></span>Configuration</a></li>
<li><a href="../manual/usage.html" title="Usage"><span class="icon-chevron-right"></span>Usage</a></li>
<li><a href="../manual/webapp.html" title="Web Applications and JSPs"><span class="icon-chevron-right"></span>Web Applications and JSPs</a></li>
<li><a href="../manual/lookups.html" title="Lookups"><span class="icon-chevron-right"></span>Lookups</a></li>
<li><a href="../manual/appenders.html" title="Appenders"><span class="icon-chevron-right"></span>Appenders</a></li>
<li><a href="../manual/layouts.html" title="Layouts"><span class="icon-chevron-right"></span>Layouts</a></li>
<li><a href="../manual/filters.html" title="Filters"><span class="icon-chevron-right"></span>Filters</a></li>
<li><a href="../manual/async.html" title="Async Loggers"><span class="icon-chevron-right"></span>Async Loggers</a></li>
<li><a href="../manual/garbagefree.html" title="Garbage-free Logging"><span class="icon-chevron-right"></span>Garbage-free Logging</a></li>
<li><a href="../manual/jmx.html" title="JMX"><span class="none"></span>JMX</a></li>
<li><a href="../manual/logsep.html" title="Logging Separation"><span class="none"></span>Logging Separation</a></li>
<li><a href="../manual/extending.html" title="Extending Log4j"><span class="icon-chevron-right"></span>Extending Log4j</a></li>
<li><a href="../manual/plugins.html" title="Plugins"><span class="icon-chevron-right"></span>Plugins</a></li>
<li><a href="../manual/customconfig.html" title="Programmatic Log4j Configuration"><span class="icon-chevron-right"></span>Programmatic Log4j Configuration</a></li>
<li><a href="../manual/customloglevels.html" title="Custom Log Levels"><span class="icon-chevron-right"></span>Custom Log Levels</a></li>
<li class="nav-header"><img class="imageLink" src="../img/glyphicons/pencil.png" alt="For Contributors" style="border: 0;" /> For Contributors</li>
<li><a href="../guidelines.html" title="Guidelines"><span class="none"></span>Guidelines</a></li>
<li><a href="../javastyle.html" title="Style Guide"><span class="none"></span>Style Guide</a></li>
<li class="nav-header"><img class="imageLink" src="../img/glyphicons/cog.png" alt="Components" style="border: 0;" /> Components</li>
<li><a href="../log4j-api.html" title="API"><span class="none"></span>API</a></li>
<li><a href="../log4j-jcl.html" title="Commons Logging Bridge"><span class="none"></span>Commons Logging Bridge</a></li>
<li><a href="../log4j-1.2-api.html" title="Log4j 1.2 API"><span class="none"></span>Log4j 1.2 API</a></li>
<li><a href="../log4j-slf4j-impl.html" title="SLF4J Binding"><span class="none"></span>SLF4J Binding</a></li>
<li><a href="../log4j-jul.html" title="JUL Adapter"><span class="none"></span>JUL Adapter</a></li>
<li><a href="../log4j-jpl.html" title="JDK Platform Logger"><span class="none"></span>JDK Platform Logger</a></li>
<li><a href="../log4j-to-slf4j.html" title="Log4j 2 to SLF4J Adapter"><span class="none"></span>Log4j 2 to SLF4J Adapter</a></li>
<li><a href="../log4j-flume-ng.html" title="Apache Flume Appender"><span class="none"></span>Apache Flume Appender</a></li>
<li><a href="../log4j-taglib.html" title="Log4j Tag Library"><span class="none"></span>Log4j Tag Library</a></li>
<li><a href="../log4j-jmx-gui.html" title="Log4j JMX GUI"><span class="none"></span>Log4j JMX GUI</a></li>
<li><a href="../log4j-web.html" title="Log4j Web Application Support"><span class="none"></span>Log4j Web Application Support</a></li>
<li><a href="../log4j-jakarta-web.html" title="Log4j Jakarta Web Application Support"><span class="none"></span>Log4j Jakarta Web Application Support</a></li>
<li><a href="../log4j-appserver.html" title="Log4j Application Server Integration"><span class="none"></span>Log4j Application Server Integration</a></li>
<li><a href="../log4j-couchdb.html" title="Log4j CouchDB appender"><span class="none"></span>Log4j CouchDB appender</a></li>
<li><a href="../log4j-mongodb3.html" title="Log4j MongoDB3 appender"><span class="none"></span>Log4j MongoDB3 appender</a></li>
<li><a href="../log4j-mongodb4.html" title="Log4j MongoDB4 appender"><span class="none"></span>Log4j MongoDB4 appender</a></li>
<li><a href="../log4j-cassandra.html" title="Log4j Cassandra appender"><span class="none"></span>Log4j Cassandra appender</a></li>
<li><a href="../log4j-iostreams.html" title="Log4j IO Streams"><span class="none"></span>Log4j IO Streams</a></li>
<li><a href="../log4j-docker.html" title="Log4j Docker Support"><span class="none"></span>Log4j Docker Support</a></li>
<li><a href="../log4j-kubernetes.html" title="Log4j Kubernetes Support"><span class="none"></span>Log4j Kubernetes Support</a></li>
<li><a href="../log4j-spring-boot.html" title="Log4j Spring Boot"><span class="none"></span>Log4j Spring Boot</a></li>
<li><a href="../log4j-spring-cloud-config-client.html" title="Log4j Spring Cloud Config Client"><span class="none"></span>Log4j Spring Cloud Config Client</a></li>
<li class="nav-header"><img class="imageLink" src="../img/glyphicons/tag.png" alt="Related Projects" style="border: 0;" /> Related Projects</li>
<li><a href="../../../chainsaw/2.x/index.html" title="Chainsaw"><span class="none"></span>Chainsaw</a></li>
<li><a href="../../../log4cxx/latest_stable/index.html" title="Log4Cxx"><span class="none"></span>Log4Cxx</a></li>
<li><a href="../../../log4j-audit/latest/index.html" title="Log4j Audit"><span class="none"></span>Log4j Audit</a></li>
<li><a href="../../kotlin" title="Log4j Kotlin"><span class="none"></span>Log4j Kotlin</a></li>
<li><a href="../../scala" title="Log4j Scala"><span class="none"></span>Log4j Scala</a></li>
<li><a href="../../transform" title="Log4j Transform"><span class="none"></span>Log4j Transform</a></li>
<li><a href="../../../log4net/index.html" title="Log4Net"><span class="none"></span>Log4Net</a></li>
<li class="nav-header"><img class="imageLink" src="../img/glyphicons/link.png" alt="Legacy Sites" style="border: 0;" /> Legacy Sites</li>
<li><a href="../../log4j-2.12.4/" title="Log4j 2.12.4 - Java 7"><span class="none"></span>Log4j 2.12.4 - Java 7</a></li>
<li><a href="../../log4j-2.3.2/" title="Log4j 2.3.2 - Java 6"><span class="none"></span>Log4j 2.3.2 - Java 6</a></li>
<li><a href="../../1.2/" title="Log4j 1.2 - End of Life"><span class="none"></span>Log4j 1.2 - End of Life</a></li>
<li class="nav-header"><img class="imageLink" src="../img/glyphicons/info.png" alt="Project Information" style="border: 0;" /> Project Information</li>
<li><a href="../team.html" title="Project Team"><span class="none"></span>Project Team</a></li>
<li><a href="https://www.apache.org/licenses/LICENSE-2.0" class="externalLink" title="Project License"><span class="none"></span>Project License</a></li>
<li><a href="https://github.com/apache/logging-log4j2" class="externalLink" title="Source Repository"><span class="none"></span>Source Repository</a></li>
<li><a href="../runtime-dependencies.html" title="Runtime Dependencies"><span class="none"></span>Runtime Dependencies</a></li>
<li><a href="../javadoc.html" title="Javadoc"><span class="none"></span>Javadoc</a></li>
<li><a href="../thanks.html" title="Thanks"><span class="none"></span>Thanks</a></li>
</ul>
</nav>
<div class="well sidebar-nav">
<div id="poweredBy">
<div class="clear"></div>
<div class="clear"></div>
<div class="clear"></div>
<a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="../images/logos/maven-feather.png" /></a>
</div>
</div>
</header>
<main id="bodyColumn" class="span10" >
<div class="sect1">
<h2 id="release-notes-2-13-1">2.13.1</h2>
<div class="sectionbody">
<div class="dlist">
<dl>
<dt class="hdlist1">Release date</dt>
<dd>
<p>2020-02-25</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>This release contains bugfixes and minor enhancements.</p>
</div>
<div class="paragraph">
<p>Due to a break in compatibility in the SLF4J binding, Log4j now ships with two versions of the SLF4J to Log4j adapters.
<code>log4j-slf4j-impl</code> should be used with SLF4J 1.7.x and earlier and <code>log4j-slf4j18-impl</code> should be used with SLF4J 1.8.x and later.</p>
</div>
<div class="paragraph">
<p>Note that the XML, JSON and YAML formats changed in the 2.11.0 release: they no longer have the <code>timeMillis</code> attribute and instead have an <code>Instant</code> element with <code>epochSecond</code> and <code>nanoOfSecond</code> attributes.</p>
</div>
<div class="paragraph">
<p>The Log4j 2.13.1 API, as well as many core components, maintains binary compatibility with previous releases.</p>
</div>
<div class="paragraph">
<p>Log4j 2.13.1 requires a minimum of Java 8 to build and run.
Log4j 2.3 was the last release that supported Java 6 and Log4j 2.11.2 is the last release to support Java 7.</p>
</div>
<div class="paragraph">
<p>For complete information on Apache Log4j 2, including instructions on how to submit bug reports, patches, or suggestions for improvement, see <a href="http://logging.apache.org/log4j/2.x/">the Apache Log4j 2 website</a>.</p>
</div>
<div class="sect2">
<h3 id="release-notes-2-13-1-added">Added</h3>
<div class="ulist">
<ul>
<li>
<p>Implement ISO8601_PERIOD_MICROS fixed date format matching ISO8601_PERIOD with support for microsecond precision. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2748">LOG4J2-2748</a>)</p>
</li>
</ul>
</div>
</div>
<div class="sect2">
<h3 id="release-notes-2-13-1-changed">Changed</h3>
<div class="ulist">
<ul>
<li>
<p>Update log4j-slf4j18-impl slf4j version to 1.8.0-beta4 from 1.8.0-alpha2. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2745">LOG4J2-2745</a>)</p>
</li>
<li>
<p>Update dependencies. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2763">LOG4J2-2763</a>)</p>
</li>
<li>
<p>Add a retry count attribute to the KafkaAppender. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2777">LOG4J2-2777</a>)</p>
</li>
<li>
<p>Use LinkedBlockingQueue instead of synchronized collection in StatusConfiguration. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2782">LOG4J2-2782</a>)</p>
</li>
<li>
<p>Conditionally perform status logging calculations in PluginRegistry. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2789">LOG4J2-2789</a>)</p>
</li>
</ul>
</div>
</div>
<div class="sect2">
<h3 id="release-notes-2-13-1-fixed">Fixed</h3>
<div class="ulist">
<ul>
<li>
<p>Rollover fails when file matches pattern but index is too large. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2039">LOG4J2-2039</a>)</p>
</li>
<li>
<p>Allow Lookup keys with leading dashes by using a slash as an escape character. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2211">LOG4J2-2211</a>)</p>
</li>
<li>
<p>Fix lock contention in the classloader using new versions of slf4j without EventData on slf4j logger creation. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2415">LOG4J2-2415</a>)</p>
</li>
<li>
<p>CronExpression.getBeforeTime() would sometimes return incorrect result. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2575">LOG4J2-2575</a>)</p>
</li>
<li>
<p>GraalVM does not allow use of MethodHandles. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2649">LOG4J2-2649</a>)</p>
</li>
<li>
<p>JSON output wrong when using additional fields. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2652">LOG4J2-2652</a>)</p>
</li>
<li>
<p>PluginProcessor should use Messager instead of System.out. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2676">LOG4J2-2676</a>)</p>
</li>
<li>
<p>Rollover handles parallel file deletion gracefully. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2677">LOG4J2-2677</a>)</p>
</li>
<li>
<p>MapMessage.getFormattedMessage() would incorrectly format objects. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2703">LOG4J2-2703</a>)</p>
</li>
<li>
<p>Slow initialization on Windows due to accessing network interfaces. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2717">LOG4J2-2717</a>)</p>
</li>
<li>
<p>PluginCache output is reproducible allowing the annotation processor to produce deterministic results. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2735">LOG4J2-2735</a>)</p>
</li>
<li>
<p>Fix erroneous log4j-jul recursive logger detection resulting in some no-op JUL loggers and 'WARN Recursive call to getLogger' being reported by the status logger. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2739">LOG4J2-2739</a>)</p>
</li>
<li>
<p>Remove unnecessary EventLogger references from log4j-slf4j18-impl due to removal from slf4j. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2744">LOG4J2-2744</a>)</p>
</li>
<li>
<p>ClassLoaderContextSelector was not locating the LoggerContext during shutdown. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2746">LOG4J2-2746</a>)</p>
</li>
<li>
<p>Fix a memory leak using fully asynchronous logging when the queue is full using the 'discard' asynchronous queue full strategy. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2747">LOG4J2-2747</a>)</p>
</li>
<li>
<p>Fix StackLocator.getCallerClass performance in cases where Reflection.getCallerClass is not accessible. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2751">LOG4J2-2751</a>)</p>
</li>
<li>
<p>MutableLogEvent and RingBufferLogEvent avoid StringBuffer and parameter array allocation unless reusable messages are used. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2752">LOG4J2-2752</a>)</p>
</li>
<li>
<p>LoaderUtil.getClassLoaders may discover additional loaders and no longer erroneously returns a result with a null element in some environments. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2754">LOG4J2-2754</a>)</p>
</li>
<li>
<p>Prevent LoggerContext from being garbage collected while being created. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2756">LOG4J2-2756</a>)</p>
</li>
<li>
<p>NullPointerException when using a custom DirectFileRolloverStrategy without a file name. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2758">LOG4J2-2758</a>)</p>
</li>
<li>
<p>RollingFileAppender was not rolling on startup if createOnDemand was set to true. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2759">LOG4J2-2759</a>)</p>
</li>
<li>
<p>Always write header on a new OutputStream. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2760">LOG4J2-2760</a>)</p>
</li>
<li>
<p>[JDBC] MS-SQL Server JDBC driver throws SQLServerException when inserting a null value for a VARBINARY column. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2762">LOG4J2-2762</a>)</p>
</li>
<li>
<p>Warn if pattern is missing on Routes element. Use default route. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2767">LOG4J2-2767</a>)</p>
</li>
<li>
<p>Add multi-parameter overloads to LogBuilder. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2768">LOG4J2-2768</a>)</p>
</li>
<li>
<p>Do not log an error if Files.move does not work. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2769">LOG4J2-2769</a>)</p>
</li>
<li>
<p>Fixed NullPointerException after reconfiguring via JMX. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2770">LOG4J2-2770</a>)</p>
</li>
<li>
<p>NullPointerException after reconfiguring via JMX. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2770">LOG4J2-2770</a>)</p>
</li>
<li>
<p>An error message in RollingFileAppender uses a placeholder for the name but does not specify the name argument in the logging call (<a href="https://issues.apache.org/jira/browse/LOG4J2-2776">LOG4J2-2776</a>)</p>
</li>
<li>
<p>ServletContainerInitializer was obtaining the StatusLogger too soon. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2781">LOG4J2-2781</a>)</p>
</li>
<li>
<p>Counter stuck at 10 and overwriting files when leading zeros used in the file pattern count. (<a href="https://issues.apache.org/jira/browse/LOG4J2-2784">LOG4J2-2784</a>)</p>
</li>
</ul>
</div>
</div>
</div>
</div>
</main>
</div>
</div>
<hr/>
<footer>
<div class="container-fluid">
<div class="row-fluid">
<p align="center">Copyright &copy; 1999-2024 <a class="external" href="https://www.apache.org">The Apache Software Foundation</a>. All Rights Reserved.<br>
Apache Logging, Apache Log4j, Log4j, Apache, the Apache feather logo, and the Apache Logging project logo are trademarks of The Apache Software Foundation.</p>
</div>
</div>
</footer>
<script>
if(anchors) {
anchors.add();
}
</script>
</body>
</html>