NLog 2.0 Beta 1 Release Notes

NLog 2.0 Beta 1 has been released and is available for download from

What is NLog? NLog is a popular logging platform for .NET 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), improving logging architecture and manageability and addressing most frequently reported user issues.

Platform support

The following platforms are supported:

  • .NET Framework 2.0 SP1 and above, 3.5 (Client and Extended profiles), 4.0 (Client and Extended profiles)
  • Silverlight 2.0, 3.0, 4.0
  • .NET Compact Framework 2.0, 3.5
  • Mono 2.x profile

Support for .NET 1.x, .NET Compact Framework 1.0 has been removed in this release.

New features

  • Support for .NET client and extended profile. All features which require .NET Extended profile have been moved to a separate assembly called NLog.Extended.dll. See the NLog.Extended project on GitHub for more details.
  • NLogTraceListener for integrating with System.Diagnostics Trace and TraceSource APIs
  • Wrapper layout renderers which modify output of other layout renderers.
  • Merged NLog.ComInterop into NLog.dll itself, which means one less DLL to deploy when using NLog through COM.
  • GetCurrentClassLogger() is now supported in .NET Compact Framework.
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)
  • Lambda-based delayed message computation:
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);

Target updates

  • Added WCF-based LogReceiverService target, for communicating between client which uses NLog and server. See examples on GitHub:
  • Update scrolling RichTextBox target - auto scroll, length limit, height and width configuration.
  • Database target enhancements: support for installation and uninstallation, named connection strings from the configuration file.
  • Mail target now supports enableSsl flag for communicating with SMTP server over SSL.

Architectural updates

  • NLog codebase has been cleaned up and upgraded to C# 3.0.
  • Entire codebase passes StyleCop and FxCop analysis with relatively few exclusions.
  • Added unit test coverage for new and refactored code.
  • Nightly builds available in the Download section.
  • Programmatic configuration API has been cleaned up to reduce coupling between components and improve maintainability.
  • Directory and namespace structure cleanup
  • MSI-based installer.
  • Robustness fixes - centralized and unified handling of exceptions.
  • Switched build system to MSBuild
  • Improved internal logging for better diagnostics.

Backwards compatibility and breaking changes

Logging API and configuration file are generally backwards compatible, but programmatic configuration APIs are not. In order to support new platforms and features, NLog codebase had to be refactored which in some cases introduced breaking changes. See NLog website for backwards compatibility and breaking change policy.

In addition to that, please refer to the following articles for information about further behavior changes: