33

In Log4j, what is the difference between NDC and MDC? Can I have a simple example where they are used?

2

2 Answers 2

38

To expand on the link which Sikorski put in the comments:

NDC

In NDC, the N stands for nested, meaning you control a single value with a Stack. You "push" a string, then you can "push" another whenever processing dictates; and when processing is complete you can pop it off to see the former value. This sort of contextual logging would be useful in some deeply-nested processing.

Setting the context string

NDC.push("processingLevel2"); 
log.info("success");

This will get output in your log where you have the %x (lowercase) pattern:

log4j.appender.CA.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss.SSSS} %p %C %x = %m%n

MDC

The M stands for mapped, and this gives you a different type of control. Instead of using a single stack to control a single contextual string, you use name/value pairs. This is useful for tracking multiple contextual bits, such as putting username and IP into the log.

Setting the mapped values:

MDC.put("userIP", req.getRemoteAddr());
MDC.put("userName", foo.getName());
log.info("success");

Example MDC log4j pattern

Uppercase X with the example "userIP" and "userName" strings. These must match in your code and in the log4j config:

log4j.appender.CA.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss.SSSS} %p %X{userIP}  %C %X{userName} = %m%n

I would combine these into one )context string*.

Similarities and Differences

In both cases, whenever you do the log.info("success");, the output will have the additional context you have provided. This is much cleaner than concatenating strings like log.info(req.getRemoteAddr()) + " success"); every time you log.

Note that there are serious differences between the two with respect to threading and resources. In particular, NDC will keep handles to your threads which can affect the freeing of resources if you are not diligent about popping and clearing the NDC stack.

From the link: NDC use can lead to memory leaks if you do not periodically call the NDC.remove() method.

1
  • 10
    "...and when processing is complete you can pop it to see the former value." This could be a little misleading, because each time you push something to the NDC it gets appended to what's already there, and when it's popped it's removed. e.g. if the NDC contains 'foo' and you push 'bar', log output will include 'foo bar' until you pop, after which it will only include 'foo'. This is fundamental to NDC being useful.
    – Jeremy
    Commented Sep 22, 2014 at 8:07
8

MDC allows you to add custom tags for log4j. eg:

%X{mytag} in log4j.xml

is referenced by

MDC.put("mytag","StackOverflow");

MDC child thread automatically inherits a copy of the mapped diagnostic context of its parent.

NDC operations such as push, pop, clear, getDepth and setMaxDepth affect the NDC of the current thread only.

0

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.