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

Install-Package NLog -Version 4.6.0

dotnet add package NLog --version 4.6.0

<PackageReference Include="NLog" Version="4.6.0" />

paket add NLog --version 4.6.0

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/

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.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.

Used By

NuGet packages (1.9K)

Showing the top 5 NuGet packages that depend on NLog:

Package	Downloads
NLog.Extensions.Logging NLog LoggerProvider for Microsoft.Extensions.Logging for logging in .NET Standard libraries and .NET Core applications. For ASP.NET Core, use NLog.Web.AspNetCore: https://www.nuget.org/packages/NLog.Web.AspNetCore	23.1M
NLog.Config NLog.config file to get started with configuring NLog. This package is not mandatory to get started with NLog: the configuration file can created manually (read specs here: https://github.com/NLog/NLog/wiki/Configuration-file) or the configuration can be created programmatically. (read more here: https://github.com/NLog/NLog/wiki/Configuration-API) Note: Unfortunately this package won't work well when using <PackageReference> Advised to: - download manually: https://raw.githubusercontent.com/NLog/NLog/dev/src/NuGet/NLog.Config/content/NLog.config - set "Copy To Output Directory" to "Copy if newer"	10.6M
Microsoft.ApplicationInsights.NLogTarget Application Insights NLog Target is a custom target allowing you to send NLog log messages to Application Insights. Application Insights will collect your logs from multiple sources and provide rich powerful search capabilities. Privacy statement: https://go.microsoft.com/fwlink/?LinkId=512156	4.1M
NLog.Web NLog logging for ASP.NET and ASP.NET MVC. Includes targets and layout renderers for websites and web applications. This package is for ASP.NET 3.5+ For ASP.NET Core: Check https://www.nuget.org/packages/NLog.Web.AspNetCore	2.8M
NLog.Extended NLog.Extended.dll provides MSMQ target and AppSetting renderer	2.3M

GitHub repositories (241)

Showing the top 5 popular 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.	51.4K
Wox-launcher/Wox Launcher for Windows, an alternative to Alfred and Launchy.	19.5K
files-community/Files A modern file explorer that pushes the boundaries of the platform.	6.7K
JustArchiNET/ArchiSteamFarm C# application with primary purpose of idling Steam cards from multiple accounts simultaneously.	6.1K
Sonarr/Sonarr Smart PVR for newsgroup and bittorrent users.	6.1K

Version History