NLog 4.6.0-rc3

NLog for .NET Framework and .NET Standard

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

This is a prerelease version of NLog.
There is a newer version of this package available.
See the version list below for details.
The owner has unlisted this package. This could mean that the package is deprecated or shouldn't be used anymore.
Install-Package NLog -Version 4.6.0-rc3
dotnet add package NLog --version 4.6.0-rc3
<PackageReference Include="NLog" Version="4.6.0-rc3" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add NLog --version 4.6.0-rc3
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Release Notes

## Changes since RC2

### Breaking

Oops, again a breaking change with the previous NLog 4.6 RC

- Database target: dropped UseRawValue option on parameters (introduced in NLog 4.6 RC1), introduced ${myRenderer:noRawValue=true} (@snakefoot)

Note, there are no breaking changes with NLog 4.5.11. Semver is important!

## 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)
* Various refactorings (15 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

Supported can be found on https://nlog-project.org/config/

Version History

Version Downloads Last updated
4.6.3 94,554 4/30/2019
4.6.2 170,536 4/2/2019
4.6.1 27,007 3/29/2019
4.6.0 82,492 3/21/2019
4.5.11 1,642,489 11/6/2018
4.5.10 1,287,627 9/17/2018
4.5.9 417,614 8/24/2018
4.5.8 634,158 8/5/2018
4.5.7 313,594 7/19/2018
4.5.6 920,917 5/29/2018
4.5.5 222,782 5/25/2018
4.5.4 725,348 5/5/2018
4.5.3 411,820 4/16/2018
4.5.2 381,441 4/6/2018
4.5.1 89,749 4/3/2018
4.5.0 732,371 3/25/2018
4.4.13 303,075 2/27/2018
4.4.12 2,416,209 8/8/2017
4.4.11 703,055 6/17/2017
4.4.10 204,773 5/31/2017
4.4.9 466,749 5/5/2017
4.4.8 74,791 4/28/2017
4.4.7 55,340 4/25/2017
4.4.6 149,304 4/15/2017
4.4.5 231,683 3/28/2017
4.4.4 238,437 3/10/2017
4.4.3 358,507 2/17/2017
4.4.2 191,347 2/6/2017
4.4.1 545,011 12/24/2016
4.4.0 162,803 12/14/2016
4.3.11 532,533 11/7/2016
4.3.10 348,533 10/11/2016
4.3.9 284,544 9/18/2016
4.3.8 342,329 9/5/2016
4.3.7 334,091 8/6/2016
4.3.6 162,418 7/23/2016
4.3.5 502,478 6/12/2016
4.3.4 399,730 5/16/2016
4.3.3 166,365 4/28/2016
4.3.2 48,887 4/26/2016
4.3.1 65,856 4/20/2016
4.3.0 49,485 4/16/2016
4.2.3 811,404 12/20/2015
4.2.2 145,364 12/2/2015
4.2.1 95,682 11/21/2015
4.2.0 219,136 10/24/2015
4.1.2 399,162 9/20/2015
4.1.1 63,355 9/12/2015
4.1.0 109,747 8/31/2015
4.0.1 432,002 6/18/2015
4.0.0 312,188 6/9/2015
3.2.1 388,391 4/24/2015
3.2.0 779,753 1/2/2015
3.1.0 810,685 6/24/2014
3.0.0 123,542 6/2/2014
2.1.0 694,070 10/10/2013
2.0.1.2 421,640 4/8/2013
2.0.0.2000 658,056 7/18/2011
1.0.0.505 113,510 1/7/2011
Show less