NLog 4.6.0

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.Asp.NET Core

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

Release Notes

## All changes NLog 4.6

### Features

#### Main Feature

* Database target: support for DbType for parameters (including SqlDbType) - #2363 + #2899 + #3085 + #3091 (@hubo0831, @ObikeDev, @sorvis, @304NotModified, @snakefoot)

#### XML config features

* Added support for constant variable in level attributes - #2709  (level, minlevel, etc) (@304NotModified)
* Added defaultAction option for <filter> - #2848 (@304NotModified)
* Rules now support multiple '*' and '?' wildcards and in any position - #3098   (@beppemarazzi)
* Added Support ${currentdir}, ${basedir}, ${tempdir} and environment variables in internalLogFile value - #3031 + #3092  (@snakefoot)

#### New targets, layouts and layout renderers

* Added XmlLayout - Render LogEventInfo.Properties as XML - #2670 + #3014 (@snakefoot)
* Added ${db-null} layout renderer - #2849  (@304NotModified)
* Added New ${substring}, ${left} & ${right} layoutrenderer wrappers - #2907  (@304NotModified)
* Added ${HostName} Layout Renderer for full computer DNS name - #3071  (@amitsaha)
* Added ${AppSetting} Layout Renderer (app.config + web.config) moved from NLog.Extended for NetFramework - #3053  (@snakefoot)
* Added noRawValue layout wrapper - #3165  (@snakefoot)

#### Additions to targets, layouts and layout renderers

* AsyncTargetWrapper: added LogEventDropped + LogEventQueueGrow events - #2610 (@Pomoinytskyi)
* NetworkTarget - Support for SSL & TLS - #2678 (@snakefoot)
* JsonLayout: support for System.Dynamic-objects - #2902  (@304NotModified)
* AsyncTaskTarget: Added support for BatchSize and RetryCount  - #2909  (@snakefoot)
* ColoredConsoleTarget - Added EnableAnsiOutput option (VS Code support) - #3018  (@jp7677 + @snakefoot)
* Added IncludeGdc property in JsonLayout - #3050  (@casperc89)
* TargetWithContext - Support for PropertyType using IRawValue-interface - #3060  (@snakefoot)

### Enhancements

* JsonLayout includes Type-property when rendering Exception-object - #2989 (@snakefoot)
* LoggingConfigurationParser - Extracted from XmlLoggingConfiguration - #2891 (Prepare for appsettings.json)  (@snakefoot)
* Added support for complex objects in MDLC and NDLC on Net45 - #2910  (@snakefoot)
* PerformanceCounter - Improve behavior for CPU usage calculation - #2918  (@snakefoot)
* TargetWithContext - Include all properties even when duplicate names - #2941  (@snakefoot)
* Updated resharper annotations for better validation - #2974 (@imanushin)
* Improve default reflection support on .NET Core Native - #2979 (@snakefoot)
* EventLogTarget with better support for MaximumKilobytes configuration - #3017 (@Coriolanuss)
* Added Xamarin PreserveAttribute for the entire Assembly to improve AOT-linking - #3039 (@snakefoot)
* Create snupkg packages and use portable PDB - #3045 (@snakefoot)
* KeepFileOpen + ConcurrentWrites on Xamarin + UWP - #3079 - #3048 (@304NotModified)
* WebService Target allow custom override of SoapAction-header for Soap11 - #3082 + #3100 (@AlexeyRokhin)
* AsyncTaskTarget - Fixed unwanted delay caused by slow writer
* Various refactorings (19 pull requests) (@beppemarazzi, @304NotModified, @snakefoot)

### Performance

* AsyncTargetWrapper using ConcurrentQueue for .NET Core 2 for better thread-concurrency - #2650 (@snakefoot)
* AsyncTargetWrapper - TimeToSleepBetweenBatches changed default to 1ms - #2890 (@snakefoot)
* InternalLogger performance optimization when LogLevel.Off - #2897 (@snakefoot)
* InternalLogger LogLevel changes to LogLevel.Off by default unless being used. - #2935 (@snakefoot)
* CsvLayout - Allocation optimizations and optional skip quoting-check for individual columns. - #2934 (@snakefoot)
* MappedDiagnosticsLogicalContext - SetScoped with IReadOnlyList (Prepare for MEL BeginScope) - #2949 (@snakefoot)
* IRenderString-interface to improve performance for Layout with single LayoutRenderer - #2973 (@snakefoot)
* StringBuilderPool - Reduce memory overhead until required - #3103 (@snakefoot)

**LibLog Breaking change**

* [damianh/LibLog#181](https://github.com/damianh/LibLog/pull/181) - Sub-components using LibLog ver. 5.0.3 (or newer) will now use MDLC + NDLC (Instead of MDC + NDC) when detecting application is using NLog ver. 4.6. Make sure to update NLog.config to match this change. Make sure that all sub-components have upgraded to LibLog ver. 5.0.3 (or newer) if they make use of `OpenNestedContext` or `OpenMappedContext`.

See also [NLog 4.6 Milestone](https://github.com/NLog/NLog/milestone/44?closed=1)

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
ServiceStack/ServiceStack
Thoughtfully architected, obscenely fast, thoroughly enjoyable web services for all
Sonarr/Sonarr
Smart PVR for newsgroup and bittorrent users.
JustArchiNET/ArchiSteamFarm
C# application with primary purpose of idling Steam cards from multiple accounts simultaneously.
EventStore/EventStore
The stream database optimised for event sourcing
Radarr/Radarr
A fork of Sonarr to work with movies à la Couchpotato.
Jackett/Jackett
API Support for your favorite torrent trackers.
Topshelf/Topshelf
An easy service hosting framework for building Windows services using .NET
dotnetcore/Util
Util是一个.net core平台下的应用框架,旨在提升小型团队的开发输出能力,由常用公共操作类(工具类)、分层架构基类、Ui组件,第三方组件封装,第三方业务接口封装,配套代码生成模板,权限等组成。

Version History

Version Downloads Last updated
4.6.7 89,317 8/25/2019
4.6.6 308,283 7/14/2019
4.6.5 375,844 6/14/2019
4.6.4 426,985 5/28/2019
4.6.3 495,843 4/30/2019
4.6.2 428,286 4/2/2019
4.6.1 60,336 3/29/2019
4.6.0 174,916 3/21/2019
4.5.11 2,764,998 11/6/2018
4.5.10 1,787,955 9/17/2018
4.5.9 550,579 8/24/2018
4.5.8 797,801 8/5/2018
4.5.7 392,954 7/19/2018
4.5.6 1,140,149 5/29/2018
4.5.5 288,129 5/25/2018
4.5.4 912,070 5/5/2018
4.5.3 516,010 4/16/2018
4.5.2 459,564 4/6/2018
4.5.1 125,425 4/3/2018
4.5.0 1,100,982 3/25/2018
4.4.13 362,099 2/27/2018
4.4.12 2,818,098 8/8/2017
4.4.11 793,712 6/17/2017
4.4.10 229,190 5/31/2017
4.4.9 548,912 5/5/2017
4.4.8 89,813 4/28/2017
4.4.7 67,692 4/25/2017
4.4.6 173,434 4/15/2017
4.4.5 261,078 3/28/2017
4.4.4 278,371 3/10/2017
4.4.3 416,260 2/17/2017
4.4.2 214,258 2/6/2017
4.4.1 618,141 12/24/2016
4.4.0 184,483 12/14/2016
4.3.11 595,559 11/7/2016
4.3.10 383,374 10/11/2016
4.3.9 313,896 9/18/2016
4.3.8 383,430 9/5/2016
4.3.7 368,694 8/6/2016
4.3.6 179,886 7/23/2016
4.3.5 557,862 6/12/2016
4.3.4 456,571 5/16/2016
4.3.3 194,067 4/28/2016
4.3.2 59,798 4/26/2016
4.3.1 75,723 4/20/2016
4.3.0 64,317 4/16/2016
4.2.3 896,598 12/20/2015
4.2.2 164,009 12/2/2015
4.2.1 108,214 11/21/2015
4.2.0 255,352 10/24/2015
4.1.2 441,482 9/20/2015
4.1.1 77,342 9/12/2015
4.1.0 125,617 8/31/2015
4.0.1 471,075 6/18/2015
4.0.0 377,847 6/9/2015
3.2.1 458,481 4/24/2015
3.2.0 864,367 1/2/2015
3.1.0 889,478 6/24/2014
3.0.0 138,467 6/2/2014
2.1.0 747,987 10/10/2013
2.0.1.2 445,524 4/8/2013
2.0.0.2000 696,147 7/18/2011
1.0.0.505 134,214 1/7/2011
Show less