Skip to main content

Log4j : How To Log Message To Console

Introduction

This tutorial will help you to log all level messages into console using Log4j plugin.

In previous tutorial we have seen how to setup the log4j plugin in Maven and simple logging application.
If you need to understand the basic of Log4J the visit previous tutorial.


What we will do in this tutorial

We saw in the previous tutorial that Log4J's default configuration set the logging level to Error, causing it to log only errors and fatal messages to the console.

To overcome this problem, we need to override the default configuration. To do so, we need to write a Log4j configuration file named Log4j2.xml and update the correct logging level. 

Log4j supports YAML, JSON, and XML file formats for its configuration files. For this tutorial we are using Log4j2.xml


Sample Log4j2.xml


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

Note: Place the Log4j2.xml file in the classpath, or in the src/resources directory for Maven projects.



Console Appender

The Appender configuration tag tells where to log the messages, it could be console or file.

The Console appender sets out a layout to log the message by defining the pattern. The pattern can include date and time, level of message, message itself, etc.

  • target : Either "SYSTEM_OUT" or "SYSTEM_ERR". The default is "SYSTEM_OUT".
  • pattern : The log messages are formatted using a combination of literals, conversion characters, and format modifiers, according to the pattern.

Sample Code

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

public class MainApp {

    public static void main(String[] args) {
        Logger logger = LogManager.getLogger();
        printLoggingLevels(logger);
    }

    private static void printLoggingLevels(Logger logger) {
        logger.trace("logging trace level");
        logger.debug("logging debug level");
        logger.info("logging info level");
        logger.warn("logging warn level");
        logger.error("logging error level");
        logger.fatal("logging fatal level");
    }
}


You will get the following output on the console as you run the application.

02:29:50.976 [main] ERROR com.zainabed.tutorials.logging.MainApp - logging error level
02:29:50.979 [main] FATAL com.zainabed.tutorials.logging.MainApp - logging fatal level


Still, we get only Error and Fatal messages even after creating the custom configuration file. 

To understand the problem, we need to learn the logging level defined for Log4j.

Logging level filter revisit

Log4j has the following filter mechanism.

All <  Trace < Debug < Info < Warn < Error < Fatal

If the logging level is set to be Debug, then Debug, info, warning, error, and fatal messages will be logged into the console.

When the logging level is set to "Error," both the Error and Fatal messages are displayed.

So we need to update the Root level from Error to Debug.


Updated Log4j2.xml

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


Here we have updated the Root level from Error to Debug.

Rerun the application and you will get the following output.

02:32:27.675 [main] DEBUG com.zainabed.tutorials.logging.MainApp - logging debug level
02:32:27.680 [main] INFO  com.zainabed.tutorials.logging.MainApp - logging info level
02:32:27.680 [main] WARN  com.zainabed.tutorials.logging.MainApp - logging warn level
02:32:27.680 [main] ERROR com.zainabed.tutorials.logging.MainApp - logging error level
02:32:27.680 [main] FATAL com.zainabed.tutorials.logging.MainApp - logging fatal level


Conclusion 

In this tutorial, we learned the importance of the Log4j2.xml configuration. How to control the logging level and medium of output .

In the next tutorial, we will learn how to log the messages into a file.

You can find the source code on Github.

Comments

Subscribe for latest tutorial updates

* indicates required

Popular posts from this blog

JAX-RS Tutorials: REST API using Java

JAX-RS is API specification   for RESTful web services using Java. RESTful web services is implementation of REST ( Representational State Transfer ) which is architectural design for distributed system or in general we can say JAX-RS  is a set of APIs to develop REST service.   This is a brief introduction about REST and JAX-RS. You can find more information on REST on Wiki and JAX-RS Official Site. What is REST? Representational state transfer is an abstraction of the architecture of the World Wide Web. More precisely, REST is an architectural style consisting of a coordinated set of architectural constraints (source  Wikipedia ) As JAX-RS is only a specification, we need to use it's implemented library to create RESTful web service. Following are such list of libraries Apache CXF , an open source  Web service  framework. Jersey , the reference implementation from  Sun  (now  Ora...

Twig Tutorials: Install and Configure

In this tutorial, we'll look at how to install Twig within your PHP project and thereafter configure it so that we can create and use a Twig template inside our PHP web application. Later on, we'll see a simple Twig template example that displays a "Welcome to Twig template" message. Let's take it one step at a time. Install The Twig template can be installed using Composer, Git, or PEAR. In this tutorial, we will use Composer to install Twig. To do so, we'll need to make a "composer.json" file. { "require" : { "twig/twig" : "1.*" } } From the console, run the following command . $ php composer.phar install This command will install Twig library. Configuration To use the Twig template, we should first configure it. To achieve this, we will write an index.php file which will configure the Twig autoloader and generate the Twig environment. We will render the Twig temp...

Preload Images Using Javascript

Preload Image is technique which helps browser to render images with minimum delay. Today we will see example of image gallery. Gallery contain 5 images which load images one after another whenever user clicks next and back button. This is a basic image gallery scenario which is used in all possible website, then why we need preloaded images for this gallery? Now a day’s most of website becoming faster and user expectation is increasing. Suppose your website doesn’t use preload image technique for gallery and a user visits any image gallery from Google Plus or Facebook and visits your website gallery. Then that user always prefer those websites rather than yours. Why? Because your website load one image at a time. When user click on next button, then only gallery load image and user has wait till it get loaded. To avoid this situation gallery needs to download all images ...