NLog 5.0.0
Prefix Reserved
.NET Standard 1.3
This package targets .NET Standard 1.3. The package is compatible with this framework or higher.
.NET Framework 3.5
This package targets .NET Framework 3.5. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details.
See the version list below for details.
dotnet add package NLog --version 5.0.0
NuGet\Install-Package NLog -Version 5.0.0
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="5.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add NLog --version 5.0.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: NLog, 5.0.0"
#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=5.0.0 // Install NLog as a Cake Tool #tool nuget:?package=NLog&version=5.0.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
See Release post
Details of changes: See here
Major Features
- NLog is now faster and lighter
- NLog Layout for everything
- NLog ScopeContext to replace MDC + MDLC + NDC + NDLC
- NLog Layout stored as NLog Configuration Variables
- Fluent API for NLog LoggingConfiguration
- NLog Callsite from caller member attributes
- LogFactory with Dependency Injection
- Aliases support for targets, layouts, layout renderers and conditions\
- Dashes (-) will be ignored when parsing names
Breaking Changes
See rationale here
- Strong Version Changed
- Obsolete methods have been removed
- Xamarin, Windows Phone and Silverlight platforms have been removed
- .NET Framework v4.0 platform removed and replaced with .NET Framework v4.6
- NLog Extensions assemblies will not load automatically
- NLog Targets extracted into their own nuget-packages
- Deprecated NLog.Extended nuget-package
- Deprecated NLog.Config nuget-package
- Automatic loading of NLog.config now first check for exe.nlog
- NLog Configuration will have KeepVariablesOnReload enabled by default
- Layout and LayoutRenderer are now threadsafe by default
- Default Layout for NLog Targets has been updated
- Default Format for NLog Exception layoutrenderer has been updated
- NLog InternalLogger will not initialize itself from app.config or environment variables
- Removed obsolete method Target.Write(AsyncLogEventInfo[]) and OptimizeBufferReuse is always true
- ScopeContext changes MappedDiagnosticContext (MDC) to use AsyncLocal
- MappedDiagnosticContext (MDC), MappedDiagnosticLogicalContext (MDLC), GlobalDiagnosticContext (GDC) now case-insensitive
- FileTarget KeepFileOpen = true by default
- FileTarget ConcurrentWrites = false by default
- FileTarget Encoding default value changed to UTF8
- FileTarget will include BOM by default for UTF16 and UTF32 encoding
- NetworkTarget will Discard by default on overflow
- JsonLayout MaxRecursionLimit default value changed to 1
- JsonLayout EscapeForwardSlash default value changed to false
- JsonLayout always includes decimal point for floating-point types
- CallSite-renderer will automatically clean async callstacks
- LoggingRule Filters DefaultAction changed to FilterResult.Ignore
- NLog.Extensions.Logging without any filter
- NLog.Extensions.Logging changes capture of EventId
- The Simplelayout.ToString() has been changed
Many other improvements
For a full list of all the enhancements and performance improvements: NLog 5.0 Pull Requests
| Product | Versions 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. net403 was computed. net45 is compatible. net451 was computed. net452 was computed. net46 is compatible. 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. |
| MonoMac | monomac was computed. |
| MonoTouch | monotouch was computed. |
| Tizen | tizen30 was computed. tizen40 was computed. tizen60 was computed. |
| Universal Windows Platform | uap was computed. uap10.0 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| 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.
-
.NETFramework 3.5
- No dependencies.
-
.NETFramework 4.5
- No dependencies.
-
.NETFramework 4.6
- No dependencies.
-
.NETStandard 1.3
- Microsoft.Extensions.PlatformAbstractions (>= 1.0.0)
- NETStandard.Library (>= 1.6.0)
- System.ComponentModel.Primitives (>= 4.3.0)
- System.ComponentModel.TypeConverter (>= 4.3.0)
- System.Data.Common (>= 4.3.0)
- System.Diagnostics.StackTrace (>= 4.3.0)
- System.Net.Http (>= 4.3.4)
- System.Net.NameResolution (>= 4.3.0)
- System.Net.Requests (>= 4.3.0)
- System.Reflection.TypeExtensions (>= 4.3.0)
- System.Text.RegularExpressions (>= 4.3.1)
- System.Xml.XmlDocument (>= 4.3.0)
-
.NETStandard 1.5
- NETStandard.Library (>= 1.6.0)
- System.ComponentModel.Primitives (>= 4.3.0)
- System.ComponentModel.TypeConverter (>= 4.3.0)
- System.Data.Common (>= 4.3.0)
- System.Diagnostics.Process (>= 4.3.0)
- System.Diagnostics.StackTrace (>= 4.3.0)
- System.Diagnostics.TraceSource (>= 4.3.0)
- System.IO.FileSystem.Watcher (>= 4.3.0)
- System.Net.Http (>= 4.3.4)
- System.Net.NameResolution (>= 4.3.0)
- System.Net.Requests (>= 4.3.0)
- System.Reflection.TypeExtensions (>= 4.3.0)
- System.Runtime.Loader (>= 4.3.0)
- System.Text.RegularExpressions (>= 4.3.1)
- System.Threading.Thread (>= 4.3.0)
- System.Xml.XmlDocument (>= 4.3.0)
-
.NETStandard 2.0
- No dependencies.
NuGet packages (2.6K)
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, check: https://www.nuget.org/packages/NLog.Web.AspNetCore |
|
|
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/v4.4/src/NuGet/NLog.Config/content/NLog.config - set "Copy To Output Directory" to "Copy if newer" |
|
|
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 |
|
|
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 |
|
|
AWS.Logger.NLog
An AWS NLog target that records logging messages to Amazon CloudWatch Logs. |
GitHub repositories (385)
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.3.4 | 1,773,118 | 9/12/2024 |
| 5.3.3 | 1,281,296 | 8/12/2024 |
| 5.3.2 | 4,858,516 | 4/30/2024 |
| 5.3.1 | 130,074 | 4/27/2024 |
| 5.2.8 | 8,348,238 | 12/29/2023 |
| 5.2.7 | 1,880,813 | 11/28/2023 |
| 5.2.6 | 547,008 | 11/19/2023 |
| 5.2.5 | 3,441,111 | 10/15/2023 |
| 5.2.4 | 2,773,881 | 9/6/2023 |
| 5.2.3 | 2,784,757 | 8/5/2023 |
| 5.2.2 | 3,524,375 | 7/4/2023 |
| 5.2.1 | 184,908 | 7/1/2023 |
| 5.2.0 | 3,919,820 | 5/30/2023 |
| 5.1.5 | 382,618 | 5/25/2023 |
| 5.1.4 | 1,546,884 | 4/29/2023 |
| 5.1.3 | 3,673,129 | 3/28/2023 |
| 5.1.2 | 4,134,363 | 2/17/2023 |
| 5.1.1 | 5,216,830 | 12/29/2022 |
| 5.1.0 | 3,605,485 | 11/27/2022 |
| 5.0.5 | 4,156,958 | 10/25/2022 |
| 5.0.4 | 5,737,792 | 9/1/2022 |
| 5.0.3 | 179,215 | 8/31/2022 |
| 5.0.2 | 1,385,562 | 8/12/2022 |
| 5.0.1 | 5,117,085 | 6/12/2022 |
| 5.0.0 | 5,913,363 | 5/16/2022 |
| 4.7.15 | 10,549,783 | 3/26/2022 |
| 4.7.14 | 2,900,337 | 2/23/2022 |
| 4.7.13 | 7,301,029 | 12/5/2021 |
| 4.7.12 | 4,300,488 | 10/24/2021 |
| 4.7.11 | 15,399,141 | 8/18/2021 |
| 4.7.10 | 9,893,364 | 5/14/2021 |
| 4.7.9 | 8,364,964 | 3/24/2021 |
| 4.7.8 | 4,505,892 | 2/25/2021 |
| 4.7.7 | 3,513,123 | 1/20/2021 |
| 4.7.6 | 5,882,500 | 12/6/2020 |
| 4.7.5 | 7,485,926 | 9/27/2020 |
| 4.7.4 | 5,369,216 | 8/22/2020 |
| 4.7.3 | 1,908,509 | 7/31/2020 |
| 4.7.2 | 17,141,107 | 5/18/2020 |
| 4.7.1 | 184,454 | 5/15/2020 |
| 4.7.0 | 6,393,677 | 3/20/2020 |
| 4.6.8 | 20,959,871 | 11/4/2019 |
| 4.6.7 | 14,468,495 | 8/25/2019 |
| 4.6.6 | 3,906,704 | 7/14/2019 |
| 4.6.5 | 4,430,295 | 6/14/2019 |
| 4.6.4 | 3,218,574 | 5/28/2019 |
| 4.6.3 | 3,775,174 | 4/30/2019 |
| 4.6.2 | 2,831,567 | 4/2/2019 |
| 4.6.1 | 341,098 | 3/29/2019 |
| 4.6.0 | 1,042,335 | 3/21/2019 |
| 4.5.11 | 23,993,266 | 11/6/2018 |
| 4.5.10 | 6,733,665 | 9/17/2018 |
| 4.5.9 | 1,782,858 | 8/24/2018 |
| 4.5.8 | 2,633,956 | 8/5/2018 |
| 4.5.7 | 1,360,197 | 7/19/2018 |
| 4.5.6 | 4,016,239 | 5/29/2018 |
| 4.5.5 | 973,113 | 5/25/2018 |
| 4.5.4 | 4,897,176 | 5/5/2018 |
| 4.5.3 | 2,317,099 | 4/16/2018 |
| 4.5.2 | 1,294,887 | 4/6/2018 |
| 4.5.1 | 430,724 | 4/3/2018 |
| 4.5.0 | 11,168,385 | 3/25/2018 |
| 4.4.13 | 992,238 | 2/27/2018 |
| 4.4.12 | 8,061,326 | 8/8/2017 |
| 4.4.11 | 2,622,232 | 6/17/2017 |
| 4.4.10 | 524,375 | 5/31/2017 |
| 4.4.9 | 1,222,113 | 5/5/2017 |
| 4.4.8 | 241,112 | 4/28/2017 |
| 4.4.7 | 169,566 | 4/25/2017 |
| 4.4.6 | 416,187 | 4/15/2017 |
| 4.4.5 | 588,271 | 3/28/2017 |
| 4.4.4 | 690,165 | 3/10/2017 |
| 4.4.3 | 843,637 | 2/17/2017 |
| 4.4.2 | 535,384 | 2/6/2017 |
| 4.4.1 | 2,431,958 | 12/24/2016 |
| 4.4.0 | 398,682 | 12/14/2016 |
| 4.3.11 | 1,386,326 | 11/7/2016 |
| 4.3.10 | 1,093,787 | 10/11/2016 |
| 4.3.9 | 580,556 | 9/18/2016 |
| 4.3.8 | 833,961 | 9/5/2016 |
| 4.3.7 | 782,766 | 8/6/2016 |
| 4.3.6 | 333,089 | 7/23/2016 |
| 4.3.5 | 1,091,012 | 6/12/2016 |
| 4.3.4 | 935,539 | 5/16/2016 |
| 4.3.3 | 552,912 | 4/28/2016 |
| 4.3.2 | 122,210 | 4/26/2016 |
| 4.3.1 | 130,972 | 4/20/2016 |
| 4.3.0 | 179,262 | 4/16/2016 |
| 4.2.3 | 2,404,242 | 12/20/2015 |
| 4.2.2 | 418,970 | 12/2/2015 |
| 4.2.1 | 1,022,750 | 11/21/2015 |
| 4.2.0 | 552,915 | 10/24/2015 |
| 4.1.2 | 1,244,250 | 9/20/2015 |
| 4.1.1 | 197,135 | 9/12/2015 |
| 4.1.0 | 273,255 | 8/31/2015 |
| 4.0.1 | 1,203,163 | 6/18/2015 |
| 4.0.0 | 1,647,933 | 6/9/2015 |
| 3.2.1 | 1,200,751 | 4/24/2015 |
| 3.2.0 | 2,208,910 | 1/2/2015 |
| 3.1.0 | 2,082,387 | 6/24/2014 |
| 3.0.0 | 314,708 | 6/2/2014 |
| 2.1.0 | 3,560,507 | 10/10/2013 |
| 2.0.1.2 | 1,648,168 | 4/8/2013 |
| 2.0.0.2000 | 3,679,031 | 7/18/2011 |
| 1.0.0.505 | 1,129,927 | 1/7/2011 |
List of major changes in NLog 5.0: https://nlog-project.org/2022/05/16/nlog-5-0-finally-ready.md
Full changelog: https://github.com/NLog/NLog/blob/master/CHANGELOG.md
For all config options and platform support, check https://nlog-project.org/config/