Skip to content
NLog - Advanced and Structured Logging for Various .NET Platforms
C# XSLT PowerShell Vim Snippet Perl CSS
Branch: dev
Clone or download

Latest commit

304NotModified Drop Silverlight & Windows Phone support. Xamarin support now only wi…
…th .NET Standard. Removed loading for Xamarin assets (#3978)

* Drop Silverlight, Windows Phone support, Xamarin support now only with .NET Standard

* undo formatting changes for Logger-V1Compat.cs

Latest commit 733ce6e May 31, 2020


Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Added .NET Core 3 to issue template (#3876) Apr 1, 2020
examples Hyperlinks to https:/ Feb 21, 2019
src Drop Silverlight & Windows Phone support. Xamarin support now only wi… May 30, 2020
tests Drop Silverlight & Windows Phone support. Xamarin support now only wi… May 30, 2020
tools Merge branch 'master' into nlog-4.7.2-to-dev May 18, 2020
.bettercodehub.yml Better config Better Code Hub Dec 2, 2017
.editorconfig Add .editorconfig Jan 5, 2015
.gitattributes Specified in .gitattributes which files should be considered as text … Feb 14, 2015
.gitignore Add dotsettings - sharing Resharper settings May 10, 2019
.travis.yml If Load of Extension-Assembly fails, try AppDomain before rethrowing … Feb 12, 2020 Version 4.7.2 (#3968) May 18, 2020 Create Mar 27, 2019
LICENSE.txt Update copyright to 2020 (#3795) Feb 4, 2020 Drop NLog.Extended, Introduce NLog.MSMQ (#3371) May 6, 2019 Update Dec 13, 2019 Update Security Policy May 28, 2020
Test-XmlFile.ps1 XSD test for NLog.Schema (#3487) Jun 13, 2019
appveyor.yml Version 4.7.1 (#3924) May 15, 2020
build.ps1 Drop Silverlight & Windows Phone support. Xamarin support now only wi… May 30, 2020 Rename to Mar 22, 2017 Merge master Apr 24, 2015 Create Jun 22, 2019
run-tests.ps1 Drop old Sonar and Open cover integration (#3736) Dec 27, 2019


NuGet Semantic Versioning Twitter Follow


NLog is a free 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.

It can process diagnostic messages emitted from any .NET language, augment them with contextual information, format them according to your preference and send them to one or more targets such as file or database.

Major and minor releases will be posted on project news. For smaller updates, follow us on Twitter

Getting started

For the possible options in the config, check the Options list

Having troubles? Check the troubleshooting guide

ℹ️ Looking for NLog 5? Just install NLog 4.5+!

NLog 4.5 implements the platforms added in NLog 5 (.NET Standard 1, .NET Standard 2, UWP, etc) and added structural logging, without breaking changes!

NLog Packages

NLog consists of multiple packages. Most of the functionality is inside the NLog (core) package. What's inside the packages? See targets and layout renderers overview!

See Nuget/build status of all official packages here

Questions, bug reports or feature requests?

Issues with getting it working? Please check the troubleshooting guide before asking! With a clear error message, it's really easier to solve the issue!

Unclear how to configure NLog correctly of other questions? Please post questions on StackOverflow.

Do you have feature request or would you like to report a bug? Please post them on the issue list and follow these guidelines.

Frequently Asked Questions (FAQ)

See FAQ on the Wiki


As the current NLog team is a small team, we cannot fix every bug or implement every feature on our own. So contributions are really appreciated!

If you like to start with a small task, then up-for-grabs are nice to start with.

A good way to get started (flow)

  1. Fork the NLog repos.
  2. Create a new branch in you current repos from the 'dev' branch. (critical bugfixes from 'master')
  3. 'Check out' the code with Git or GitHub Desktop
  4. Check
  5. Push commits and create a Pull Request (PR) to NLog


NLog is open source software, licensed under the terms of BSD license. See LICENSE.txt for details.

How to build

Use Visual Studio 2017 and open the solution 'NLog.sln' - C# 7.2 support is required.

For building in the cloud we use:

  • AppVeyor for Windows builds, including Silverlight and Xamarin.
  • Travis for Mono builds.
  • CodeCov for code coverage

Trying to build your fork in the cloud? Check this how-to

You can’t perform that action at this time.