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" />

paket add NLog --version 4.6.8

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/

Dependencies

• .NETFramework 3.5

  • No dependencies.

• .NETFramework 4.0 Client

  • No dependencies.

• .NETFramework 4.5

  • No dependencies.

• .NETStandard 1.3

  • Microsoft.Extensions.PlatformAbstractions (>= 1.0.0)
  • NETStandard.Library (>= 1.6.0)
  • System.ComponentModel.Primitives (>= 4.1.0)
  • System.ComponentModel.TypeConverter (>= 4.1.0)
  • System.Data.Common (>= 4.1.0)
  • System.Diagnostics.StackTrace (>= 4.0.1)
  • System.Net.NameResolution (>= 4.0.0)
  • System.Net.Requests (>= 4.0.11)
  • System.Reflection.TypeExtensions (>= 4.1.0)
  • System.Xml.XmlDocument (>= 4.0.1)

• .NETStandard 1.5

  • NETStandard.Library (>= 1.6.0)
  • System.ComponentModel.Primitives (>= 4.1.0)
  • System.ComponentModel.TypeConverter (>= 4.1.0)
  • System.Data.Common (>= 4.1.0)
  • System.Diagnostics.Process (>= 4.1.0)
  • System.Diagnostics.StackTrace (>= 4.0.1)
  • System.Diagnostics.TraceSource (>= 4.0.0)
  • System.IO.FileSystem.Watcher (>= 4.0.0)
  • System.Net.NameResolution (>= 4.0.0)
  • System.Net.Requests (>= 4.0.11)
  • System.Reflection.TypeExtensions (>= 4.1.0)
  • System.Runtime.Loader (>= 4.0.0)
  • System.Threading.Thread (>= 4.0.0)
  • System.Xml.XmlDocument (>= 4.0.1)

• .NETStandard 2.0

  • No dependencies.

• MonoAndroid 4.4

  • No dependencies.

• Silverlight 4.0

  • No dependencies.

• Silverlight 5.0

  • No dependencies.

• WindowsPhone 8.0

  • No dependencies.

• Xamarin.iOS 1.0

  • No dependencies.

GitHub Usage

Version History