NLog 4.7.0
Prefix ReservedSee the version list below for details.
dotnet add package NLog --version 4.7.0
NuGet\Install-Package NLog -Version 4.7.0
<PackageReference Include="NLog" Version="4.7.0" />
<PackageVersion Include="NLog" Version="4.7.0" />
<PackageReference Include="NLog" />
paket add NLog --version 4.7.0
#r "nuget: NLog, 4.7.0"
#addin nuget:?package=NLog&version=4.7.0
#tool nuget:?package=NLog&version=4.7.0
Getting started with NLog
- Getting started for .NET
- Getting started for ASP.NET Core 3
- Getting started for ASP.NET Core 2
- Getting started for .NET Core 2 Console application
- Getting started for ASP.NET Core 1 (csproj - vs2017)
- How to use structured logging
- Using NLog with appsettings.json
Config
- All config options: nlog-project.org/config
Troubleshooting
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. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.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.ComponentModel.Primitives (>= 4.1.0)
- System.ComponentModel.TypeConverter (>= 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.8K)
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 (398)
Showing the top 20 popular GitHub repositories that depend on NLog:
Repository | Stars |
---|---|
shadowsocks/shadowsocks-windows
A C# port of shadowsocks
|
|
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.
|
|
srwi/EverythingToolbar
Everything integration for the Windows taskbar.
|
|
JosefNemec/Playnite
Video game library manager with support for wide range of 3rd party libraries and game emulation support, providing one unified interface for your games.
|
|
Flow-Launcher/Flow.Launcher
:mag: Quick file search & app launcher for Windows with community-made plugins
|
|
AutoDarkMode/Windows-Auto-Night-Mode
Automatically switches between the dark and light theme of Windows 10 and Windows 11
|
|
Richasy/Bili.Uwp
适用于新系统UI的哔哩
|
|
LykosAI/StabilityMatrix
Multi-Platform Package Manager for Stable Diffusion
|
|
canton7/SyncTrayzor
Windows tray utility / filesystem watcher / launcher for Syncthing
|
|
ServiceStack/ServiceStack
Thoughtfully architected, obscenely fast, thoroughly enjoyable web services for all
|
|
Prowlarr/Prowlarr
Prowlarr is an indexer manager/proxy built on the popular *arr .net/reactjs base stack to integrate with your various PVR apps, supporting management of both Torrent Trackers and Usenet Indexers.
|
|
Azure/azure-powershell
Microsoft Azure PowerShell
|
|
Lidarr/Lidarr
Looks and smells like Sonarr but made for music.
|
|
focus-creative-games/luban
luban是一个强大、易用、优雅、稳定的游戏配置解决方案。luban is a powerful, easy-to-use, elegant and stable game configuration solution.
|
|
ravendb/ravendb
ACID Document Database
|
|
Topshelf/Topshelf
An easy service hosting framework for building Windows services using .NET
|
Version | Downloads | Last updated |
---|---|---|
6.0.0 | 496 | 6/21/2025 |
6.0.0-rc4 | 1,029 | 6/15/2025 |
6.0.0-rc3 | 1,355 | 6/8/2025 |
6.0.0-rc2 | 1,720 | 6/1/2025 |
6.0.0-rc1 | 1,469 | 5/25/2025 |
6.0.0-preview1 | 4,731 | 4/29/2025 |
5.5.0 | 299,500 | 5/29/2025 |
5.4.0 | 4,349,133 | 2/2/2025 |
5.3.4 | 10,136,223 | 9/12/2024 |
5.3.3 | 2,638,890 | 8/12/2024 |
5.3.2 | 8,251,959 | 4/30/2024 |
5.3.1 | 208,058 | 4/27/2024 |
5.2.8 | 12,057,805 | 12/29/2023 |
5.2.7 | 2,721,031 | 11/28/2023 |
5.2.6 | 661,202 | 11/19/2023 |
5.2.5 | 4,704,950 | 10/15/2023 |
5.2.4 | 3,618,389 | 9/6/2023 |
5.2.3 | 3,740,946 | 8/5/2023 |
5.2.2 | 5,027,159 | 7/4/2023 |
5.2.1 | 217,690 | 7/1/2023 |
5.2.0 | 5,008,441 | 5/30/2023 |
5.1.5 | 468,906 | 5/25/2023 |
5.1.4 | 1,898,565 | 4/29/2023 |
5.1.3 | 4,572,806 | 3/28/2023 |
5.1.2 | 4,755,076 | 2/17/2023 |
5.1.1 | 6,045,636 | 12/29/2022 |
5.1.0 | 4,308,559 | 11/27/2022 |
5.0.5 | 4,774,919 | 10/25/2022 |
5.0.4 | 6,914,734 | 9/1/2022 |
5.0.3 | 193,761 | 8/31/2022 |
5.0.2 | 1,562,118 | 8/12/2022 |
5.0.1 | 6,012,097 | 6/12/2022 |
5.0.0 | 7,189,819 | 5/16/2022 |
4.7.15 | 13,351,433 | 3/26/2022 |
4.7.14 | 3,264,587 | 2/23/2022 |
4.7.13 | 8,449,156 | 12/5/2021 |
4.7.12 | 4,692,133 | 10/24/2021 |
4.7.11 | 17,277,642 | 8/18/2021 |
4.7.10 | 10,991,931 | 5/14/2021 |
4.7.9 | 8,875,711 | 3/24/2021 |
4.7.8 | 4,921,760 | 2/25/2021 |
4.7.7 | 3,838,360 | 1/20/2021 |
4.7.6 | 6,313,397 | 12/6/2020 |
4.7.5 | 8,062,006 | 9/27/2020 |
4.7.4 | 5,703,911 | 8/22/2020 |
4.7.3 | 1,994,997 | 7/31/2020 |
4.7.2 | 18,764,336 | 5/18/2020 |
4.7.1 | 195,269 | 5/15/2020 |
4.7.0 | 6,889,405 | 3/20/2020 |
4.6.8 | 22,721,996 | 11/4/2019 |
4.6.7 | 15,680,341 | 8/25/2019 |
4.6.6 | 4,152,445 | 7/14/2019 |
4.6.5 | 5,082,223 | 6/14/2019 |
4.6.4 | 3,423,894 | 5/28/2019 |
4.6.3 | 4,234,692 | 4/30/2019 |
4.6.2 | 3,077,140 | 4/2/2019 |
4.6.1 | 357,211 | 3/29/2019 |
4.6.0 | 1,103,737 | 3/21/2019 |
4.5.11 | 26,854,556 | 11/6/2018 |
4.5.10 | 7,141,752 | 9/17/2018 |
4.5.9 | 1,883,713 | 8/24/2018 |
4.5.8 | 2,727,991 | 8/5/2018 |
4.5.7 | 1,404,389 | 7/19/2018 |
4.5.6 | 4,365,306 | 5/29/2018 |
4.5.5 | 1,006,116 | 5/25/2018 |
4.5.4 | 5,269,118 | 5/5/2018 |
4.5.3 | 2,524,734 | 4/16/2018 |
4.5.2 | 1,396,570 | 4/6/2018 |
4.5.1 | 470,486 | 4/3/2018 |
4.5.0 | 13,327,023 | 3/25/2018 |
4.4.13 | 1,043,396 | 2/27/2018 |
4.4.12 | 8,400,783 | 8/8/2017 |
4.4.11 | 2,720,781 | 6/17/2017 |
4.4.10 | 548,169 | 5/31/2017 |
4.4.9 | 1,266,819 | 5/5/2017 |
4.4.8 | 249,462 | 4/28/2017 |
4.4.7 | 187,993 | 4/25/2017 |
4.4.6 | 436,326 | 4/15/2017 |
4.4.5 | 606,777 | 3/28/2017 |
4.4.4 | 715,445 | 3/10/2017 |
4.4.3 | 866,912 | 2/17/2017 |
4.4.2 | 578,569 | 2/6/2017 |
4.4.1 | 2,895,394 | 12/24/2016 |
4.4.0 | 421,377 | 12/14/2016 |
4.3.11 | 1,496,598 | 11/7/2016 |
4.3.10 | 1,131,981 | 10/11/2016 |
4.3.9 | 610,260 | 9/18/2016 |
4.3.8 | 862,466 | 9/5/2016 |
4.3.7 | 824,699 | 8/6/2016 |
4.3.6 | 344,870 | 7/23/2016 |
4.3.5 | 1,162,440 | 6/12/2016 |
4.3.4 | 965,422 | 5/16/2016 |
4.3.3 | 588,955 | 4/28/2016 |
4.3.2 | 127,439 | 4/26/2016 |
4.3.1 | 134,341 | 4/20/2016 |
4.3.0 | 189,418 | 4/16/2016 |
4.2.3 | 2,548,857 | 12/20/2015 |
4.2.2 | 437,069 | 12/2/2015 |
4.2.1 | 1,044,165 | 11/21/2015 |
4.2.0 | 570,576 | 10/24/2015 |
4.1.2 | 1,370,456 | 9/20/2015 |
4.1.1 | 204,233 | 9/12/2015 |
4.1.0 | 284,029 | 8/31/2015 |
4.0.1 | 1,267,830 | 6/18/2015 |
4.0.0 | 1,845,385 | 6/9/2015 |
3.2.1 | 1,285,133 | 4/24/2015 |
3.2.0 | 2,299,614 | 1/2/2015 |
3.1.0 | 2,180,329 | 6/24/2014 |
3.0.0 | 332,869 | 6/2/2014 |
2.1.0 | 3,822,209 | 10/10/2013 |
2.0.1.2 | 1,697,589 | 4/8/2013 |
2.0.0.2000 | 3,916,976 | 7/18/2011 |
1.0.0.505 | 1,352,453 | 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)
- Logger - Added exception handler for CallSite capture for platform that fails to capture StackTrace (@snakefoot)
- StringSplitter - Fixed quote handling when reading elements for config list-properties (@snakefoot)
- Utilities: fix ConversionHelpers.TryParseEnum for white space (@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)
- InternalLogger - Added LogMessageReceived event (@304NotModified)
- DatabaseTarget - Assign connection properties like SqlConnection.AccessToken (@304NotModified + @snakefoot)
- DatabaseTarget - Assign command properties like SqlCommand.CommandTimeout (@snakefoot)
- ${onHasProperties} for only rendering when logevent includes properties from structured logging (@snakefoot)
## 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 - 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)
- Faster assignment of properties accessed through reflection (@304NotModified)
- ${replace} - Faster search and replace when not explicitly have requested regex support (@snakefoot)
- Skip need for Activator.CreateInstance in DbTypeSetter (@304NotModified)
Full changelog: https://github.com/NLog/NLog/blob/master/CHANGELOG.md
For all config options and platform support, check https://nlog-project.org/config/