NLog 2.0 RC Release Notes

NLog 2.0 Release Candidate (RC) has been released and is available for download from

What is NLog?

NLog is a popular logging platform for .NET, Silverlight and Windows Phone with rich log routing and management capabilities. It makes it easy to produce and manage high-quality logs for your application regardless of its size or complexity. NLog is open source software, distributed under the terms of BSD license and source is available on GitHub.

NLog 2.0 release is focused on adding support for new platforms (Silverlight, .NET Framework 4, Windows Phone 7.x), improving logging architecture and manageability and addressing most frequently reported user issues.

What’s - New in NLog 2.0

Since there is no StackTrace class in .NET Compact Framework, the implementation uses relatively slow method to get the calling class, so using it in a loop or performance-sensitive code is not recommended)
Logger logger = LogManager.GetCurrentClassLogger();
int i, j, k;

// message will not be computed if not necessary, thus helping improve performance when logs are disabled
logger.Info(() => "message" + i + ", " + j + "," + k);

In addition to those, lots of work went into raising the quality bar of NLog:

Target updates


This release of NLog adds compatibility with several new platforms.

NLogC component is supported on .NET Framework 4.0 only. NLog.ComInterop component is supported on all versions of .NET Framework. Compatibility with .NET Framework 1.x and .NET Compact Framework has been removed.

Backwards compatibility and breaking change policy

NLog v2.0 maintains backwards compatibility with: * existing NLog.config files * client code using Logger, LogManager, LoggerFactory, GDC, MDC, NDC and LogEventInfo classes

As a rule of thumb, existing code that does not rely on programmatic configuration or manipulation of NLog internal objects will continue to work with NLog v2.0. Majority of applications and components fall into this category and should be easily portable to NLog v2.0 without or with minimal changes.

Code which uses programmatic configuration will typically require modifications related to namespace reorganization.

Full breaking change policy can be viewed here.

Community support

Community support for NLog 2.0 is available through discussion forum at

Bugs and other issues can be filed via issue tracker on CodePlex site.

At this time NLog project is not accepting source code contributions from the community. Users can help shape future releases by reporting bugs, suggesting new features and participating in community discussion on NLog forum.

Known issues

comments powered by Disqus
keyboard-centric bug tracker continuous integration server