|
| 1 | +//// |
| 2 | + Licensed to the Apache Software Foundation (ASF) under one or more |
| 3 | + contributor license agreements. See the NOTICE file distributed with |
| 4 | + this work for additional information regarding copyright ownership. |
| 5 | + The ASF licenses this file to You under the Apache License, Version 2.0 |
| 6 | + (the "License"); you may not use this file except in compliance with |
| 7 | + the License. You may obtain a copy of the License at |
| 8 | + |
| 9 | + https://www.apache.org/licenses/LICENSE-2.0 |
| 10 | + |
| 11 | + Unless required by applicable law or agreed to in writing, software |
| 12 | + distributed under the License is distributed on an "AS IS" BASIS, |
| 13 | + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 14 | + See the License for the specific language governing permissions and |
| 15 | + limitations under the License. |
| 16 | +//// |
| 17 | + |
| 18 | +[#release-notes-${release.version?replace("[^a-zA-Z0-9]", "-", "r")}] |
| 19 | +== ${release.version} |
| 20 | + |
| 21 | +<#if release.date?has_content>Release date:: ${release.date}</#if> |
| 22 | + |
| 23 | +This release contains improvements and changes in several areas of Apache Log4j: |
| 24 | + |
| 25 | +=== Log4j API |
| 26 | + |
| 27 | +The `2.24.0` version of Log4j API has been enhanced with changes from the 3.x branch and will be used by both Log4j 2 Core and Log4j 3 Core releases. |
| 28 | +The changes include: |
| 29 | + |
| 30 | +* A faster default `ThreadContextMap`. |
| 31 | +* Enhanced GraalVM support: native binaries that use Log4j API will no longer require additional GraalVM configuration. |
| 32 | +* The configuration properties subsystem now only accepts the official pre-2.10 property names and the normalized post-2.10 names. |
| 33 | +Check your configuration for typos. |
| 34 | + |
| 35 | +=== Documentation |
| 36 | + |
| 37 | +The xref:index.adoc[Apache Log4j 2] website has been almost entirely rewritten to provide improved documentation and faster access to the information you need. |
| 38 | + |
| 39 | +=== Bridges |
| 40 | + |
| 41 | +The JUL-to-Log4j API and Log4j 1-to-Log4j API will no longer be able to modify the configuration of Log4j Core by default. |
| 42 | +If such a functionality is required, it must be explicitly enabled. |
| 43 | + |
| 44 | +=== Modules |
| 45 | + |
| 46 | +The following Log4j Core additional modules have been removed: |
| 47 | + |
| 48 | +`log4j-flume-ng`:: |
| 49 | +The module has been moved to the Flume project and follows the Apache Flume release lifecycle. |
| 50 | + |
| 51 | +`log4j-kubernetes`:: |
| 52 | +The module has been moved to the https://github.com/fabric8io/kubernetes-client/blob/main/doc/KubernetesLog4j.md[Fabric8.io Kubernetes project] and follows the Fabric8.io release lifecycle. |
| 53 | + |
| 54 | +`log4j-mongodb3`:: |
| 55 | +The module based on MongoDB Java client version 3.x has been removed. |
| 56 | +Please migrate to `log4j-mongodb` (client version 5.x) or `log4j-mongodb4` (client version 4.x). |
| 57 | + |
| 58 | +=== JMX changes |
| 59 | + |
| 60 | +Starting in version 2.24.0, JMX support is disabled by default and can be re-enabled via the `log4j2.disableJmx=false` system property. |
| 61 | + |
| 62 | +<#include "../.changelog.adoc.ftl"> |
0 commit comments