NLog 4.6.8

NLog is a logging platform for .NET with rich log routing and management capabilities.
NLog supports traditional logging, structured logging and the combination of both.

Supported platforms:

- .NET Framework 3.5, 4, 4.5, 4.6, 4.7 & 4.8
- .NET Standard 1.3+ and 2.0+;
- .NET Framework 4 client profile
- Xamarin Android, Xamarin iOs
- UWP
- Windows Phone 8
- Silverlight 4 and 5
- Mono 4

For ASP.NET Core, check: NLog.Web.AspNetCore

There is a newer prerelease version of this package available.
See the version list below for details.
Install-Package NLog -Version 4.6.8
dotnet add package NLog --version 4.6.8
<PackageReference Include="NLog" Version="4.6.8" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add NLog --version 4.6.8
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Release Notes

## Bugfixes
- DatabaseTarget - Auto escape special chars in password, and improve handling of empty username/password (@304NotModified)
- LoggingRule - Fixed IndexOutOfRangeException for SetLoggingLevels with LogLevel.Off (@snakefoot)
- FileTarget - Improved handling of relative path in ArchiveFileName (@snakefoot)
- ExceptionLayoutRenderer - Fixed missing separator when Format-value gives empty result (@brinko99)
- ${substring} - Length should not be mandatory (@304NotModified)
- SimpleLayout - Fixed NullReferenceException in PreCalculate during TryGetRawValue optimization (@snakefoot)

## Features
- LogFactory - AutoShutdown can be configured to unhook from AppDomain-Unload, and avoid premature shutdown with IHostBuilder (@snakefoot)
- PerformanceCounterLayoutRenderer - Added Layout-support for Instance-property (@snakefoot)
- ${local-ip} Layout Renderer for local machine ip-address (@snakefoot + @304NotModified)
- CachedLayoutRendererWrapper - Added CachedSeconds as ambient property. Ex. ${local-ip:cachedSeconds=60} (@snakefoot)
- JsonLayout - Added EscapeForwardSlash-option to skip Json-escape of forward slash (@304NotModified)
- AllEventPropertiesLayoutRenderer - Added Exclude-option that specifies property-keys to skip (@snakefoot)
- ${Exception} - Added new Format-option values HResult and Properties (@snakefoot)

## Improvements
- ConcurrentRequestQueue refactoring to reduce code complexity (@snakefoot)
- AsyncTargetWrapper now fallback to clearing internal queue if flush fails to release blocked writer threads (@snakefoot)
- ${CallSite} - Small improvements for recognizing async callsite cases (@snakefoot)
- LogManager.GetCurrentClassLogger - Improved capture of Logger name when called within lambda_method (@snakefoot)
- ${BaseDir=FixTempDir=true} fallback to process directory for .NET Core 3 Single File Publish (@snakefoot)
- Auto-loading NLog configuration from process.exe.nlog will priotize process directory for .NET Core 3 Single File Publish (@snakefoot)
- ObjectPathRendererWrapper minor refactorings (@snakefoot)
- ObjectHandleSerializer.GetObjectData includes SerializationFormatter=true for use in MDLC + NDLC (@snakefoot)
- FileTarget - Extra logging when FileName Layout renders empty string (@snakefoot)      

## Performance
- LogFactory - Faster initial assembly reflection and config loading (@snakefoot)
- ConsoleTarget - Added WriteBuffer option that allows batch writing to console-stream with reduced allocations (@snakefoot)
- ConsoleTarget - Added global lock to prevent any threadsafety issue from unsafe console (@snakefoot)

Full changelog: https://github.com/NLog/NLog/blob/master/CHANGELOG.md

For all config options and platform support, check https://nlog-project.org/config/

Showing the top 10 GitHub repositories that depend on NLog:

Repository Stars
shadowsocks/shadowsocks-windows
If you want to keep a secret, you must also hide it from yourself.
Wox-launcher/Wox
Launcher for Windows, an alternative to Alfred and Launchy.
dotnet/AspNetCore.Docs
Documentation for ASP.NET Core
Sonarr/Sonarr
Smart PVR for newsgroup and bittorrent users.
JustArchiNET/ArchiSteamFarm
C# application with primary purpose of idling Steam cards from multiple accounts simultaneously.
ServiceStack/ServiceStack
Thoughtfully architected, obscenely fast, thoroughly enjoyable web services for all
Jackett/Jackett
API Support for your favorite torrent trackers.
Radarr/Radarr
A fork of Sonarr to work with movies à la Couchpotato.
microsoft/ApplicationInspector
A source code analyzer built for surfacing features of interest and other characteristics to answer the question 'what's in it' using static analysis with a json based rules engine. Ideal for scanning components before use or detecting feature level changes.
QuantConnect/Lean
Lean Algorithmic Trading Engine by QuantConnect (C#, Python, F#)

Read more about the GitHub Usage information on our documentation.

Version History

Version Downloads Last updated
4.7.0-rc1 455 2/22/2020
4.6.8 977,539 11/4/2019
4.6.7 1,759,498 8/25/2019
4.6.6 834,588 7/14/2019
4.6.5 1,053,551 6/14/2019
4.6.4 958,854 5/28/2019
4.6.3 852,198 4/30/2019
4.6.2 671,504 4/2/2019
4.6.1 91,973 3/29/2019
4.6.0 293,373 3/21/2019
4.5.11 4,110,645 11/6/2018
4.5.10 2,385,968 9/17/2018
4.5.9 711,554 8/24/2018
4.5.8 996,334 8/5/2018
4.5.7 503,253 7/19/2018
4.5.6 1,430,342 5/29/2018
4.5.5 363,237 5/25/2018
4.5.4 1,162,826 5/5/2018
4.5.3 652,578 4/16/2018
4.5.2 550,189 4/6/2018
4.5.1 158,392 4/3/2018
4.5.0 1,631,928 3/25/2018
4.4.13 426,046 2/27/2018
4.4.12 3,337,010 8/8/2017
4.4.11 896,032 6/17/2017
4.4.10 247,669 5/31/2017
4.4.9 624,323 5/5/2017
4.4.8 98,334 4/28/2017
4.4.7 74,890 4/25/2017
4.4.6 195,893 4/15/2017
4.4.5 290,009 3/28/2017
4.4.4 328,831 3/10/2017
4.4.3 462,625 2/17/2017
4.4.2 242,047 2/6/2017
4.4.1 684,525 12/24/2016
4.4.0 201,015 12/14/2016
4.3.11 665,730 11/7/2016
4.3.10 416,585 10/11/2016
4.3.9 339,331 9/18/2016
4.3.8 427,611 9/5/2016
4.3.7 402,868 8/6/2016
4.3.6 192,806 7/23/2016
4.3.5 608,729 6/12/2016
4.3.4 502,076 5/16/2016
4.3.3 227,360 4/28/2016
4.3.2 65,022 4/26/2016
4.3.1 79,499 4/20/2016
4.3.0 75,682 4/16/2016
4.2.3 980,148 12/20/2015
4.2.2 180,734 12/2/2015
4.2.1 116,125 11/21/2015
4.2.0 278,846 10/24/2015
4.1.2 481,692 9/20/2015
4.1.1 87,119 9/12/2015
4.1.0 135,332 8/31/2015
4.0.1 511,974 6/18/2015
4.0.0 444,728 6/9/2015
3.2.1 525,015 4/24/2015
3.2.0 941,595 1/2/2015
3.1.0 967,808 6/24/2014
3.0.0 151,402 6/2/2014
2.1.0 813,013 10/10/2013
2.0.1.2 465,566 4/8/2013
2.0.0.2000 740,380 7/18/2011
1.0.0.505 151,144 1/7/2011
Show less