log4j Changelog

What's new in log4j 2.1

Nov 27, 2014
  • Some typo fixes and enhancements for the site. Fixes LOG4J2-676.
  • Add Add ShutdownCallbackRegistry interface for customizable shutdown callback handling. This is particularly useful for application servers that wish to integrate with Log4j 2. Fixes LOG4J2-868.
  • Fix Documentation: fixed missing closing parenthesis in code example. Fixes LOG4J2-866.
  • Fix Fixed classloader issue that prevented Log4j from finding the implementation when used in a custom Ant task. Fixes LOG4J2-862.
  • Add Supported filtering on custom log levels in configuration. Fixes LOG4J2-589.
  • Fix Documentation: fix broken links on left navigation Extending Log4j Configuration sub-menu. Fixes LOG4J2-861.
  • Add Documentation: add sections on the JUL Adapter, IO Streams and NoSQL Appenders to the Maven and Ivy page. Fixes LOG4J2-856.
  • Fix Documentation: clarified why log4j-core is a compile time dependency in Maven and Ivy page. Fixes LOG4J2-797.
  • Fix Documentation: fix broken links on Appenders manual page. Fixes LOG4J2-855.
  • Fix Prevent NPE when configuration with AsyncLogger/AsyncRoot is reloaded. Fixes LOG4J2-807.
  • Add Add a Java lookup to provide nicely formatted runtime version information. Fixes LOG4J2-848.
  • Add Move reflection utility class to API's private utility classes. Fixes LOG4J2-809.
  • Update Add 2.1.0 to compatible versions in Log4j API ProviderUtil and update Log4jAPIVersion to 2.1.0 in core META-INF/log4j-provider.properties. Fixes LOG4J2-845.
  • Add Documentation: added Runtime Dependencies link to left nav-bar on site. Fixes LOG4J2-833.
  • Add Documentation: added section on XInclude to user manual Configuration page. Fixes LOG4J2-816.
  • Fix Documentation: fixed minor issues with Log4j2 web site/documentation. Fixes LOG4J2-678. Thanks to Matt Sicker.
  • Update Update JMH to 1.1 from 0.7.2. Fixes LOG4J2-844.
  • Fix Migrate JpaHyperSqlAppenderTest JUnit performance test to log4j-perf. Fixes LOG4J2-843.
  • Fix Migrate JpaH2AppenderTest JUnit performance test to log4j-perf. Fixes LOG4J2-842.
  • Fix Migrate JdbcHyperSqlAppenderTest JUnit performance test to log4j-perf. Fixes LOG4J2-841.
  • Fix Migrate JdbcH2AppenderTest JUnit performance test to log4j-perf. Fixes LOG4J2-840.
  • Fix Respect external interrupt signal to allow application shutdown after joining AsyncAppender thread. Fixes LOG4J2-830.
  • Fix MarkerManager Log4jMarker.hasParents() returns opposite of correct result. Fixes LOG4J2-813.
  • Fix Documentation: fixed capitalization inconsistency in user manual example config. Fixes LOG4J2-785.
  • Fix Fixed issue in RollingFile filePattern: backslashes are path separators, not escape characters. Fixes LOG4J2-829.
  • Add Add the Log4j IOStreams component. Fixes LOG4J2-547.
  • Add Added Memory-Mapped File Appender. Fixes LOG4J2-431.
  • Fix ThrowableProxy fails if a class in logged stack trace throws java.lang.Error from initializer Fixes LOG4J2-832. Thanks to Seth Leger.
  • Update Documentation: updated FAQ "which jars" diagrams for JUL bridge and 2.1 version. Fixes LOG4J2-831.
  • Add Support use of TypeConverter classes through the standard Plugin system. Fixes LOG4J2-827.
  • Fix Avoid ConverterKey plugin clashes by using a more predictable plugin loading infrastructure. Plugins have been segmented into three parts: class path, user-specified packages, and OSGi bundles. Fixes LOG4J2-745.
  • Fix Fixed plugin scanning redundancy causing massive slowdowns in certain environments. Fixes LOG4J2-798.
  • Fix Reduced CachedClock thread contention. Fixes LOG4J2-753.
  • Fix Fixed memory leak in Tomcat 6 caused by clock background threads unintentionally started by Tomcat after web application stop. Fixes LOG4J2-819.
  • Add Add simple validation constraint annotations for the Plugin system. Fixes LOG4J2-825.
  • Add Implement a GELF layout. Fixes LOG4J2-428.
  • Fix FlumePersistentManager now handles LockConflictExceptions in Berkeley Db when sending a batch. Fixes LOG4J2-391.
  • Fix Remove invalid Oracle Maven repository. Fixes LOG4J2-782.
  • Update Update Spring Framework to 3.2.11.RELEASE from 3.2.8.RELEASE. Fixes LOG4J2-780.
  • Update Unify the two JMS appenders into a single appender. Configurations written for 2.0 will still work in 2.1+. Fixes LOG4J2-815.
  • Add Add java.util.logging implementation based on log4j-api. See log4j-jul documentation for more details. Fixes LOG4J2-608.
  • Fix Fixed issue where log4j-to-slf4j did not work correctly with SLF4J Simple Logger. Fixes LOG4J2-796.
  • Fix SimpleLogger throws ArrayIndexOutOfBoundsException for an empty array. Fixes LOG4J2-811.
  • Fix Fix OSGi Import-Package problem with the JMS API. Fixes LOG4J2-663.
  • Add Add support for custom SLF4J Markers in log4j-slf4j-impl module. Fixes LOG4J2-793.
  • Fix PatternLayout should use platform character encoding by default, not UTF-8. Fixes LOG4J2-783.
  • Add Add lookup for application main arguments. Fixes LOG4J2-771.
  • Add Add lookup for JVM arguments. Fixes LOG4J2-787.
  • Update Update Jackson to 2.4.2 from 2.4.1 (for XML and JSON processing). Fixes LOG4J2-790.
  • Update Incomplete documentation for JSONLayout. Fixes LOG4J2-766.
  • Update All life cycle implementations should be serializable. This is still work in progress. Fixes LOG4J2-800.
  • Update org.apache.logging.log4j.core.Logger should be serializable. This is still work in progress. Fixes LOG4J2-801.
  • Update Update javax.mail to 1.5.2 from 1.5.0. Fixes LOG4J2-810.
  • Update Update org.eclipse.persistence.jpa to 2.5.2 from 2.5.1. Fixes LOG4J2-822.
  • Update FlumeAppender: maxDelay not in seconds, but milliseconds. Add time scale to some settings, for example maxDelayMillis instead of maxDelay. The old names are aliased for compatibility. Fixes LOG4J2-867.

New in log4j 2.0.2 (Nov 27, 2014)

  • Update Apache Flume to 1.5.0.1 from 1.5.0. Fixes LOG4J2-775.
  • Fix Site: log4j-core component pages were still using the old logo. Fixes LOG4J2-773.
  • Fix Documentation improvement: link to dependency tree from log4j-core component page, link to log4j-core component page from FAQ page. Fixes LOG4J2-760.
  • Fix Resolved race condition that caused log file rotation to fail with error: "Unable to create directory ..." Fixes LOG4J2-679.
  • Fix Prevent application from hanging when PatternLayout configuration has opening '{' but no closing '}'. Fixes LOG4J2-726.
  • Fix Startup takes a long time if you have empty packages attribute. Fixes LOG4J2-769.
  • Fix Improved asynchronous loggers and appenders to ensure the formatted message does not change even if parameters are modified by the application. (ParameterizedMessage was already safe.) Improved documentation. Fixes LOG4J2-763.
  • Fix Emit warning message to console if no configuration file found. Fixes LOG4J2-729.
  • Fix Improve warning message when missing log4j-core in the classpath. Fixes LOG4J2-765.
  • Fix Clarified in documentation that Commons Logging jar is required when using log4j-jcl. Fixes LOG4J2-722.
  • Fix Clarified in documentation that SLF4J API jar is required when using log4j-slf4j-impl. Fixes LOG4J2-723.
  • Update Allow Log4jContextFactory subclasses to specify a custom ContextSelector. Fixes LOG4J2-730.
  • Fix Fixed various minor site/documentation issues, mostly versioning related. Fixes LOG4J2-759.
  • Fix Prevent JUnit test from creating unnecessary Log4j2Plugins.dat during build. Fixes LOG4J2-756.

New in log4j 2.0.1 (Nov 27, 2014)

  • Avoid unnecessary Clock calls when TimestampMessage is logged. Fixes LOG4J2-744.
  • Fix Improved error message if configuration file not found. Fixes LOG4J2-704.
  • Fix Webapp configuration page has incorrect class name. Fixes LOG4J2-750.
  • Fix Retain the default date pattern after fixing the ISO8601 pattern. Fixes LOG4J2-749.
  • Fix DatePatternConverter ISO8601_PATTERN now conforms to ISO8601. Fixes LOG4J2-670.
  • Fix Reinstate the package configuration attribute for discovering custom plugins. Fixes LOG4J2-741.
  • Fix XInclude not working with relative path. Fixes LOG4J2-742.
  • Fix Fixed typo in webapp manual regarding sample web.xml file. Fixes LOG4J2-740.
  • Fix RollingFileManager deadlock if async action thread fails to start. Fixes LOG4J2-738.
  • Fix Fixed log4j-bom so that it won't specify a default scope on any third party dependencies. Fixes LOG4J2-736.
  • Fix Fixed log4j-bom so that it won't interfere with spring-bom and others. Fixes LOG4J2-735.
  • Fix Updated documentation regarding extensions to LoggerContextFactory and Log4j 2 providers. Fixes LOG4J2-731.
  • Fix Fixed ClassLoader issues in loading Log4j providers in an OSGi environment. Fixes LOG4J2-373.
  • Add Added WebLoggerContextUtils class to log4j-web for helper methods useful for asynchronous servlets. Fixes LOG4J2-725.
  • Add Added documentation for Custom Levels and Custom Loggers. Fixes LOG4J2-710.
  • Fix Correctly handle NetworkOnMainThreadException thrown on Android during Log4j2 initialization. Fixes LOG4J2-719.
  • Fix Automatically disable log4j JMX when detecting we are running on Android. Fixes LOG4J2-716.
  • Fix Fixed AbstractDatabaseManager to close connection on writeInternal error. Fixes LOG4J2-657.
  • Fix Android: java.lang.VerifyError: org/apache/logging/log4j/core/util/Closer Fixes LOG4J2-713.
  • Fix Android: Could not find class 'javax.naming.InitialContext', referenced from method org.apache.logging.log4j.core.lookup.JndiLookup.lookup. Fixes LOG4J2-703.
  • Update to LMAX Disruptor 3.3.0 from 3.2.1. Fixes LOG4J2-732.
  • Update to latest Jackson jars from the 2.4.1.X line. Fixes LOG4J2-733.

New in log4j 2.0 (Nov 27, 2014)

  • Fixed issue where Async Logger does not log thread context stack data. API change: added method getImmutableStackOrNull() to ThreadContext.ContextStack interface. Fixes LOG4J2-705.
  • Fix Update docs to clarify how to use formatter logger and standard logger together. Fixes LOG4J2-631.
  • Add Added support for generating custom logger wrappers that replace the existing log levels and extended logger wrappers that add custom log levels to the existing ones. Fixes LOG4J2-519.
  • Fix LoggerConfigs with no Level now inherit the Level from their parent. Fixes LOG4J2-441.
  • Add RegexFilter does not match multiline log messages. Fixes LOG4J2-696.
  • Fix PatternLayout manual page missing documentation on header/footer. Fixes LOG4J2-699.
  • Fix Fixed Serialization error with SocketAppender and Async Loggers. (Fixed in RC2, but wasn't included in release notes.) Fixes LOG4J2-625.
  • Fix JMX GUI: fixed occasional ArrayIndexOutOfBoundsException after pressing "reconfigure with XML below". (Fixed in RC2, but wasn't included in release notes.) Fixes LOG4J2-538.
  • Fix AsyncLoggerContextSelector should ensure that different AsyncLoggerContext objects created by web app classloaders have unique names. Fixes LOG4J2-666.
  • Fix Fix annotation processor warnings on JDK 1.7+. Fixes LOG4J2-683. Thanks to Jurriaan Mous.
  • Fix Fix strange compilation error that popped up in a test class. Fixes LOG4J2-694.
  • Fix Update documentation to specify only Maven 3 is supported. Fixes LOG4J2-692.
  • Fix Log4j Web test dependencies should be in scope "test" in the pom. Fixes LOG4J2-690. Thanks to Philip Helger.
  • Fix Special characters (tab and so on) in PatternLayout do not work. Fixes LOG4J2-682. Thanks to Scott Harrington.
  • Update Make org.apache.logging.log4j.core.layout.AbstractLayout immutable. Fixes LOG4J2-685.
  • Fix Core's OptionConverter support for \b is broken (affects PatternLayout). Fixes LOG4J2-686.
  • Fix Rename org.apache.logging.log4j.core.util.Closer.closeSilent() to closeSilently(). Fixes LOG4J2-687.
  • Fix Make org.apache.logging.log4j.core.layout.PatternLayout immutable. Fixes LOG4J2-688.
  • Update Update Jackson to 2.4.1. Fixes LOG4J2-689.
  • Fix Some exceptions are not logged when configuration problems are detected. Fixes LOG4J2-707.
  • Update Update Apache Commons Logging to 1.2 from 1.1.3. Fixes LOG4J2-709.

New in log4j 2.0 RC 2 (Nov 27, 2014)

  • RollingFile and RollingRandomAccessFile now write the layout footer before rollover. Fixes LOG4J2-675.
  • Fix RollingRandomAccessFile now writes the layout header after rollover. Fixes LOG4J2-581. Thanks to Alexander Khokhlov.
  • Fix RollingFileManager now correctly honours the bufferedIO configuration after rollover. Fixes LOG4J2-622. Thanks to Farooq Khan.
  • Add Made RollingFileAppender buffer size configurable. Fixes LOG4J2-674.
  • Fix Improved documentation regarding log4j status logger. Fixes LOG4J2-141. Thanks to Joern Huxhorn.
  • Fix Fixed issue with "Reconfigure using XML below" function in JMX Client GUI. ConfigurationSource is now a top-level class and can be obtained with Configuration.getConfigurationSource(). LoggerContext.getConfiguration().getConfigurationSource() provides a reliable public method for obtaining a logger context's configuration location and content. Fixes LOG4J2-539. Thanks to Colin Froggatt.
  • Fix Invalid XML configuration files do not prevent the config file from being checked again. Fixes LOG4J2-619. Thanks to Scott Harrington.
  • Fix JMX: Updating a Logger's level via jConsole now correctly takes effect. Fixes LOG4J2-637. Thanks to Mansoor Sajjad, Jon Wilmoth.
  • Fix Correctly process log events when combining AsyncLoggers with AsyncAppender. Fixes LOG4J2-668.
  • Fix Prevent NPE when combining AsyncLoggers with AsyncLoggerConfigs. Fixes LOG4J2-669.
  • Add Create an appender to route log events to the ServletContext log. Fixes LOG4J2-42.
  • Update Support default value for missing key in look ups with fallbacking to looking in the properties map. Fixes LOG4J2-419. Thanks to Woonsan Ko.
  • Fix FlumeAvroManager now always uses a client type of default_failover. Fixes LOG4J2-563. Thanks to Michael Friedmann.
  • Update Allow configuration files to be located as Servlet Context resources. Fixes LOG4J2-554.
  • Fix Reset rollover time when size rollover is triggered. Fixes LOG4J2-535.
  • Fix Moved plugin cache file to META-INF for OSGi compatibility. Fixes LOG4J2-664.
  • Fix Fix NPE that can be caused by a null ThreadContextClassLoader. Fixes LOG4J2-640.
  • Add Add Vagrantfile for testing in GNU+Linux. Fixes LOG4J2-655.
  • Fix Log4j 2 throws ArrayIndexOutOfBoundsException. Fixes LOG4J2-651.
  • Add Add log4j-perf module to provide a home for all log4j performance tests. Add support for JMH microbenchmark performance tests. Fixes LOG4J2-654.
  • Add Add support for default plugin values and attributes. Fixes LOG4J2-652.
  • Add Add support for types other than String for plugin factory values/attributes. Fixes LOG4J2-598.
  • Update Refactor Log4jLogEvent to lazily create ThrowableProxy. Fixes LOG4J2-250.
  • Update Upgrade to Flume 1.5.0. Fixes LOG4J2-647.
  • Add Implement a SecureSocketAppender and secure server (SSL/TLS). Fixes LOG4J2-644.
  • Update Merge the TLS Syslog appender into the Syslog appender. Fixes LOG4J2-646.
  • Fix Perform reconfiguration in a separate thread to prevent deadlocks. Fixes LOG4J2-620.
  • Update Override commons-logging dependency version in tests. Fixes LOG4J2-641.
  • Fix Prevent NPE in AsyncLogger and AsyncLoggerConfig if logger is used after log4j has been shut down. Fixes LOG4J2-639. Thanks to Mck SembWever.
  • Fix FailoverAppender was not resetting its status after the primary appender recovered. Fixes LOG4J2-469.
  • Fix Generate MDC properties as a JSON map in JSONLayout. Fixes LOG4J2-623.
  • Update Made RollingRandomAccessFileAppender buffer size configurable. Fixes LOG4J2-566. Thanks to Luigi Alice.
  • Fix Resolved issue where AsyncAppender dropped events if queue still contained events when application is stopped. Fixes LOG4J2-520. Thanks to JavaTech, Andre Bogus.
  • Fix Resolved a problem with the previous solution for LOG4J2-392 that resulted in dropped events when using AsyncLoggerConfig with slow appenders when application is stopped. Fixes LOG4J2-392. Thanks to Andre Bogus.
  • Fix The OSGi version of log4j-web imports Servlet 2.5 at minimum instead of 3.0. Fixes LOG4J2-613.
  • Fix Unit tests are now less verbose during the build process. Fixes LOG4J2-602.
  • Fix Fix shutdown thread memory leak in servlet containers. Fixes LOG4J2-570.
  • Update Use Clock to generate all log event timestamps, not just for Async Loggers. Fixes LOG4J2-628.
  • Add Document the system properties used in Log4J 2. Fixes LOG4J2-629.
  • Fix Make Throwable transient in ThrowableProxy. Fixes LOG4J2-542.
  • Update Update SLF4J to 1.7.7. Fixes LOG4J2-617.
  • Update Update Jackson to 2.3.3. Fixes LOG4J2-616.
  • Fix During shutdown, a NullPointerException could be thrown due to the NullConfiguration class no longer being available to the ClassLoader. Fixes LOG4J2-440.
  • Fix Cyclic dependency with log4j-slf4j-impl in OSGi. Fixes LOG4J2-346.
  • Fix The log4j-1.2-api module didn't export any packages to OSGi. Fixes LOG4J2-345.
  • Fix Password data from the NoSQL plugins no longer shows up in cleartext in debug logging. Fixes LOG4J2-605.
  • Fix A StringIndexOutOfBounds exception could occur during property substitution. Fixes LOG4J2-448. Thanks to X86core.
  • Fix StatusLogger was not skipping multiple instances of the FQCN class, causing messages from classes in the Verbose list to be printed. Fixes LOG4J2-597.
  • Update Add support for multiple parents to Markers. Fixes LOG4J2-585. Thanks to Bruce Brouwer.
  • Add Introduce Java annotation processor as the new plugin pre-caching mechanism. This is available in log4j-core. All custom plugins created before this should be re-built against the current log4j-core. Fixes LOG4J2-595.
  • Fix Renamed SLF4J logger class to Log4jLogger. Fixes LOG4J2-564.
  • Fix Rework Level comparison APIs. Fixes LOG4J2-579.
  • Add Add org.apache.logging.log4j.Logger.getLevel(). Fixes LOG4J2-576.
  • Update Make Blocking the default WaitStrategy for Async Loggers. Fixes LOG4J2-574.
  • Update Introduce ExtendedLogger interface to facilitate implementing and extending Loggers. Fixes LOG4J2-555. Thanks to Bruce Brouwer.
  • Fix SyslogAppenderTest and RFC5424LayoutTest were failing in Java 8. Fixes LOG4J2-560.
  • Update Allow spaces around commas in Configuration's package attribute. Fixes LOG4J2-561. Thanks to vibin.
  • Update Have Logger API expose a PrintWriter instead of custom LoggerStream. Fixes LOG4J2-547. Thanks to Bruce Brouwer.
  • Add Add EncodingPatternConverter to escape newlines and HTML special characters. Fixes LOG4J2-439. Thanks to Bruce Brouwer.
  • Update Allow header and footer to be specified as lookup patterns in PatternLayout. Fixes LOG4J2-496.
  • Fix Add equals and hashcode to Log4jLogEvent. Fixes LOG4J2-499.
  • Update SLf4JLogger is now Serializable. Fixes LOG4J2-410. Thanks to Ivlin Zeng.
  • Add Add support for configuration via YAML. Fixes LOG4J2-427. Thanks to Alexander Reelsen.
  • Fix Add DateLookup and ThreadContextLookup to default lookups. Fixes LOG4J2-378.
  • Update Add support to add a LoggerConfig. Document two ways to modify the configuration. Fixes LOG4J2-468.
  • Update Rename org.apache.logging.log4j.core.net.SocketServer to TCPSocketServer and refactor with UDP. Fixes LOG4J2-582.
  • Update Update Jackson to 2.3.2 from 2.2.2. Fixes LOG4J2-592.

New in log4j 2.0 RC 1 (Nov 27, 2014)

  • Removed the DataSourceConnectionSource and the plugin for the JDBC Appender. It is not safe to use. Please use the DataSource or factory connection sources backed by a connection pool.
  • Update Renamed the org.apache.logging.log4j.core.appender.db.nosql.mongo package to org.apache.logging.log4j.core.appender.db.nosql.mongodb.
  • Update Renamed the org.apache.logging.log4j.core.appender.db.nosql.couch package to org.apache.logging.log4j.core.appender.db.nosql.couchdb.
  • Fix (JMX - ObjectNames changed!) Unloading one web application unloads JMX MBeans for all web applications. Fixes LOG4J2-500.
  • Update Space Level numbers by 100 instead of 1. Fixes LOG4J2-507.
  • Fix Fixed bugs where rolled log files were overwritten by RollingFile appender with composite time and size based policies. Fixes LOG4J2-531. Thanks to Geoff Ballinger.
  • Fix Changed the MongoDBConnection to add a MongoDB encoding hook instead of a decoding hook. Fixes LOG4J2-475. Thanks to Matt Sicker.
  • Fix Fixed the JPAAppender's overuse of transactions by connecting (borrowing from pool) on new write internal or on flush. Fixes LOG4J2-489.
  • Fix Fixed failure of JDBC and JPA appender to properly release database connections by connecting (borrowing from pool) on new write internal or on flush. Fixes LOG4J2-457.
  • Fix Fixed problem with JDBC and JPA appender connectivity in WebSphere by connecting (borrowing from pool) on new write internal or on flush. Fixes LOG4J2-442.
  • Fix Ensured the JDBCAppender commits transactions after a single write or a flush of multiple writes. Fixes LOG4J2-438.
  • Fix Fixed inability to recover from lost database connection in database appenders by connecting (borrowing from pool) on new write internal or on flush. Fixes LOG4J2-407.
  • Add (JMX) JMX Client GUI should dynamically update when LoggerContext MBeans are registered/unregistered in MBean server. Fixes LOG4J2-530.
  • Fix Stop AsyncLoggerConfig Disruptor thread(s), then AsyncAppender thread(s) first before stopping other appenders. Fixes LOG4J2-511.
  • Fix Stop AsyncLoggerConfig Disruptor thread(s), then AsyncAppender thread(s) first before stopping other appenders. Fixes LOG4J2-392.
  • Fix (OSGi) logging.log4j-1.2-api doesn't export the log4j API 1.2. Dependent bundles can not be resolved. Fixes LOG4J2-345.
  • Fix LocalizedMessage serialization is broken. Fixes LOG4J2-523.
  • Fix Fixed issues with time-based file rollover (monthly, weekly, hourly and every minute). Fixes LOG4J2-385.
  • Fix Added a ServletContext attribute that, when set to "true", disables Log4j's auto-initialization in Servlet 3.0+ web applications. Fixes LOG4J2-452.
  • Fix Exposed Log4j web support interface and methods and the LoggerContext through ServletContext attributes so that threads not affected by filters (such as asynchronous threads) can utilize the LoggerContext. Also updated the Log4j filter so that it supports async. Fixes LOG4J2-512.
  • Fix Created a utility to properly escape backslashes before creating URIs, and changed URI creation to use the utility instead of instantiating URI directly. Fixes LOG4J2-409.
  • Fix Changed the Servlet 3.0 auto-initializer to add the filter by class to get around a WebLogic bug. Fixes LOG4J2-344.
  • Fix Changed the Servlet 3.0 auto-initializer so that it does nothing in a Servlet 2.5 or older application. This ensures behavioral consistency across containers. This includes additional fixes to abort initialization if a duplicate filter already exists and to check the actual Servlet EFFECTIVE version. Fixes LOG4J2-359.
  • Fix Switch in log4j-1.2-api Category.getEffectiveLevel has no cases for FATAL, OFF. Fixes LOG4J2-517.
  • Update Add support for custom logging levels. Fixes LOG4J2-41.
  • Fix (JMX) Unregister all log4j JMX MBeans when the LoggerContext is stopped to allow web application classes to be GC-ed on undeploy. Fixes LOG4J2-406.
  • Fix Configuration was being processed twice at startup. Fixes LOG4J2-405.
  • Add ThreadContext now uses plain ThreadLocal by default, unless system property isThreadContextMapInheritable has value "true". Fixes LOG4J2-479. Thanks to MK.
  • Fix Configure properties and setup Interpolator before processing rest of configuration. Fixes LOG4J2-398.
  • Add Add Stream interface to Loggers. Fixes LOG4J2-481.
  • Update Update EasyMock to version 3.2. Fixes LOG4J2-490.
  • Fix hostName property was not being set until after the first configuration element. Fixes LOG4J2-470.
  • Fix Support arrays as sub-elements of a JSON configuration. Fixes LOG4J2-464.
  • Fix (JMX) Fixed MalformedObjectNameException if context name contains '=' or newline characters. Fixes LOG4J2-492.
  • Fix (OSGi) Fix NPE during shutdown. Fixes LOG4J2-377.
  • Fix Fixed documentation for MyApp example application in the Automatic Configuration section Fixes LOG4J2-463.
  • Fix Fixed error in documentation code example in manual/eventlogging.html Fixes LOG4J2-408.
  • Fix Fixed typo in documentation: system property should be log4j2.loggerContextFactory Fixes LOG4J2-451.
  • Fix (JMX) Fixed issue where log4j2 LoggerContext did not show up in JMX GUI or JConsole. Fixes LOG4J2-443.
  • Fix Fixed issue where toString methods that perform logging could deadlock AsyncAppender. Fixes LOG4J2-485.
  • Fix ResolverUtil cannot find packages in file URLs which include the '+' character. Fixes LOG4J2-445.
  • Fix Use the formatted Message in RFC5424Layout for non-StructuredDataMessages. Fixes LOG4J2-430.
  • Fix Set external context when constructing the LoggerContext. Fixes LOG4J2-459.
  • Fix Cannot load log4j2 config file if path contains plus '+' characters. Fixes LOG4J2-466.
  • Fix Fix LogEvent to never return null Level, fixes LevelPatternConverter.format may throw NPE. Fixes LOG4J2-462.
  • Fix Fix LogEvent to never return null Level, fixes ThresholdFilter throws NPE. Fixes LOG4J2-465.
  • Fix Fixed issue where toString methods that perform logging could deadlock AsyncLogger. Fixes LOG4J2-471.
  • Add Documentation fix: The attribute of Route to refer to an appender is "ref" not "AppenderRef". Fixes LOG4J2-482.
  • Add Added option to toggle Thread name caching in AsyncLogger. Fixes LOG4J2-467.
  • Fix The message and ndc fields are not JavaScript escaped in JSONLayout. Fixes LOG4J2-478.
  • Fix RingBufferLogEvent should return Message timestamp for TimestampMessage messages. Fixes LOG4J2-455.
  • Fix NPE in ClassLoaderContextSelector. Fixes LOG4J2-477.
  • Fix TimeBasedTriggeringPolicy should use event time millis. Fixes LOG4J2-454.
  • Fix BaseConfiguration class does not properly implement Configuration interface. Fixes LOG4J2-472.
  • Fix XMLLayout does not include marker name. Fixes LOG4J2-447.
  • Update Update Flume Appender to use Flume 1.4.0. Fixes LOG4J2-453.
  • Add (JMX) Added MBeans for instrumenting AsyncAppenders and AsyncLogger RingBuffers, exposing queue size, remaining capacity and other attributes. Fixes LOG4J2-423.
  • Fix Resolved memory leak by releasing reference to ThreadLocal when AsyncLogger is stopped. Fixes LOG4J2-323.
  • Fix Resolved memory leak by populating AsyncLoggerConfigHelper ring buffer via EventTranslatorTwoArg, eliminating the need for a ThreadLocal. Fixes LOG4J2-425.
  • Add Create a lookup for resource bundle substitution. Fixes LOG4J2-420.
  • Fix Fix Event Level / LoggerConfig Level table at the architecture documentation page. Fixes LOG4J2-417.
  • Add Format log event time as UNIX time (seconds or milliseconds). Fixes LOG4J2-415.
  • Fix @EnterpriseNumber" was missing in the ID of structured data when RFC5424Layout is used Fixes LOG4J2-404. Thanks to Kamal Bahadur.
  • Fix Fixed issue that prevented Log4J from working in Google App Engine. Fixes LOG4J2-379.
  • Add Configure FileAppender buffer size. Fixes LOG4J2-401.
  • Add Configure RandomAccessFileAppender buffer size. Fixes LOG4J2-402.
  • Update Rename package org.apache.logging.log4j.core.appender.rolling.helper to org.apache.logging.log4j.core.appender.rolling.action. Fixes LOG4J2-528.
  • Update Resource leak in Flume appender when it cannot create a BerkeleyDB db. Fixes LOG4J2-532.
  • Update PatternLayout option to not output ANSI escape codes if no Console is available. Fixes LOG4J2-413.

New in log4j 2.0 Beta 9 (Nov 27, 2014)

  • Update Renamed FastFileAppender and FastRollingFileAppender to RandomAccessFileAppender and RollingRandomAccessFileAppender. Configurations using the Fast(Rolling)File element no longer work and should be modified to use the (Rolling)RandomAccessFile element. Fixes LOG4J2-317.
  • Update Changed the "suppressExceptions" configuration attribute for all Appenders to "ignoreExceptions" to avoid confusion with Java 7 suppressed exceptions. Also renamed the Appender#isExceptionSuppressed() method to Appender#ignoreExceptions() to avoid the same confusion. All Appenders by default internally log and then ignore exceptions encountered while logging. Setting "ignoreExceptions" to "false" on an Appender causes it to allow exceptions to propagate to the caller. You must set "ignoreExceptions" to "false" for Appenders you are wrapping in the Failover Appender.
  • Update Changed the (relatively new) PatternLayout configuration attribute "suppressExceptions" to "alwaysWriteExceptions" to more correctly indicate what it does. As such, the meaning of this attribute has reversed (previous "true"s should become "false"s, and vice versa). Since this was an undocumented attribute up until now, it's unlikely this change will affect any users.
  • Fix Fix table of contents generation in pdf. Fixes LOG4J2-226.
  • Fix Allow classpath scheme when specifying configuration file location as a system property. Fixes LOG4J2-395.
  • Fix Initialize PluginManager once during configuration. Move advertisement setup into BaseConfiguration. Fixes LOG4J2-393.
  • Fix FlumePersistentManager now handles LockConflictExceptions in Berkeley Db. Fixes LOG4J2-391.
  • Add Allow the default file rollover strategy to define the compression level. Fixes LOG4J2-399.
  • Add Add TLSAppender. Also added missing license headers to several files. Fixes LOG4J2-338.
  • Fix Use rollover date when substituting ${date} in the filePattern. Fixes LOG4J2-380.
  • Add Added FAQ page to the site. Fixes LOG4J2-253.
  • Add Add a diagram to the site (FAQ page) that explains when to use which jar. Fixes LOG4J2-362.
  • Fix Centralized reflective use of Reflection#getCallerClass and properly handled its instability in various versions of Java. Fixes LOG4J2-322.
  • Fix Reset the Configuration if the ClassLoaderContextSelector creates a LoggerContext without a configuration location and then is later provided one. Fixes LOG4J2-293.
  • Fix Changed the ConfigurationFactory to recognize and properly use the classpath: URI scheme in addition to the classloader: URI scheme. Fixes LOG4J2-293.
  • Fix Changed the Servlet 3.0 auto-initializer so that it does nothing in a Servlet 2.5 or older application. This ensures behavioral consistency across containers. Fixes LOG4J2-359.
  • Add Add more options to PatternLayout to display more detailed information about a Throwable. Fixes LOG4J2-374.
  • Add [Pattern Layout] Customize level names by length. Fixes LOG4J2-383.
  • Add [Pattern Layout] Customize level names to lower-case. Fixes LOG4J2-384.
  • Update Add support for multiple SD-ELEMENTs in a RFC 5424 syslog message. Fixes LOG4J2-355.
  • Update Cleaned up tests and cleared up documentation for the JPA appender following the resolution of EclipseLink issue #412454.
  • Fix Fixed issue where SMTPAppender did not send mails with error or fatal level without prior info event. Fixes LOG4J2-310.
  • Fix Add PatternLayout constructor to Log4j 1.2 bridge for Velocity. Fixes LOG4J2-368.
  • Fix Match artifact ids with Maven module names. Fixes LOG4J2-333.
  • Add Add WebLookup to retrieve information from the ServletContext. Fixes LOG4J2-364.
  • Fix JMS appenders send two messages for one append. Fixes LOG4J2-367.
  • Fix Double stack trace logging when using %throwable in %style and %highlight. Fixes LOG4J2-319.
  • Add Allow Plugins to have aliases. Fixes LOG4J2-360.
  • Fix NoSQLAppender using MongoDB provider ignores username and password attributes Fixes LOG4J2-358.
  • Add Create a JSON Layout. Fixes LOG4J2-356.
  • Fix Removed unnecessary generics from Appender interface and implementing classes. Fixes LOG4J2-343.
  • Fix [OSGi] wrong Fragment-Host in manifest files. Fixes LOG4J2-351.
  • Fix AsyncLogger errors after multiple calls to LoggerContext.reconfigure(). Fixes LOG4J2-336.
  • Fix Give the AsyncAppender thread a more descriptive name for easier debugging/profiling. Fixes LOG4J2-347. Thanks to David Phillips.
  • Fix Modified documentation to refer to SLF4J Binding instead of SLF4J Bridge. Fixes LOG4J2-332. Thanks to Hervé Boutemy.
  • Fix Ignore xml:base attributes. Fixes LOG4J2-342.
  • Fix Insure jars and distributions only have a single License and Notice file. Fixes LOG4J2-309.
  • Add Enable XInclude for XML configurations. Fixes LOG4J2-341.
  • Fix JPAAppender stops logging because META-INF/log4j-provider.properties is left open. Fixes LOG4J2-320.
  • Fix FlumePersistentManager's writer thread had high CPU usage. Fixes LOG4J2-335.
  • Fix Removed erroneous check for affected MongoDB records, which always returns zero on inserts. Fixes LOG4J2-331.
  • Fix Added a BSON Transformer so that MongoDB can persist Log4j events. Fixes LOG4J2-330.
  • Fix StatusLogger now only creates StatusData objects if they are the appropriate logging level. Fixes LOG4J2-329.
  • Fix FlumePersistentManager was calling Berkeley DB's count method too frequently. Fixes LOG4J2-328.
  • Fix Additional fix to make AsyncAppender threads daemon threads and improve their thread name. Fixes LOG4J2-280.
  • Fix The slf4j-ext jar is now an optional dependency of the SLF4J bridge. Fixes LOG4J2-165.
  • Update Allow shutdown hook to be disabled in the configuration. Fixes LOG4J2-318.
  • Fix RoutingAppender's default Route can now be an appender reference. Fixes LOG4J2-166.
  • Add Add JNDILookup plugin. Fixes LOG4J2-313.
  • Fix Add getThrowable method to ThrowableProxy. Fixes LOG4J2-299.
  • Fix ThrowableProxy no longer extends Throwable. Fixes LOG4J2-216.
  • Fix Synchronized flush() and close() methods in the XxxFileManager and OutputStreamManager classes. Fixes LOG4J2-311.
  • Update XML layout improvements (compact vs. pretty, namespace, namespace prefix, root element). Fixes LOG4J2-312.
  • Update Update Java Mail dependency to 1.5.0 from 1.4.7. Fixes LOG4J2-388.
  • Update Update JDBC tests to use H2 database 1.3.173 from 1.3.172. Fixes LOG4J2-325.
  • Update Update commons-logging to 1.1.3 from 1.1.1. Fixes LOG4J2-366.
  • Update Update HSQLDB dependency to 2.3.0 from 2.2.9. Fixes LOG4J2-390.
  • Update Clarified which library versions were used in Async Loggers performance test. Fixes LOG4J2-308.
  • Update Updated Async Loggers' LMAX Disruptor library from 3.0.1 to 3.2.0. Fixes LOG4J2-307.
  • Update Update JSON Jackson library to 2.2.2 from 2.2.1. Fixes LOG4J2-306.
  • Update Update Jackson dependency to 1.9.13 from 1.9.11. Fixes LOG4J2-387.
  • Add Ease porting from 1.x Logger.getRootLogger(): add LogManager.getRootLogger(). Fixes LOG4J2-305.
  • Fix Fixed Async Loggers memory leak. Fixes LOG4J2-304.
  • Fix Fixed JDBC, JPA, and NoSQL appenders so that the failover appender properly fails over on error. Fixes LOG4J2-291.
  • Update Improved site by adding quick jump-off page and menu for Javadoc links for all components.
  • Fix Logger.info(Message) Javadoc is incorrect. Fixes LOG4J2-397.

New in log4j 2.0 Beta 8 (Jul 19, 2013)

  • Changes:
  • Improved logging initialization in Servlet containers, especially Servlet 3.0 and newer where Log4j now initializes and deinitializes automatically with no deployment descriptor configuration. Fixes LOG4J2-270.
  • Added toString methods to ThreadContextStack/Map implementation classes. Fixes LOG4J2-302.
  • Add printf methods to Logger API. Fixes LOG4J2-301.
  • WriterThread was ending when no agents are available which caused an OutOfMemoryError. Fixes LOG4J2-300.
  • Allow the default status level to be specified as a system property. Fixes LOG4J2-282.
  • Filter calls from Avro or Flume to be ignored by the FlumeAppender. Fixes LOG4J2-278.
  • FlumePersistentManager now calls Berkeley DB from threads to avoid encountering interrupts in the application. Fixes LOG4J2-279.
  • Wasted work in FlumePersistentManager.createManager. Fixes LOG4J2-296.
  • Wasted work in TestConfigurator.testEnvironment. Fixes LOG4J2-297.
  • Wasted work in StyleConverterTest.setupClass. Fixes LOG4J2-298.
  • AsyncLogger threads are now daemon threads and won't prevent the JVM from shutting down anymore. Fixes LOG4J2-280.
  • Fast(Rolling)FileAppender now correctly handles messages exceeding the buffer size. Fixes LOG4J2-295.
  • FastRollingFileAppender with TimeBasedTriggeringPolicy now works correctly if append=false. Fixes LOG4J2-271.
  • FastRollingFileAppender with TimeBasedTriggeringPolicy now works correctly if append=false. Fixes LOG4J2-267.
  • Fast(Rolling)FileAppender now correctly appends to (does not overwrite) existing file. Fixes LOG4J2-292.
  • LogManager.getLogger can now be called without a logger name or with a null logger name. Fixes LOG4J2-294.
  • Upgrade javadoc plugin to 2.9.1 to fix javadoc security issue. Fixes LOG4J2-289.
  • Update JUnit to 4.11 from 4.7. Fixes LOG4J2-288.
  • Update test H2 JDBC driver to 1.172 from 1.171. Fixes LOG4J2-286.
  • Update Jansi jar to 1.11 from 1.9. Fixes LOG4J2-285.
  • Update Log4j 1 dependency to 1.2.17 from 1.2.16. Fixes LOG4J2-284.
  • Remove dependency on Apache ORO jar. Fixes LOG4J2-283.
  • Wasted work in RollingAppenderSizeTest.testAppender() and others. Fixes LOG4J2-277.
  • Fix NullPointerException (regression due to fix for LOG4J2-228). Fixes LOG4J2-139.
  • Include arbitrary message fields in RFC-5424 structured data. Fixes LOG4J2-168.
  • FlumeAvroManager fails to notify client of failing event if Flume RPCClient cannot be created. Fixes LOG4J2-275.
  • Wasted work in UUIDUtil initialization. Fixes LOG4J2-274.
  • Wasted work in XMLLayout.toSerializable(). Fixes LOG4J2-273.

New in log4j 2.0 Beta 7 (Jul 19, 2013)

  • Changes:
  • Allow context parameters in Log4jContextListener to include properties. Fixes LOG4J2-249.
  • Do not allow a charset on RFC5424Layout - use UTF-8. Fixes LOG4J2-263.
  • StringFormattedMessage and MessageFormatMessage now will accept a Throwable as their last argument and pass it on. Fixes LOG4J2-242.
  • Allow custom LogEventFactories. Fixes LOG4J2-243.
  • Add support for interceptors in the embedded Flume Appender. Fixes LOG4J2-262.
  • Use transaction when batch size is 1. Fixes LOG4J2-269.
  • Add guid to FlumeEvent headers for non-Map Messages. Fixes LOG4J2-268.
  • Data buffer is reset in finally clause. Fixes LOG4J2-246.
  • UDP now sends one event per packet. Fixes LOG4J2-228.
  • Method name changes in interface org.apache.logging.log4j.spi.ThreadContextMap: getContext() to getCopy(), get() to getImmutableMapOrNull().
  • Improve ThreadContext performance with copy-on-write map and stack. Fixes LOG4J2-154.
  • Add missing "not" to error message. Fixes LOG4J2-261. Thanks to Edward Sargisson.
  • Break up core into multiple osgi jars. Fixes LOG4J2-10. Thanks to Timothy Ward.
  • Remove LoggerContext when LoggerContext is stopped. Fixes LOG4J2-223.
  • XML layout does not specify charset in content type. Fixes LOG4J2-260.
  • HTML layout does not specify charset in content type. Fixes LOG4J2-259.
  • HTML layout does not output meta element for charset. Fixes LOG4J2-258.
  • XML layout ignores charset for the XML processing intruction's encoding attribute. Fixes LOG4J2-257.
  • Multi-byte character strings are now assumed to be in the platform default encoding, not UTF-8. Fixes LOG4J2-255.
  • Mark OutputStream in OutputStreamManager as volatile. Mark header and footer as final. Fixes LOG4J2-254.
  • Rewrite Appender was ignoring filters on referenced appenders. Fixes LOG4J2-244.
  • Avoid EmptyStack exception if getCallerClass and SecurityManager are not available. Fixes LOG4J2-245.
  • New JDBC, JPA, and NoSQL database Appenders. Fixes LOG4J2-229. Thanks to beamerblvd.
  • SocketServer.isActive should be volatile because it is accessed from different threads. Fixes LOG4J2-247.
  • Provide configuration information (location, content type, content if possible) via a registered Advertiser. Fixes LOG4J2-251.

New in log4j 2.0 Beta 6 (May 10, 2013)

  • Logger.getParent() was not returning the correct Logger. Fixes LOG4J2-231.
  • Renamed Plugin annotation attribute from "type" to "category". Fixes LOG4J2-201.
  • Moved JMX Client GUI classes into separate jmx-gui submodule. Fixes LOG4J2-237.
  • Fix: install default root logger if not configured (this is unchanged), but make sure to include configured named loggers. Clarified documentation. Fixes LOG4J2-219. Thanks to Peter DePasquale.
  • Use OSGi version format in Fragment-Host Fixes LOG4J2-159.
  • RegexFilter threw a NullPointerException when used as a context-wide filter. Fixes LOG4J2-234.
  • Add support for interpolating Environment variables when processing the configuration. Fixes LOG4J2-192.
  • Removed dependency on tools jar from core module, made jconsole dependency optional. Fixes LOG4J2-235. Thanks to Sebastian Oerding.
  • Fixed link to log4j-user mailing list. Fixes LOG4J2-233.
  • Improved error reporting when misconfigured. Fixes LOG4J2-230. Thanks to Wojciech Zaręba.
  • Disruptor will now shutdown during Tomcat shutdown. Fixes LOG4J2-222. Thanks to Steven Yang.
  • Renamed AsynchAppender to AsyncAppender. Plugin name became Async (was Asynch).
  • Removed CheckStyle false positives for NewlineAtEndOfFile and whitespace following '*' at end of line in javadoc.
  • Moved Clock interface to package org.apache.logging.log4j.core.helpers.
  • Documentation updates to clarify use and impact of location in pattern layouts. Fixes LOG4J2-225.
  • The FlumeAppender failed to start if the Flume RPCClient could not connect to any Flume agents. Fixes LOG4J2-224.
  • Fix LoggerContext start and stop to eliminate IllegalStateException and NoClassDefFound errors. Fixes LOG4J2-223.
  • Remove hundreds of compiler warnings. Fixes LOG4J2-221. Thanks to Nick Williams.
  • Various small documentation fixes. Fixes LOG4J2-215.
  • Ensure PluginManager streams are always closed. Fixes LOG4J2-217. Thanks to Fabien Sanglard.

New in log4j 2.0 Beta 5 (May 10, 2013)

  • Fix deadlock in SocketAppender. Added option to not wait for socket reconnect. Fixes LOG4J2-205.
  • Add JMX support. Fixes LOG4J2-207. Thanks to Remko Popma.
  • Removing extra spaces in entry and exit method output. Fixes LOG4J2-211. Thanks to Nick Williams.
  • Async documentation update. Fixes LOG4J2-214. Thanks to Remko Popma.
  • Loggers without a "." had no parent logger. Fixes LOG4J2-212.
  • Move async subproject into core. Fixes LOG4J2-208. Thanks to Remko Popma.
  • Call LoggerContext.stop when the application is shutdown. Fixes LOG4J2-212.
  • MapMessage was not enclosing key value in quotes when generating XML. Fixes LOG4J2-210. Thanks to Arkin Yetis.
  • FlumeAvroManager now uses Flume RPCClient. Fixes LOG4J2-198.
  • FlumeAvroManager now uses Flume RPCClient. Fixes LOG4J2-196.
  • Use the Maven group ID org.apache.logging.log4j for all artifacts. Fixes LOG4J2-207.
  • Add tag library. Fixes LOG4J2-187. Thanks to Nick Williams.
  • Unit tests now create files in the target directory. Fixes LOG4J2-195. Thanks to Remko Popma.
  • RollingFastFileAppender (in log4j-async) did not roll over. Fixes LOG4J2-193. Thanks to Remko Popma.
  • Highlight subprojects in sub-navigation. Fixes LOG4J2-199. Thanks to Remko Popma.
  • LoggerContext method renamed to removeFilter from removeFiler. Fixes LOG4J2-200. Thanks to Remko Popma.
  • ThrowableFormatOptionsTest failed on Windows due to CR/LF issue. Fixes LOG4J2-194. Thanks to Remko Popma.
  • BaseConfiguration addLoggerAppender saved appender using the Logger name. Fixes LOG4J2-190. Thanks to Werner.
  • Move Throwable pattern converter options processing to ThrowableFormatOptions class. Fixes LOG4J2-160. Thanks to Joanne Polsky.
  • Allowed Loggers access to the properties in the LoggerConfig. Fixes LOG4J2-157. Thanks to Remko Popma.
  • Added ability to include or exclude location information. Fixes LOG4J2-153. Thanks to Remko Popma.
  • Allow Logger and LoggerContext to be subclassed. Fixes LOG4J2-151. Thanks to Remko Popma.
  • Add methods is/setEndOfBatch to LogEvent. Fixes LOG4J2-164. Thanks to Remko Popma.
  • Add support for asynchronous loggers. Fixes LOG4J2-163. Thanks to Remko Popma.
  • The blocking parameter did not work properly on AsynchAppender. Fixes LOG4J2-189. Thanks to Werner.
  • appender-refs on AsynchAppender didn't support the level and filter elements. Fixes LOG4J2-188. Thanks to Werner.
  • Avoid IllegalArgumentException in AsynchAppender. Fixes LOG4J2-176. Thanks to Remko Popma.
  • Add Logger interface APIs to log at given levels. Fixes LOG4J2-179.
  • OutputStreamManager now adds the layout header whenever the OutputStream is set. Fixes LOG4J2-181.
  • Fix NullPointerException in DatagramOutputStream when flush is called from multiple threads. Fixes LOG4J2-177. Thanks to Remko Popma.
  • Added FlumePersistentManager which writes to BerkeleyDB and then writes to Flume asynchronously.
  • Plugin cache should be reset when addPackages is called. Fixes LOG4J2-175.sdeboy
  • Expose file appender configuration details via an advertisement mechanism. Fixes LOG4J2-155.sdeboy
  • Add Fragment-Host to MANIFEST.MF for log4j2-core. Fixes LOG4J2-159. Thanks to Jan Winter.
  • Configurator throws a ClassCastException if LogManager returns a SimpleLoggerContext. Fixes LOG4J2-167.
  • ConfigurationFactory was adding factories on every call. Fixes LOG4J2-169.
  • Modify ClassLoaderContextSelector to use the first ClassLoader in the child parent hierarchy that has a Context with a configuration to allow JSPs to use the WebApp's context and configuration. Fixes LOG4J2-161.
  • Add RFC 5424 compliant escaping rules to RFC5424Layout. Fixes LOG4J2-158. Thanks to Scott Severtson.

New in log4j 2.0 Beta 4 (May 10, 2013)

  • LocalizedMessageTest fails on linux system. Fixes LOG4J2-156. Thanks to Andreas Born.
  • RollingFileAppender's FileRenameAction was throwing a NullPointerException if no directory was specified on the target file name. Fixes LOG4J2-152. Thanks to Remko Popma.
  • Convert all System.getProperty calls to use PropertiesUtil to suppress SecurityExceptions. Fixes LOG4J2-150.
  • ThreadContextMapFilter was matching on the key instead of the value of the key. Fixes LOG4J2-147. Thanks to William Burns.
  • Allow FlumeAvroManager to initialize even if it cannot connect to an agent.
  • SMTPAppender will only cache filtered events. Fixes LOG4J2-149. Thanks to Scott Severtson.
  • Add missing serial version IDs. Fixes LOG4J2-145.
  • NullPointerException in RFC5424Layout. Fixes LOG4J2-144.
  • MessagePatternConverter now returns "null" if the log message is null. Fixes LOG4J2-143.
  • Serialized LogEvents were not reset in the output stream causing them to deserialize incorrectly. Fixes LOG4J2-142.
  • Fix null pointer exception in SocketAppender if no protocol is specified. The protocol will default to TCP for the SocketAppender and UDP for the SyslogAppender. Fixes LOG4J2-139.
  • Added Log4j 2 to SLF4J adapter.
  • Typo in documentation of SocketAppender. Fixes LOG4J2-140. Thanks to Joern Huxhorn.
  • Fix hang in Dumbster SMTP test server. Fixes LOG4J2-137.
  • Allow newlines to be escaped in Syslog and RFC5424 layouts. Allow Throwables to be included in the output from RFC5424Layout. Fixes LOG4J2-136. Thanks to Scott Severtson.
  • Add SMTPAppender. Fixes LOG4J2-131. Thanks to Scott Severtson.
  • PatternLayout should format throwables without requiring a converter. Fixes LOG4J2-130.
  • Added hostName and contextName to property map.
  • BaseConfiguration does not close the first appender. Fixes LOG4J2-135. Thanks to Ingo Feltes.
  • Add MessageFormatMessage and FormattedMessage.
  • Use %red, %white, %blue, and so on in the console appender. Fixes LOG4J2-134.
  • Allow custom message creation via a message factory. Fixes LOG4J2-133.
  • AbstractLogger.catching(Throwable) checks for DEBUG level but logs at ERROR level. Fixes LOG4J2-132.
  • RoutingAppender was only creating a single appender for the default Route. Fixes LOG4J2-129.
  • Allow JMS appenders to recover if the queue or topic is unavailable. Fixes LOG4J2-126.
  • Add follow attribute to Console Appender. Fixes LOG4J2-128.
  • AbstractLogger methods were not passing Markers to the isEnabled methods. Fixes LOG4J2-127.
  • Added Flume Appender samples.
  • Add unit test to verify exceptions are thrown when the socket connection fails. Fixes LOG4J2-122.
  • JMSQueue and JMSTopic Appenders did not allow name to be specified. Fixes LOG4J2-125.
  • Enhanced javadoc copyright statement. Fixes LOG4J2-111.
  • Renamed log4j12-api to log4j-1.2-api. Fixes LOG4J2-110.
  • TCPSocketManager would fail if the initial connection could not be established. Fixes LOG4J2-120.
  • A broken socket connection would cause the TCPSocketManager to continuously reconnect. Fixes LOG4J2-119.
  • The example for ThreadContextMapFilter was incorrect. Fixes LOG4J2-123. Thanks to Olivier Lamy.
  • File renaming was using the wrong date value. Enhanced DefaultRolloverStrategy to store newest files in highest index as well as lowest. Fixes LOG4J2-116.
  • ThreadContext Map elements with null values are now ignored when constructing a Flume event and in the RFC5424 Layout. Fixes LOG4J2-115.
  • StructuredDataFilter createFilter was annotated with PluginAttr instead of PluginElement for the KeyValuePairs. Fixes LOG4J2-113.
  • StructuredDataMessage was validating the length of the values in the event Map instead of the lengths of the keys. Fixes LOG4J2-114. Thanks to Arkin Yetis.

New in log4j 2.0 Beta 3 (May 10, 2013)

  • Fix NullPointerException in ClassLoaderContextSelector when no class is returned from the SecurityManager. Fixes LOG4J2-108.
  • Add ability to customize the names of the Levels in the LevelPatternConverter. Fixes LOG4J2-105.
  • PatternParser was not properly handling adjacent nested options Fixes LOG4J2-107.
  • Add support for loading plugins inside the OSGi bundle. Fixes LOG4J2-95.
  • Add ThreadContext.push(String format, Object... args) Fixes LOG4J2-85.
  • The LogEvent was wrapping a ThrowableProxy with another ThrowableProxy when deserializing. Fixes LOG4J2-103. Thanks to Das Archive.
  • Created combined jar to combine API and Core contents for users who only want the Log4j implementation.
  • Convert LogManager binding to use "regular" java properties instead of XML properties to workaround a bug in Oracle's xmlparserv2 jar. Fixes LOG4J2-104.
  • Added PropertiesRewritePolicy and ability to define properties on a Logger. Fixes LOG4J2-28.
  • Build pdf of user's guide. Fixes LOG4J2-87.
  • Added font and fontSize parameters to HTMLLayout. Replace newlines in message with br tag. Fixes LOG4J2-29.
  • Added ability to configure from an InputSource. Fixes LOG4J2-55.
  • The Facility value was being improperly calculated. Fixes LOG4J2-102. Thanks to Emanuele Colombo.
  • A NullPointerException would occur if no format value was passed to the SyslogAppender. Fixes LOG4J2-101. Thanks to Emanuele Colombo.
  • MapRewritePolicy had an extra call to putAll that caused updates to behave like adds. Fixes LOG4J2-99. Thanks to Das Archive.
  • Avoid NPE when duplicate LoggerContextFactorys are present. Allow factories to specify a weight to allow real implementations to outrank test implementations. Provide a simple default LoggerContextFactory.
  • Added several missing classes and methods for Log4j 1.x compatibility. Fixes LOG4J2-97.
  • Interpolator was not stripping Lookup key separator when trying to locate the default value for a variable. Fixes LOG4J2-94. Thanks to Denis Treskunov.
  • Log4j 1.2 Category.forcedLog was wrapping the message with an ObjectMessage even if the parameter was an ObjectMessage.

New in log4j 2.0 Beta 2 (May 10, 2013)

  • Made ParameterizedMessage, StringFormattedMessage and ThreadDumpMessage immutable. LocalizedMessage is immutable except that it will be updated with the logger name when it is added to the LogEvent.
  • DefaultConfiguration was not starting the Console Appender.
  • Add interval and modulate options to TimeBasedTriggeringPolicy to allow more fine-grained control of when file rolling should occur. Fixes LOG4J2-35.
  • Add support for filtering packages from stack traces. Fixes LOG4J2-58.
  • If system property "disableThreadContextStack" is set pushes to the ThreadContext will be ignored. If system property "disableThreadContext" is set both puts and pushes will be ignored. Fixes LOG4J2-84.
  • If system property "disableThreadContextMap" is set puts to the ThreadContext will be ignored. If system property "disableThreadContext" is set both puts and pushes will be ignored. Fixes LOG4J2-83.
  • Add support for ANSI colors by adding the highlight and style pattern converters. Fix pattern parsing to allow nested patterns.
  • Converted DynamicThresholdFilter to use KeyValuePair. Fixed bugs in the Map-based filters to allow declaration of multiple values for a key to match the documentation. Fixes LOG4J2-92.
  • Many logging methods in AbstractLogger were set to an incorrect logging level. catching was using the THROWING marker and was set to debug instead of error. Fixes LOG4J2-88.
  • Allow the status logging to be directed to stderr or to a file.
  • Log4j 1.2 adapter's Category class was missing 3 log methods. Fixes LOG4J2-91.
  • If the ThreadContext stack is empty the LogEvent will contain a null value to reduce the overhead of creating log events and in the size of the serialized object. Changed the ThreadContext stack to use a custom stack interface instead of java.util.Stack as that class is overly heavy. This change will cause an API incompatibility. Fixes LOG4J2-84.
  • If the ThreadContext map is empty the LogEvent will contain a null value to reduce the overhead of creating log events and in the size of the serialized object. Fixes LOG4J2-83.
  • Add getFormats to MultiformatMessage and allow StructuredDataMessage to format as XML.
  • Add documentation on client vs server mode to performance page. Fixes LOG4J2-90.
  • Move variable substitution from PatternLayout to appropriate converters to improve performance.

New in log4j 2.0 Beta 1 (May 10, 2013)

  • Added AsynchAppender.PatternLayout was not honoring format modifiers. Fixes LOG4J-81.
  • Created web module to allow web applications to include the Log4j context listener in WEB-INF/lib even if Log4j is in the container's class path. Allow locating the LoggerContext to include the ClassLoader. Updated the Loader utility to always choose the child ClassLoader. Verified in Jboss 5 and Tomcat.
  • MarkerFilter called MarkerManager.getMarker causing the Marker to be created during the processing of the configuration. This prevents the application from creating the Marker with any parents. MarkerWrapper in SLF4J-impl was getting a ClassCastException in instanceOf because the Marker isn't a MarkerWrapper. Fixes LOG4J2-82.
  • Allow Log4j 2 to be used as the implementation with SLF4J and SLF4J's jcl-over-slf4j by adding filtering to the log method in SLF4JLogger. Fixes LOG4J2-80. Thanks to Oliver Lamy.
  • LogFactoryImpl.setAttribute in the Commons Logging bridge got a NullPointerException when passed a null value. It will now remove the attribute. Fixes LOG4J2-78.
  • RoutingAppender was calling the stop method for each of its referenced Appenders and was calling the stop method of the default Appender a second time. It will now only call the stop method of Appenders it creates. Fixes LOG4J2-77.
  • RewriteAppender was calling the stop method of the referenced appender causing the referenced appender's manager to have its use count decremented too many times. Fixes LOG4J2-76.
  • Logger.error(Marker, Message, Throwable) was internally using Level.TRACE. Fixes LOG4J2-74.
  • Enhanced Log4jContextListener to accept a configuration file location. Modified FileConfigurationMonitor to monitor files configured that way. Fixed other reconfiguration related bugs. Tested in JBoss and Tomcat. Fixes LOG4J2-75.
  • NullPointerException in RollingFileManager when filePattern does not cause the file to be compressed. Fixes LOG4J2-72.
  • FileRenameAction did not create the parent directories of the archive files causing the rollover to fail. Fixes LOG4J2-71.
  • Update the versions of SLF4J and Logback.

New in log4j 2.0 Alpha 2 (May 10, 2013)

  • Add getLogger(Class) to LogManager. Fixes LOG4J2-70.
  • Allow Flume agents to be embedded into the Flume Appender. Fixes LOG4J2-69.
  • Add support for formatting using String.format(). Fixes LOG4J2-68.
  • Allow components besides core to create a PluginMap for faster plugin loading and not having to specify the plugin package in the configuration. Fixes LOG4J2-67.
  • Fix compilation problems in Java 7. Fixes LOG4J2-64.
  • Allow variable substitution on the configuration attributes and on the root log level. Fixes LOG4J2-65.

New in log4j 2.0 Alpha 1 (May 10, 2013)

  • Added ability to filter on the appender-ref by adding either a level or a filter. Fixes LOG4J2-60. Thanks to Shane Kelly.
  • Level.toLevel would throw an IllegalArgumentException instead of returning the default value. Fixes LOG4J2-56. Thanks to John Owen Atala.
  • Remove LoggerContext support for custom logger factories. All Loggers returned by LoggerContext should be compatibile and of the same type. Fixes LOG4J2-51. Thanks to John Vasileff.
  • Make sure all application facing log methods use their own FQCN. This patch resolves a unit test failure for the %C pattern when using the Category logger. Fixes LOG4J2-50. Thanks to John Vasileff.