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
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#)
Topshelf/Topshelf
An easy service hosting framework for building Windows services using .NET

Read more about the GitHub Usage information on our documentation.

Version History

Version Downloads Last updated
4.6.8 530,923 11/4/2019
4.6.7 1,357,706 8/25/2019
4.6.6 735,709 7/14/2019
4.6.5 926,180 6/14/2019
4.6.4 866,528 5/28/2019
4.6.3 780,325 4/30/2019
4.6.2 625,916 4/2/2019
4.6.1 86,371 3/29/2019
4.6.0 271,189 3/21/2019
4.5.11 3,840,792 11/6/2018
4.5.10 2,264,436 9/17/2018
4.5.9 676,597 8/24/2018
4.5.8 952,065 8/5/2018
4.5.7 472,411 7/19/2018
4.5.6 1,374,125 5/29/2018
4.5.5 346,730 5/25/2018
4.5.4 1,110,805 5/5/2018
4.5.3 612,602 4/16/2018
4.5.2 531,256 4/6/2018
4.5.1 151,890 4/3/2018
4.5.0 1,525,336 3/25/2018
4.4.13 412,485 2/27/2018
4.4.12 3,236,279 8/8/2017
4.4.11 876,381 6/17/2017
4.4.10 244,019 5/31/2017
4.4.9 605,570 5/5/2017
4.4.8 96,690 4/28/2017
4.4.7 73,324 4/25/2017
4.4.6 191,085 4/15/2017
4.4.5 284,932 3/28/2017
4.4.4 319,695 3/10/2017
4.4.3 452,499 2/17/2017
4.4.2 235,313 2/6/2017
4.4.1 669,133 12/24/2016
4.4.0 197,701 12/14/2016
4.3.11 654,167 11/7/2016
4.3.10 409,529 10/11/2016
4.3.9 334,381 9/18/2016
4.3.8 419,147 9/5/2016
4.3.7 396,267 8/6/2016
4.3.6 190,143 7/23/2016
4.3.5 598,493 6/12/2016
4.3.4 492,069 5/16/2016
4.3.3 220,702 4/28/2016
4.3.2 63,917 4/26/2016
4.3.1 78,689 4/20/2016
4.3.0 72,710 4/16/2016
4.2.3 963,034 12/20/2015
4.2.2 177,480 12/2/2015
4.2.1 114,377 11/21/2015
4.2.0 274,313 10/24/2015
4.1.2 473,188 9/20/2015
4.1.1 85,105 9/12/2015
4.1.0 133,400 8/31/2015
4.0.1 504,137 6/18/2015
4.0.0 432,120 6/9/2015
3.2.1 513,129 4/24/2015
3.2.0 929,161 1/2/2015
3.1.0 951,687 6/24/2014
3.0.0 148,919 6/2/2014
2.1.0 799,197 10/10/2013
2.0.1.2 461,849 4/8/2013
2.0.0.2000 731,349 7/18/2011
1.0.0.505 147,153 1/7/2011
Show less