NLog 4.5.0-rc07
Prefix Reserved
Update to NLog v4.5 RTM
See the version list below for details.
dotnet add package NLog --version 4.5.0-rc07
NuGet\Install-Package NLog -Version 4.5.0-rc07
<PackageReference Include="NLog" Version="4.5.0-rc07" />
paket add NLog --version 4.5.0-rc07
#r "nuget: NLog, 4.5.0-rc07"
// Install NLog as a Cake Addin
#addin nuget:?package=NLog&version=4.5.0-rc07&prerelease
// Install NLog as a Cake Tool
#tool nuget:?package=NLog&version=4.5.0-rc07&prerelease
NLog is a logging platform for .NET with rich log routing and management capabilities.
| 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. 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. |
-
.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.Collections.NonGeneric (>= 4.0.1)
- 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.
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 |
|
|
NLog.Extended
NLog.Extended.dll provides MSMQ target and AppSetting renderer |
GitHub repositories (357)
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.2.8 | 3,367,199 | 12/29/2023 |
| 5.2.7 | 1,030,464 | 11/28/2023 |
| 5.2.6 | 389,079 | 11/19/2023 |
| 5.2.5 | 1,951,262 | 10/15/2023 |
| 5.2.4 | 1,791,841 | 9/6/2023 |
| 5.2.3 | 1,659,545 | 8/5/2023 |
| 5.2.2 | 2,418,430 | 7/4/2023 |
| 5.2.1 | 152,588 | 7/1/2023 |
| 5.2.0 | 2,628,338 | 5/30/2023 |
| 5.1.5 | 280,019 | 5/25/2023 |
| 5.1.4 | 1,160,729 | 4/29/2023 |
| 5.1.3 | 2,816,215 | 3/28/2023 |
| 5.1.2 | 3,285,158 | 2/17/2023 |
| 5.1.1 | 4,250,823 | 12/29/2022 |
| 5.1.0 | 2,869,288 | 11/27/2022 |
| 5.0.5 | 3,349,355 | 10/25/2022 |
| 5.0.4 | 4,680,903 | 9/1/2022 |
| 5.0.3 | 155,060 | 8/31/2022 |
| 5.0.2 | 1,179,960 | 8/12/2022 |
| 5.0.1 | 4,196,521 | 6/12/2022 |
| 5.0.0 | 4,681,875 | 5/16/2022 |
| 4.7.15 | 8,394,569 | 3/26/2022 |
| 4.7.14 | 2,460,057 | 2/23/2022 |
| 4.7.13 | 6,064,837 | 12/5/2021 |
| 4.7.12 | 3,861,653 | 10/24/2021 |
| 4.7.11 | 13,491,580 | 8/18/2021 |
| 4.7.10 | 8,827,275 | 5/14/2021 |
| 4.7.9 | 7,656,508 | 3/24/2021 |
| 4.7.8 | 4,094,227 | 2/25/2021 |
| 4.7.7 | 3,198,414 | 1/20/2021 |
| 4.7.6 | 5,438,914 | 12/6/2020 |
| 4.7.5 | 6,887,135 | 9/27/2020 |
| 4.7.4 | 5,017,067 | 8/22/2020 |
| 4.7.3 | 1,811,218 | 7/31/2020 |
| 4.7.2 | 15,480,212 | 5/18/2020 |
| 4.7.1 | 167,006 | 5/15/2020 |
| 4.7.0 | 5,916,291 | 3/20/2020 |
| 4.6.8 | 19,252,946 | 11/4/2019 |
| 4.6.7 | 13,397,669 | 8/25/2019 |
| 4.6.6 | 3,647,042 | 7/14/2019 |
| 4.6.5 | 4,180,137 | 6/14/2019 |
| 4.6.4 | 3,064,330 | 5/28/2019 |
| 4.6.3 | 3,399,932 | 4/30/2019 |
| 4.6.2 | 2,586,416 | 4/2/2019 |
| 4.6.1 | 325,685 | 3/29/2019 |
| 4.6.0 | 984,988 | 3/21/2019 |
| 4.5.11 | 21,598,792 | 11/6/2018 |
| 4.5.10 | 6,364,862 | 9/17/2018 |
| 4.5.9 | 1,684,250 | 8/24/2018 |
| 4.5.8 | 2,507,399 | 8/5/2018 |
| 4.5.7 | 1,311,358 | 7/19/2018 |
| 4.5.6 | 3,701,558 | 5/29/2018 |
| 4.5.5 | 932,021 | 5/25/2018 |
| 4.5.4 | 4,550,012 | 5/5/2018 |
| 4.5.3 | 2,109,787 | 4/16/2018 |
| 4.5.2 | 1,211,782 | 4/6/2018 |
| 4.5.1 | 390,373 | 4/3/2018 |
| 4.5.0 | 10,006,142 | 3/25/2018 |
| 4.4.13 | 939,136 | 2/27/2018 |
| 4.4.12 | 7,696,638 | 8/8/2017 |
| 4.4.11 | 2,505,310 | 6/17/2017 |
| 4.4.10 | 502,255 | 5/31/2017 |
| 4.4.9 | 1,177,028 | 5/5/2017 |
| 4.4.8 | 231,102 | 4/28/2017 |
| 4.4.7 | 153,855 | 4/25/2017 |
| 4.4.6 | 394,607 | 4/15/2017 |
| 4.4.5 | 569,511 | 3/28/2017 |
| 4.4.4 | 665,913 | 3/10/2017 |
| 4.4.3 | 819,062 | 2/17/2017 |
| 4.4.2 | 497,535 | 2/6/2017 |
| 4.4.1 | 2,029,700 | 12/24/2016 |
| 4.4.0 | 374,962 | 12/14/2016 |
| 4.3.11 | 1,294,969 | 11/7/2016 |
| 4.3.10 | 1,050,868 | 10/11/2016 |
| 4.3.9 | 550,658 | 9/18/2016 |
| 4.3.8 | 801,609 | 9/5/2016 |
| 4.3.7 | 746,588 | 8/6/2016 |
| 4.3.6 | 321,838 | 7/23/2016 |
| 4.3.5 | 1,030,236 | 6/12/2016 |
| 4.3.4 | 907,208 | 5/16/2016 |
| 4.3.3 | 512,379 | 4/28/2016 |
| 4.3.2 | 115,521 | 4/26/2016 |
| 4.3.1 | 128,303 | 4/20/2016 |
| 4.3.0 | 175,336 | 4/16/2016 |
| 4.2.3 | 2,264,688 | 12/20/2015 |
| 4.2.2 | 404,485 | 12/2/2015 |
| 4.2.1 | 981,606 | 11/21/2015 |
| 4.2.0 | 532,126 | 10/24/2015 |
| 4.1.2 | 1,127,982 | 9/20/2015 |
| 4.1.1 | 191,296 | 9/12/2015 |
| 4.1.0 | 265,877 | 8/31/2015 |
| 4.0.1 | 1,142,504 | 6/18/2015 |
| 4.0.0 | 1,474,665 | 6/9/2015 |
| 3.2.1 | 1,134,707 | 4/24/2015 |
| 3.2.0 | 2,102,277 | 1/2/2015 |
| 3.1.0 | 1,986,318 | 6/24/2014 |
| 3.0.0 | 297,991 | 6/2/2014 |
| 2.1.0 | 3,286,785 | 10/10/2013 |
| 2.0.1.2 | 1,577,495 | 4/8/2013 |
| 2.0.0.2000 | 3,436,674 | 7/18/2011 |
| 1.0.0.505 | 966,432 | 1/7/2011 |
NLog 4.5 adds structured logging and .NET Standard support/UPW without breaking changes! Also a lot features has been added!
# RC 7 summary:
- [#2612](https://github.com/nlog/nlog/pull/2612) add final param to `AddRule` Methods (#2612) (@893949088)
- [#2590](https://github.com/nlog/nlog/pull/2590) WebServiceTarget - JsonPost with support for single nameless parameter (@snakefoot)
- [#2604](https://github.com/nlog/nlog/pull/2604) FileTarget - Failing to CreateArchiveMutex should not stop logging (#2604) (@snakefoot)
- [#2592](https://github.com/nlog/nlog/pull/2592) Make Set methods of MDC and MDLC return IDisposable (#2592) (@MikeFH)
- [#2591](https://github.com/nlog/nlog/pull/2591) callsite-filename renderer (#2591) (@brunotag)
- [#2597](https://github.com/nlog/nlog/pull/2597) Replace WINDOWS_UWP with NETSTANDARD1_3 to support UWP10 shared libraries (@snakefoot)
- [#2599](https://github.com/nlog/nlog/pull/2599) TryImplicitConversion should only check object types (@snakefoot)
- [#2595](https://github.com/nlog/nlog/pull/2595) IsSafeToDeferFormatting - Convert.GetTypeCode is faster and better (@snakefoot)
- [#2609](https://github.com/nlog/nlog/pull/2609) NLog - Fix Callsite when wrapping ILogger in Microsoft Extension Logging (@snakefoot)
- [#2613](https://github.com/nlog/nlog/pull/2613) Attempt to make some unit-tests more stable (@snakefoot)
- [#2603](https://github.com/nlog/nlog/pull/2603) MultiFileWatcher - Improve error handling if FileSystemWatcher fails (@snakefoot)
- See also https://github.com/NLog/NLog/milestone/66?closed=1
# RC 6 summary:
- [#2576](https://github.com/NLog/NLog/pull/2576) Fix possible infinite loop in message template parser + better handling incorrect templates (@304NotModified, @snakefoot)
- [#2581](https://github.com/NLog/NLog/pull/2581) MessageTemplateParameter(s) ctors to internal (@304NotModified)
- See also https://github.com/NLog/NLog/milestone/63?closed=1
# RC 5 summary:
- [#2570](https://github.com/nlog/nlog/pull/2570) Update nuspec NLog.Config and NLog.Schema (@304NotModified)
- [#2542](https://github.com/nlog/nlog/pull/2542) Added TooManyStructuredParametersShouldKeepBeInParamList testcase (@304NotModified)
- [#2467](https://github.com/nlog/nlog/pull/2467) TargetWithContext - Easier to capture snapshot of MDLC and NDLC context (#2467) (@snakefoot)
- [#2555](https://github.com/nlog/nlog/pull/2555) JsonLayout - Added MaxRecursionLimit and set default to 0 (@snakefoot)
- [#2568](https://github.com/nlog/nlog/pull/2568) WebServiceTarget - Rollback added Group-Layout (@snakefoot)
- [#2544](https://github.com/nlog/nlog/pull/2544) MessageTemplate renderer with support for mixed mode templates (@snakefoot)
- [#2538](https://github.com/nlog/nlog/pull/2538) Renamed ValueSerializer to ValueFormatter (@snakefoot)
- [#2554](https://github.com/nlog/nlog/pull/2554) LogBuilder - Check level before allocation of Properties-dictionary (@snakefoot)
- [#2550](https://github.com/nlog/nlog/pull/2550) DefaultJsonSerializer - Reflection should skip index-item-properties (@snakefoot)
- [#2549](https://github.com/nlog/nlog/pull/2549) LoggingConfiguration - FindTargetByName should also find target + fix for logging on a target even after removed (@snakefoot)
- [#2548](https://github.com/nlog/nlog/pull/2548) IAppDomain.FriendlyName should also work on NetStandard15 (@snakefoot)
- [#2563](https://github.com/nlog/nlog/pull/2563) WebService-Target fails internally with PlatformNotSupportedException on NetCore (@snakefoot)
- [#2560](https://github.com/nlog/nlog/pull/2560) Network/NLogViewer/Chainsaw Target - Enabled OptimizeBufferReuse by default, but not for sub classes (@snakefoot)
- [#2551](https://github.com/nlog/nlog/pull/2551) Blackhole LoggingRule without targets (@snakefoot)
- [#2534](https://github.com/nlog/nlog/pull/2534) Docs for DefaultJsonSerializer/(i)ValueSerializer (#2534) (@304NotModified)
- [#2519](https://github.com/nlog/nlog/pull/2519) RegisterItemsFromAssembly - Include assemblies from nuget packages (Strict) (@304NotModified, @snakefoot)
- [#2524](https://github.com/nlog/nlog/pull/2524) FileTarget - Dynamic archive mode with more strict file-mask for cleanup (@snakefoot)
- [#2518](https://github.com/nlog/nlog/pull/2518) DatabaseTarget - Added DbProvider System.Data.SqlClient for NetStandard (@snakefoot)
- [#2514](https://github.com/nlog/nlog/pull/2514) Added missing docgen for different options (Less noise in appveyor) (@snakefoot)
- See also https://github.com/NLog/NLog/milestone/62?closed=1
# RC 4 summary:
- [#2490](https://github.com/nlog/nlog/pull/2490) LogEventInfo.MessageTemplateParameters as class instead of interface (#2490) (@snakefoot)
- [#2510](https://github.com/nlog/nlog/pull/2510) Database target entity framework connection string (@snakefoot)
- [#2513](https://github.com/nlog/nlog/pull/2513) Update docs for [AppDomainFixedOutput], remove [AppDomainFixedOutput] on ${currentDir} (@NLog)
- [#2512](https://github.com/nlog/nlog/pull/2512) LogManager.LoadConfiguration - Support relative paths by default (@snakefoot)
- [#2507](https://github.com/nlog/nlog/pull/2507) Reduce string allocations for logevents with single target destination (@snakefoot)
- [#2491](https://github.com/nlog/nlog/pull/2491) Added ${currentDir} (#2491) (@UgurAldanmaz)
- [#2500](https://github.com/nlog/nlog/pull/2500) ${gdc}, ${mdc} & {mdlc} - Support Format parameter (@snakefoot)
- [#2497](https://github.com/nlog/nlog/pull/2497) RegisterItemsFromAssembly - Include assemblies from nuget packages (Fix) (@snakefoot)
- [#2472](https://github.com/nlog/nlog/pull/2472) LogManager.LoadConfiguration - Prepare for custom config file readers (@snakefoot)
- [#2486](https://github.com/nlog/nlog/pull/2486) JsonConverter- Sanitize Exception.Data dictionary keys option (on by default) (@snakefoot)
- [#2495](https://github.com/nlog/nlog/pull/2495) MultiFileWatcher - Detach from FileSystemWatcher before disposing (@snakefoot)
- [#2493](https://github.com/nlog/nlog/pull/2493) RegisterItemsFromAssembly - Include assemblies from nuget packages (@snakefoot)
- [#2487](https://github.com/nlog/nlog/pull/2487) Adds version types to AssemblyVersion layout renderer (#2487) (@alexangas)
- [#2464](https://github.com/nlog/nlog/pull/2464) Add methods to enabling/disabling LogLevels (@MikeFH)
- [#2477](https://github.com/nlog/nlog/pull/2477) fix typo (@heldersepu)
- [#2485](https://github.com/nlog/nlog/pull/2485) FileTarget - Dispose Archive-Mutex after completing file-archive (@snakefoot)
- [#2475](https://github.com/nlog/nlog/pull/2475) Fix XmlLoggingConfiguration reloading (@MikeFH)
- [#2471](https://github.com/nlog/nlog/pull/2471) TreatWarningsAsErrors = true (@snakefoot)
- [#2462](https://github.com/nlog/nlog/pull/2462) AsyncLogEventInfo - Removed private setter (@snakefoot)
- See also https://github.com/NLog/NLog/milestone/60?closed=1
# RC 3 summary
- File target: support for writing BOM (WriteBom option)
- Futher memory allocation improvements
- See https://github.com/NLog/NLog/milestone/59?closed=1
# RC 2 summary
- Support for UWP
- Added "regex-matches" condition method for filtering
- .NET Core: Improve auto loading of NLog extension dlls
- And more, see all details: https://github.com/NLog/NLog/milestone/58?closed=1
# List of important changes in NLog 4.5
## Features:
- Support for .Net Standard 1.5 #2341
- Support for .Net Standard 2.0 #2263 + #2402
- Support for UPW #2441
- Introduced Structured logging #2208 + #2262 + #2244
- Default file archive logic is now easier to use #1993
- Introduced InstallationContext.ThrowExceptions #2214
- WebServiceTarget can now batch multiple logevents into single request #2223
- WebServiceTarget - Allow configuration of proxy address #2375
- Json conversion also supports object properties #2179
- event-properties layout-renderer can now render objects as json #2241
- exception layout-renderer can now render exceptions as json #2357
- ${guid}, added GeneratedFromLogEvent #2226
- TraceTarget RawWrite to always perform Trace.WriteLine independent of LogLevel #1968
- Adding OverflowAction options to BufferingTargetWrapper #2276
- WhenRepeatedFilter #2123 + #2297
- ${callsite} added CleanNamesOfAsyncContinuations option #2292
- ${ndlctiming} allows timing of ndlc-scopes #2377
- NLogViewerTarget - Enable override of the Logger-name #2390
- ${sequenceid} added #2411
- Added "regex-matches" for filtering #2437
- File target: support for writing BOM (WriteBom option) #2456
## BugFixes:
- Improve archive stability during concurrent file access #1889
- FallbackGroup could lose log events #2265
- Exception separator should only be inserted for available items #2250
- ${exception} - only include separator when items are available #2257
- LogFactory - Fixes broken EventArgs for ConfigurationChanged #1897
- Do not report wrapped targets as unused targets #2290
- Added IIncludeContext, implemented missing properties #2117
- Improve logging of callsite linenumber for async-methods #2386
- NLogTraceListener - DisableFlush is enabled by default when AutoFlush=true #2407
- NLogViewer - Better defaults for connection limits #2404
- LoggingConfiguration.LoggingRules is not thread safe #2393, #2418
## Performance:
- More targets has OptimizeBufferReuse enabled by default #1913 + #1923 + #1912 + #1911 + #1910 + #1909 + #1908 + #1907
- StringBuilderPool - Improved Layout Render Performance by reusing StringBuilders #2208
- JsonLayout - Improved Layout Performance, by optimizing use of StringBuilder #2208
- FileTarget - Faster byte-encoding of log messsages, by using crude Encoding.GetMaxByteCount() instead of exact Encoding.GetByteCount() #2208
- Target - Precalculate Layout should ignore sub-layouts for complex layout (Ex Json) #2378