NLog 4.7.0-rc1

This is a prerelease version of NLog.
There is a newer version of this package available.
See the version list below for details.
dotnet add package NLog --version 4.7.0-rc1
NuGet\Install-Package NLog -Version 4.7.0-rc1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="NLog" Version="4.7.0-rc1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add NLog --version 4.7.0-rc1
#r "nuget: NLog, 4.7.0-rc1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install NLog as a Cake Addin
#addin nuget:?package=NLog&version=4.7.0-rc1&prerelease

// Install NLog as a Cake Tool
#tool nuget:?package=NLog&version=4.7.0-rc1&prerelease

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

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp1.0 was computed.  netcoreapp1.1 was computed.  netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard1.3 is compatible.  netstandard1.4 was computed.  netstandard1.5 is compatible.  netstandard1.6 was computed.  netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net35 is compatible.  net40 was computed.  net40-client is compatible.  net403 was computed.  net45 is compatible.  net451 was computed.  net452 was computed.  net46 was computed.  net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed.  monoandroid44 is compatible. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Silverlight sl4 is compatible.  sl5 is compatible. 
Tizen tizen30 was computed.  tizen40 was computed.  tizen60 was computed. 
Universal Windows Platform uap was computed.  uap10.0 was computed. 
Windows Phone wp8 is compatible.  wp81 was computed. 
Xamarin.iOS xamarinios was computed.  xamarinios10 is compatible. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (12)

Showing the top 5 NuGet packages that depend on NLog:

Package Downloads
NLog.Config

Empty NLog.config file.

NLog.Extended

NLog.Extended.dll for use with .NET Framework Extended profile. Supports server-specific targets and other extensions.

Common.Logging.NLog20

Common.Logging library bindings for NLog 2.0 logging framework.

MediaBrowser.Common.Internal

Contains common components shared by Emby Theater and Emby Server. Not intended for plugin developer consumption.

le_nlog

le_nlog is now deprecated. Please use logentries.nlog instead

GitHub repositories (360)

Showing the top 5 popular GitHub repositories that depend on NLog:

Repository Stars
BeyondDimension/SteamTools
🛠「Watt Toolkit」是一个开源跨平台的多功能 Steam 工具箱。
rocksdanister/lively
Free and open-source software that allows users to set animated desktop wallpapers and screensavers powered by WinUI 3.
Jackett/Jackett
API Support for your favorite torrent trackers
Sonarr/Sonarr
Smart PVR for newsgroup and bittorrent users.
Radarr/Radarr
Movie organizer/manager for usenet and torrent users.
Version Downloads Last updated
5.0.0-beta11 16 3/8/2021
5.0.0-beta10 10 3/8/2021
5.0.0-beta09 5 3/8/2021
5.0.0-beta08 1 3/8/2021
5.0.0-beta07 44 3/8/2021
5.0.0-beta06 7 3/8/2021
5.0.0-beta05-test 0 3/8/2021
5.0.0-beta05 7 3/8/2021
5.0.0-beta04 4 3/8/2021
5.0.0-beta03-tryoutMutex 0 3/8/2021
5.0.0-beta03 26 3/8/2021
5.0.0-beta02 0 3/8/2021
5.0.0-beta01 1 3/8/2021
4.7.11 65 9/19/2022
4.7.8 0 3/8/2021
4.7.7 0 3/8/2021
4.7.6 32,420 3/8/2021
4.7.5 0 3/8/2021
4.7.4 0 3/8/2021
4.7.3 0 3/8/2021
4.7.2 0 3/8/2021
4.7.1 0 3/8/2021
4.7.0 0 3/8/2021
4.7.0-rc1 0 3/8/2021
4.6.8 9 3/8/2021
4.6.7 3 3/8/2021
4.6.6 0 3/8/2021
4.6.5 1 3/8/2021
4.6.4 0 3/8/2021
4.6.3 2 3/8/2021
4.6.2 0 3/8/2021
4.6.1 0 3/8/2021
4.6.0 0 3/8/2021
4.6.0-rc3 0 3/8/2021
4.6.0-rc2 0 3/8/2021
4.6.0-rc1 0 3/8/2021
4.5.11 3 3/8/2021
4.5.10 5 3/8/2021
4.5.9 0 3/8/2021
4.5.8 0 3/8/2021
4.5.7 0 3/8/2021
4.5.6 1 3/8/2021
4.5.5 0 3/8/2021
4.5.4 9,461 3/8/2021
4.5.3 4 3/8/2021
4.5.2 0 3/8/2021
4.5.1 0 3/8/2021
4.5.0 2 3/8/2021
4.5.0-rc07 0 3/8/2021
4.5.0-rc06 0 3/8/2021
4.5.0-rc05 0 3/8/2021
4.5.0-rc04 0 3/8/2021
4.5.0-rc03 0 3/8/2021
4.5.0-rc02 0 3/8/2021
4.5.0-rc01 0 3/8/2021
4.5.0-beta08 0 3/8/2021
4.5.0-beta07 0 3/8/2021
4.5.0-beta06 0 3/8/2021
4.5.0-beta05 0 3/8/2021
4.5.0-beta04 0 3/8/2021
4.5.0-beta03 0 3/8/2021
4.5.0-beta02 2 3/8/2021
4.5.0-beta01 0 3/8/2021
4.5.0-alpha04 0 3/8/2021
4.5.0-alpha03 0 3/8/2021
4.5.0-alpha02 0 3/8/2021
4.5.0-alpha01 0 3/8/2021
4.4.13 0 3/8/2021
4.4.12 101 3/8/2021
4.4.11 35 3/8/2021
4.4.10 15 3/8/2021
4.4.9 30 3/8/2021
4.4.8 0 3/8/2021
4.4.7 1 3/8/2021
4.4.6 17 3/8/2021
4.4.6-rc1 0 3/8/2021
4.4.6-beta3 0 3/8/2021
4.4.6-beta2 0 3/8/2021
4.4.6-beta1 0 3/8/2021
4.4.5 16 3/8/2021
4.4.5-beta1 0 3/8/2021
4.4.4 9 3/8/2021
4.4.3 8 3/8/2021
4.4.2 9 3/8/2021
4.4.2-rc2 0 3/8/2021
4.4.2-rc1 0 3/8/2021
4.4.1 51 3/8/2021
4.4.1-dev-b4085 0 3/8/2021
4.4.1-dev-b4084 0 3/8/2021
4.4.0 24 3/8/2021
4.4.0-rc2 0 3/8/2021
4.4.0-rc1 0 3/8/2021
4.4.0-betaV15 3 3/8/2021
4.4.0-betaV14 2 3/8/2021
4.4.0-beta9 0 3/8/2021
4.4.0-beta8 0 3/8/2021
4.4.0-beta7 0 3/8/2021
4.4.0-beta6 0 3/8/2021
4.4.0-beta5 0 3/8/2021
4.4.0-beta4 0 3/8/2021
4.4.0-beta3 0 3/8/2021
4.4.0-beta2 0 3/8/2021
4.4.0-beta13 6 3/8/2021
4.4.0-beta12 2 3/8/2021
4.4.0-beta11 0 3/8/2021
4.4.0-beta10 0 3/8/2021
4.4.0-beta1 0 3/8/2021
4.4.0-beta-14 4 3/8/2021
4.4.0-alpha4 0 3/8/2021
4.4.0-alpha3 0 3/8/2021
4.4.0-alpha2 0 3/8/2021
4.4.0-alpha1 0 3/8/2021
4.3.11 46 3/8/2021
4.3.10 36 3/8/2021
4.3.9 12 3/8/2021
4.3.9-test-retry-archive 0 3/8/2021
4.3.8 21 3/8/2021
4.3.7 22 3/8/2021
4.3.6 2 3/8/2021
4.3.5 33 3/8/2021
4.3.5-alpha1 0 3/8/2021
4.3.4 32 3/8/2021
4.3.3 2 3/8/2021
4.3.2 8 3/8/2021
4.3.1 2 3/8/2021
4.3.1-rc1 0 3/8/2021
4.3.0 6 3/8/2021
4.3.0-rc3 0 3/8/2021
4.3.0-rc2 0 3/8/2021
4.3.0-rc1 0 3/8/2021
4.3.0-beta3 0 3/8/2021
4.3.0-beta2 0 3/8/2021
4.3.0-beta1 0 3/8/2021
4.3.0-alpha4 0 3/8/2021
4.3.0-alpha3 790 12/6/2015
4.3.0-alpha2 916 11/19/2015
4.3.0-alpha1 784 11/3/2015
4.2.3 1,927 3/8/2021
4.2.2 22,328 12/2/2015
4.2.1 18,730 11/21/2015
4.2.1-rc1 179 11/13/2015
4.2.0 45,526 10/24/2015
4.1.2 62,152 9/20/2015
4.1.1 18,695 9/12/2015
4.1.1-rc1 204 9/12/2015
4.1.0 30,971 8/31/2015
4.1.0-rc1 533 8/26/2015
4.1.0-alpha1 1,033 8/7/2015
4.0.1 119,032 6/18/2015
4.0.0 29,485 6/9/2015
4.0.0-rc 1,222 5/25/2015
3.2.1 92,150 4/24/2015
3.2.0 348,986 1/2/2015
3.1.0 454,335 6/24/2014
3.0.0 70,478 6/2/2014
2.1.0 296,683 10/10/2013
2.0.1.2 283,991 4/8/2013
2.0.0.2000 406,009 7/18/2011
1.0.0.505 30,523 1/7/2011

## Bugfixes
- LogFactory - Fix deadlock issue with AutoReload (@snakefoot)
- JsonLayout - Fixed ThreadAgnostic to correctly capture context when using nested JsonLayout (@snakefoot)
- ExceptionLayoutRenderer - Fixed so Format option HResult also works for NetCore (@snakefoot)
- Log4JXml Layout - Render NDLC + NDC scopes in correct order (@adanek + @304NotModified)

## Features
- LogManager.Setup() allows fluent configuration of LogFactory options (@snakefoot + @304NotModified)
- LogManager.Setup().SetupSerialization(s => s.RegisterObjectTransformation(...)) for overriding default property reflection (@snakefoot + @304NotModified + @Giorgi + @mmurrell)
- LogManager.Setup().SetupSerialization(s => s.RegisterConditionMethod(...)) can use lambda methods and not just static methods (@snakefoot)
- ${level:format=FullName} will expand Info + Warn to their full name (@snakefoot)
- FileTarget - Supports MaxArchiveDays for cleanup of old files based on their age (@snakefoot)
- Layout.FromMethod to create Layout directly from a lambda method (@snakefoot)
- Layout.FromString to create Layout directly from string along with optional parser validation (@snakefoot)
- ${dir-separator} for rendering platform specific directory path separator (@304NotModified)
- FileTarget - Supports ArchiveOldFileOnStartupAboveSize for cleanup of existing file when above size (@Sam13)

## Improvements
- XmlLoggingConfiguration - Marked legacy constructors with ignoreErrors parameter as obsolete (@snakefoot)
- LoggingConfiguration - Perform checking of unused targets during initialization for better validation (@snakefoot)
- EventLogTarget - Improve diagnostics logging when using dynamic EventLog source (@snakefoot)
- ${longdate} now also supports raw value for use as DatabaseTarget parameter with DbType (@snakefoot)
- SourceLink for GitHub for easy debugging into the NLog source code (@304NotModified)
- JsonLayout - EscapeForwardSlash now automatically applies to sub-attributes (@snakefoot)
- TraceTarget - Introduced EnableTraceFail=false to avoid Environment.FailFast (@snakefoot)
- ExceptionLayoutRenderer - Improved error message when Format-token parsing fails (@snakefoot)
- AutoFlushWrapper - Set AutoFlush=false for AsyncTaskTarget by default (@snakefoot)
- LocalIpAddressLayoutRenderer - Higher priority to network-addresses that has valid gateway adddress (@snakefoot)
- LogFactory - LogFactory - Flush reports to InternalLogger what targets produces timeouts (@snakefoot)  

## Performance
- ObjectGraphScanner - Avoid holding list.SyncRoot lock while scanning (@snakefoot)
- FileTarget - ConcurrentWrites=true on NetCore now much faster when archive enabled (@snakefoot)
- JsonConverter - Write DateTime directly without string allocation (@snakefoot)
- XmlLayout - Removed unnecessary double conversion to string (@snakefoot)
- WebServiceTarget - Reduced memory allocations by removing unnecessary delegate capture (@snakefoot)
- NetworkTarget  - Reduced memory allocation for encoding into bytes without string allocation (@snakefoot)
- AsyncTaskTarget - Skip default AsyncWrapper since already having internal queue (@snakefoot)
- Mark Condition Expressions as ThreadSafe to improve concurrency in Layouts (@snakefoot)
- DatabaseTarget - Added IsolationLevel option that activates transactions for better batching performance (@snakefoot)
- SimpleLayout - Assignment of string-reference with null-value will translate into FixedText (@304NotModified)
- AsyncWrapper - Less aggressive with scheduling timer events for background writing (@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/