NLog 4.6.8
Prefix ReservedSee the version list below for details.
dotnet add package NLog --version 4.6.8
NuGet\Install-Package NLog -Version 4.6.8
<PackageReference Include="NLog" Version="4.6.8" />
paket add NLog --version 4.6.8
#r "nuget: NLog, 4.6.8"
// Install NLog as a Cake Addin #addin nuget:?package=NLog&version=4.6.8 // Install NLog as a Cake Tool #tool nuget:?package=NLog&version=4.6.8
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
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. |
.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.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,608,546 | 9/12/2024 |
5.3.3 | 1,251,062 | 8/12/2024 |
5.3.2 | 4,785,261 | 4/30/2024 |
5.3.1 | 128,482 | 4/27/2024 |
5.2.8 | 8,272,367 | 12/29/2023 |
5.2.7 | 1,862,808 | 11/28/2023 |
5.2.6 | 544,139 | 11/19/2023 |
5.2.5 | 3,412,029 | 10/15/2023 |
5.2.4 | 2,756,432 | 9/6/2023 |
5.2.3 | 2,767,237 | 8/5/2023 |
5.2.2 | 3,499,653 | 7/4/2023 |
5.2.1 | 184,372 | 7/1/2023 |
5.2.0 | 3,898,731 | 5/30/2023 |
5.1.5 | 380,741 | 5/25/2023 |
5.1.4 | 1,538,054 | 4/29/2023 |
5.1.3 | 3,650,950 | 3/28/2023 |
5.1.2 | 4,120,971 | 2/17/2023 |
5.1.1 | 5,202,104 | 12/29/2022 |
5.1.0 | 3,590,630 | 11/27/2022 |
5.0.5 | 4,141,979 | 10/25/2022 |
5.0.4 | 5,717,648 | 9/1/2022 |
5.0.3 | 178,993 | 8/31/2022 |
5.0.2 | 1,382,159 | 8/12/2022 |
5.0.1 | 5,100,014 | 6/12/2022 |
5.0.0 | 5,889,094 | 5/16/2022 |
4.7.15 | 10,498,462 | 3/26/2022 |
4.7.14 | 2,892,083 | 2/23/2022 |
4.7.13 | 7,271,948 | 12/5/2021 |
4.7.12 | 4,291,841 | 10/24/2021 |
4.7.11 | 15,364,764 | 8/18/2021 |
4.7.10 | 9,873,388 | 5/14/2021 |
4.7.9 | 8,355,504 | 3/24/2021 |
4.7.8 | 4,497,295 | 2/25/2021 |
4.7.7 | 3,507,323 | 1/20/2021 |
4.7.6 | 5,874,578 | 12/6/2020 |
4.7.5 | 7,474,759 | 9/27/2020 |
4.7.4 | 5,363,499 | 8/22/2020 |
4.7.3 | 1,907,081 | 7/31/2020 |
4.7.2 | 17,108,373 | 5/18/2020 |
4.7.1 | 184,168 | 5/15/2020 |
4.7.0 | 6,384,849 | 3/20/2020 |
4.6.8 | 20,924,125 | 11/4/2019 |
4.6.7 | 14,444,863 | 8/25/2019 |
4.6.6 | 3,902,796 | 7/14/2019 |
4.6.5 | 4,424,484 | 6/14/2019 |
4.6.4 | 3,215,343 | 5/28/2019 |
4.6.3 | 3,765,349 | 4/30/2019 |
4.6.2 | 2,827,059 | 4/2/2019 |
4.6.1 | 340,803 | 3/29/2019 |
4.6.0 | 1,041,358 | 3/21/2019 |
4.5.11 | 23,942,712 | 11/6/2018 |
4.5.10 | 6,726,463 | 9/17/2018 |
4.5.9 | 1,780,847 | 8/24/2018 |
4.5.8 | 2,632,129 | 8/5/2018 |
4.5.7 | 1,359,206 | 7/19/2018 |
4.5.6 | 4,010,270 | 5/29/2018 |
4.5.5 | 972,606 | 5/25/2018 |
4.5.4 | 4,890,619 | 5/5/2018 |
4.5.3 | 2,313,436 | 4/16/2018 |
4.5.2 | 1,293,023 | 4/6/2018 |
4.5.1 | 429,884 | 4/3/2018 |
4.5.0 | 11,147,140 | 3/25/2018 |
4.4.13 | 991,186 | 2/27/2018 |
4.4.12 | 8,054,744 | 8/8/2017 |
4.4.11 | 2,620,349 | 6/17/2017 |
4.4.10 | 523,963 | 5/31/2017 |
4.4.9 | 1,221,179 | 5/5/2017 |
4.4.8 | 240,972 | 4/28/2017 |
4.4.7 | 169,093 | 4/25/2017 |
4.4.6 | 415,915 | 4/15/2017 |
4.4.5 | 587,865 | 3/28/2017 |
4.4.4 | 689,594 | 3/10/2017 |
4.4.3 | 842,992 | 2/17/2017 |
4.4.2 | 534,364 | 2/6/2017 |
4.4.1 | 2,425,522 | 12/24/2016 |
4.4.0 | 398,283 | 12/14/2016 |
4.3.11 | 1,384,903 | 11/7/2016 |
4.3.10 | 1,093,218 | 10/11/2016 |
4.3.9 | 579,912 | 9/18/2016 |
4.3.8 | 833,499 | 9/5/2016 |
4.3.7 | 782,065 | 8/6/2016 |
4.3.6 | 332,847 | 7/23/2016 |
4.3.5 | 1,089,817 | 6/12/2016 |
4.3.4 | 935,031 | 5/16/2016 |
4.3.3 | 552,078 | 4/28/2016 |
4.3.2 | 122,077 | 4/26/2016 |
4.3.1 | 130,938 | 4/20/2016 |
4.3.0 | 179,082 | 4/16/2016 |
4.2.3 | 2,401,688 | 12/20/2015 |
4.2.2 | 418,686 | 12/2/2015 |
4.2.1 | 1,022,535 | 11/21/2015 |
4.2.0 | 552,612 | 10/24/2015 |
4.1.2 | 1,242,288 | 9/20/2015 |
4.1.1 | 197,086 | 9/12/2015 |
4.1.0 | 273,162 | 8/31/2015 |
4.0.1 | 1,202,239 | 6/18/2015 |
4.0.0 | 1,644,272 | 6/9/2015 |
3.2.1 | 1,199,437 | 4/24/2015 |
3.2.0 | 2,207,299 | 1/2/2015 |
3.1.0 | 2,080,719 | 6/24/2014 |
3.0.0 | 314,170 | 6/2/2014 |
2.1.0 | 3,555,425 | 10/10/2013 |
2.0.1.2 | 1,647,375 | 4/8/2013 |
2.0.0.2000 | 3,674,610 | 7/18/2011 |
1.0.0.505 | 1,125,999 | 1/7/2011 |
## Bugfixes
- DatabaseTarget - Auto escape special chars in password, and improve handling of empty username/password (@304NotModified)
- LoggingRule - Fixed IndexOutOfRangeException for SetLoggingLevels with LogLevel.Off (@snakefoot)
- FileTarget - Improved handling of relative path in ArchiveFileName (@snakefoot)
- ExceptionLayoutRenderer - Fixed missing separator when Format-value gives empty result (@brinko99)
- ${substring} - Length should not be mandatory (@304NotModified)
- SimpleLayout - Fixed NullReferenceException in PreCalculate during TryGetRawValue optimization (@snakefoot)
## Features
- LogFactory - AutoShutdown can be configured to unhook from AppDomain-Unload, and avoid premature shutdown with IHostBuilder (@snakefoot)
- PerformanceCounterLayoutRenderer - Added Layout-support for Instance-property (@snakefoot)
- ${local-ip} Layout Renderer for local machine ip-address (@snakefoot + @304NotModified)
- CachedLayoutRendererWrapper - Added CachedSeconds as ambient property. Ex. ${local-ip:cachedSeconds=60} (@snakefoot)
- JsonLayout - Added EscapeForwardSlash-option to skip Json-escape of forward slash (@304NotModified)
- AllEventPropertiesLayoutRenderer - Added Exclude-option that specifies property-keys to skip (@snakefoot)
- ${Exception} - Added new Format-option values HResult and Properties (@snakefoot)
## Improvements
- ConcurrentRequestQueue refactoring to reduce code complexity (@snakefoot)
- AsyncTargetWrapper now fallback to clearing internal queue if flush fails to release blocked writer threads (@snakefoot)
- ${CallSite} - Small improvements for recognizing async callsite cases (@snakefoot)
- LogManager.GetCurrentClassLogger - Improved capture of Logger name when called within lambda_method (@snakefoot)
- ${BaseDir=FixTempDir=true} fallback to process directory for .NET Core 3 Single File Publish (@snakefoot)
- Auto-loading NLog configuration from process.exe.nlog will priotize process directory for .NET Core 3 Single File Publish (@snakefoot)
- ObjectPathRendererWrapper minor refactorings (@snakefoot)
- ObjectHandleSerializer.GetObjectData includes SerializationFormatter=true for use in MDLC + NDLC (@snakefoot)
- FileTarget - Extra logging when FileName Layout renders empty string (@snakefoot)
## Performance
- LogFactory - Faster initial assembly reflection and config loading (@snakefoot)
- ConsoleTarget - Added WriteBuffer option that allows batch writing to console-stream with reduced allocations (@snakefoot)
- ConsoleTarget - Added global lock to prevent any threadsafety issue from unsafe console (@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/