NLog - Advanced and Structured Logging for Various .NET Platforms

License: BSD-3-Clause

Language: C#

Keywords: c-sharp, csharp, logging, logging-library, netcore, netstandard, netstandard13, netstandard15, netstandard20, nlog, silverlight, structured-logging, uwp, xamarin


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

Project Statistics

Sourcerank 19
Repository Size 107 MB
Stars 4,181
Forks 1,101
Watchers 288
Open issues 176
Dependencies 38
Contributors 164
Tags 123
Last updated
Last pushed

Top Contributors See all

Julian Verdurmen Jarek Kowalski Kim Christensen Kim Christensen Rolf Kristensen Bernhard Häussermann Iraklis E. Uğur Aldanmaz Klaudiusz ilya-g kevindaub Gladiator Parth AndreGleichner Alex Gil Ivan Grbavac Christiaan van Bergen Inez Korczyński Michael Stefan de Vogelaere

Packages Referencing this Repo

NLog is a logging platform for .NET with rich log routing and management capabilities. It can hel...
Latest release 5.0.0-beta11 - Updated - 4.18K stars
Installs NLog snippets.
Latest release - Updated - 4.18K stars

Recent Tags See all

v4.6.8 November 04, 2019
v4.6.7 August 25, 2019
v4.6.6 July 14, 2019
v4.6.5 June 13, 2019
v4.6.4 May 28, 2019
v4.6.3 April 30, 2019
v4.6.2 April 02, 2019
v4.6.1 March 29, 2019
v4.6 March 20, 2019
v4.6-rc3 March 15, 2019
v4.6-rc2 March 10, 2019
V March 09, 2019
v4.6-rc1 February 08, 2019
v4.5.11 November 06, 2018
v4.5.10 September 17, 2018

Interesting Forks See all

NLog - Advanced .NET and Silverlight Logging
C# - BSD-3-Clause - Last pushed - 4 stars
NLog - Advanced .NET, Silverlight and Xamarin Logging
C# - Last pushed - 2 stars
NLog - Advanced .NET and Silverlight Logging
C# - BSD-3-Clause - Last pushed - 1 stars
NLog - Advanced .NET, NETSTANDARD, Silverlight and Xamarin Logging
C# - Updated - 1 stars
NLog - Advanced .NET, Silverlight and Xamarin Logging
C# - Updated - 1 stars

Something wrong with this page? Make a suggestion

Last synced: 2019-11-04 22:18:53 UTC

Login to resync this repository