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: https://www.nuget.org/packages/NLog.Web.AspNetCore

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.
aspnet/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.
EventStore/EventStore
The stream database optimised for event sourcing
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.6.8 796,401 11/4/2019
4.6.7 1,612,173 8/25/2019
4.6.6 802,560 7/14/2019
4.6.5 1,010,201 6/14/2019
4.6.4 929,181 5/28/2019
4.6.3 827,725 4/30/2019
4.6.2 656,122 4/2/2019
4.6.1 90,471 3/29/2019
4.6.0 285,831 3/21/2019
4.5.11 4,018,945 11/6/2018
4.5.10 2,344,088 9/17/2018
4.5.9 701,238 8/24/2018
4.5.8 980,256 8/5/2018
4.5.7 493,337 7/19/2018
4.5.6 1,411,413 5/29/2018
4.5.5 357,082 5/25/2018
4.5.4 1,145,583 5/5/2018
4.5.3 636,654 4/16/2018
4.5.2 543,699 4/6/2018
4.5.1 156,588 4/3/2018
4.5.0 1,592,610 3/25/2018
4.4.13 421,156 2/27/2018
4.4.12 3,300,064 8/8/2017
4.4.11 888,787 6/17/2017
4.4.10 246,389 5/31/2017
4.4.9 617,405 5/5/2017
4.4.8 97,800 4/28/2017
4.4.7 74,350 4/25/2017
4.4.6 194,048 4/15/2017
4.4.5 288,033 3/28/2017
4.4.4 325,123 3/10/2017
4.4.3 459,086 2/17/2017
4.4.2 239,619 2/6/2017
4.4.1 679,355 12/24/2016
4.4.0 199,974 12/14/2016
4.3.11 661,545 11/7/2016
4.3.10 414,263 10/11/2016
4.3.9 337,511 9/18/2016
4.3.8 424,558 9/5/2016
4.3.7 400,588 8/6/2016
4.3.6 191,895 7/23/2016
4.3.5 605,292 6/12/2016
4.3.4 498,685 5/16/2016
4.3.3 225,315 4/28/2016
4.3.2 64,637 4/26/2016
4.3.1 79,179 4/20/2016
4.3.0 74,365 4/16/2016
4.2.3 974,149 12/20/2015
4.2.2 179,288 12/2/2015
4.2.1 115,523 11/21/2015
4.2.0 277,446 10/24/2015
4.1.2 478,607 9/20/2015
4.1.1 86,468 9/12/2015
4.1.0 134,579 8/31/2015
4.0.1 509,161 6/18/2015
4.0.0 440,366 6/9/2015
3.2.1 520,807 4/24/2015
3.2.0 937,296 1/2/2015
3.1.0 962,068 6/24/2014
3.0.0 150,444 6/2/2014
2.1.0 808,626 10/10/2013
2.0.1.2 464,280 4/8/2013
2.0.0.2000 736,870 7/18/2011
1.0.0.505 149,647 1/7/2011
Show less