Tag 2.8.2
-----BEGIN PGP SIGNATURE-----

iQIzBAABCgAdFiEEnQpWqqDWDgwMfczAtMcIk7Yrq+gFAl8oxagACgkQtMcIk7Yr
q+irMw/+Idm+wfIoge9SXAJXMN0YLIzhWgYUatemJR9INzzgYv6oBpCtB9DPrk39
nLidqU5rXFWQwT8Pg3lpP2oNtA65QF/DkCxpwgUbh0QPQ4Ove10IOEkdCTDo/9vl
ecocZdsxRAWW6Bl5fIz3kmdWREDgH0vMmkqDnHc93a7G7AoZxg+9bWa83J7R451V
xOVoOMucJmrjG/Efv5DdFl9eXyzkYqDlV1oGoXTcbd10DfNOxKVdiMyiyib839H4
xH8uzNhSN9z78q8jQWrfdM+b0tI7vyjkCryQgMklmFXvvh9gO9lxbWXF55HFPnvU
DD9NICuGI+YsSV7LCS41L84U/x+qMpWBiwF4j7C4iKiq2/+qdqCMZcapKengvWuI
FQfYod5u0ah9e7mB4uzPElkWURKR2U1dyXW3L8Qu4EQI+BG8S5zHFHM14lI5FSpA
AtnMdbejXtcrb7Ny0Krk0HMs/ZCUbaywYOVIdHhBjyxMTv7W7GIWguIlL5YYCD6s
qvcQqaHrCxq4G5vFDkwjsg1PaEKl0YuPPj/iHONz16xMQkkM5+1bQWSH+ffRE5eI
3ysqG3BvGQ/iczJx9EgzewqENG642KI9WSEZP73KgH0ky3Y4eeb4qGAPKy7pBW5/
mx7mIRWi9DiiWhDlD9aNRPx3mVO1Ou1K8Ic85fXqYeDqv/EzHvI=
=iRsd
-----END PGP SIGNATURE-----
[maven-release-plugin] prepare release log4j-2.8.2-rc1
29 files changed
tree: a5864fb8b9f87a699d349c3e688f0cb3b78baa35
  1. .dockerignore
  2. .gitattributes
  3. .gitignore
  4. .mvn/
  5. .travis.yml
  6. BUILDING.md
  7. CONTRIBUTING.md
  8. Dockerfile
  9. LICENSE.txt
  10. NOTICE.txt
  11. README.md
  12. RELEASE-NOTES.md
  13. checkstyle-header.txt
  14. checkstyle-import-control.xml
  15. checkstyle-suppressions.xml
  16. checkstyle.xml
  17. doap_log4j2.rdf
  18. findbugs-exclude-filter.xml
  19. log4j-1.2-api/
  20. log4j-api-scala_2.10/
  21. log4j-api-scala_2.11/
  22. log4j-api/
  23. log4j-bom/
  24. log4j-core-its/
  25. log4j-core/
  26. log4j-distribution/
  27. log4j-flume-ng/
  28. log4j-iostreams/
  29. log4j-jcl/
  30. log4j-jmx-gui/
  31. log4j-jul/
  32. log4j-liquibase/
  33. log4j-nosql/
  34. log4j-osgi/
  35. log4j-perf/
  36. log4j-samples/
  37. log4j-slf4j-impl/
  38. log4j-taglib/
  39. log4j-to-slf4j/
  40. log4j-web/
  41. mvnw
  42. mvnw.cmd
  43. pom.xml
  44. src/
README.md

Apache Log4j 2

Apache Log4j 2 is an upgrade to Log4j that provides significant improvements over its predecessor, Log4j 1.x, and provides many of the improvements available in Logback while fixing some inherent problems in Logback's architecture.

![Jenkins Status](https://builds.apache.org/buildStatus/icon?job=Log4j 2.x) Travis Status Coverage Status

Usage

Maven users can add the following dependencies to their pom.xml file:

<dependencies>
  <dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-api</artifactId>
    <version>2.8</version>
  </dependency>
  <dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-core</artifactId>
    <version>2.8</version>
  </dependency>
</dependencies>

Gradle users can add the following to their build.gradle file:

dependencies {
  compile group: 'org.apache.logging.log4j', name: 'log4j-api', version: '2.8'
  compile group: 'org.apache.logging.log4j', name: 'log4j-core', version: '2.8'
}

Basic usage of the Logger API:

package com.example;

import org.apache.logging.log4j.Logger;
import org.apache.logging.log4j.LogManager;

public class Example {
    private static final Logger LOGGER = LogManager.getLogger();

    public static void main(String... args) {
        String thing = args.length > 0 ? args[0] : "world";
        LOGGER.info("Hello, {}!", thing);
        LOGGER.debug("Got calculated value only if debug enabled: {}", () -> doSomeCalculation());
    }

    private static Object doSomeCalculation() {
        // do some complicated calculation
    }
}

And an example log4j2.xml configuration file:

<?xml version="1.0" encoding="UTF-8"?>
<Configuration>
  <Appenders>
    <Console name="Console" target="SYSTEM_OUT">
      <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
    </Console>
  </Appenders>
  <Loggers>
    <Logger name="com.example" level="INFO"/>
    <Root level="error">
      <AppenderRef ref="Console"/>
    </Root>
  </Loggers>
</Configuration>

Documentation

The Log4j 2 User's Guide is available here or as a downloadable PDF.

Requirements

Log4j 2.4 and greater requires Java 7, versions 2.0-alpha1 to 2.3 required Java 6. Some features require optional dependencies; the documentation for these features specifies the dependencies.

License

Apache Log4j 2 is distributed under the Apache License, version 2.0.

Download

How to download Log4j, and how to use it from Maven, Ivy and Gradle.

Issue Tracking

Issues, bugs, and feature requests should be submitted to the JIRA issue tracking system for this project.

Pull request on GitHub are welcome, but please open a ticket in the JIRA issue tracker first, and mention the JIRA issue in the Pull Request.

Building From Source

Log4j requires Apache Maven 3.x. To build from source and install to your local Maven repository, execute the following:

mvn install

Contributing

We love contributions! Take a look at our contributing page.