There is a newer version of this package available.
See the version list below for details.
dotnet add package NLog --version 4.5.0                
NuGet\Install-Package NLog -Version 4.5.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="4.5.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add NLog --version 4.5.0                
#r "nuget: NLog, 4.5.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=4.5.0

// Install NLog as a Cake Tool
#tool nuget:?package=NLog&version=4.5.0                

Getting started with NLog

Platform support

  • .NET Framework 3.5, 4, 4.5, 4.6 & 4.7
  • .NET Framework 4 client profile
  • Xamarin Android
  • Xamarin iOs
  • Windows Phone 8
  • Silverlight 4 and 5
  • Mono 4
  • ASP.NET 4 (NLog.Web package)
  • ASP.NET Core (NLog.Web.AspNetCore package)
  • .NET Core (NLog.Extensions.Logging package)
  • .NET Standard 1.3+
  • .NET Standard 2.x
  • UWP

See also Platform support

Troubleshooting

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 (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 (383)

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,024,351 9/12/2024
5.3.3 1,116,055 8/12/2024
5.3.2 4,429,184 4/30/2024
5.3.1 121,609 4/27/2024
5.2.8 7,941,958 12/29/2023
5.2.7 1,790,525 11/28/2023
5.2.6 530,058 11/19/2023
5.2.5 3,283,547 10/15/2023
5.2.4 2,683,273 9/6/2023
5.2.3 2,690,484 8/5/2023
5.2.2 3,392,778 7/4/2023
5.2.1 182,213 7/1/2023
5.2.0 3,783,921 5/30/2023
5.1.5 373,158 5/25/2023
5.1.4 1,504,076 4/29/2023
5.1.3 3,557,474 3/28/2023
5.1.2 4,062,799 2/17/2023
5.1.1 5,133,143 12/29/2022
5.1.0 3,529,690 11/27/2022
5.0.5 4,080,437 10/25/2022
5.0.4 5,626,886 9/1/2022
5.0.3 177,818 8/31/2022
5.0.2 1,369,071 8/12/2022
5.0.1 5,032,011 6/12/2022
5.0.0 5,782,158 5/16/2022
4.7.15 10,300,454 3/26/2022
4.7.14 2,860,921 2/23/2022
4.7.13 7,163,024 12/5/2021
4.7.12 4,253,189 10/24/2021
4.7.11 15,218,779 8/18/2021
4.7.10 9,783,814 5/14/2021
4.7.9 8,308,159 3/24/2021
4.7.8 4,462,908 2/25/2021
4.7.7 3,483,482 1/20/2021
4.7.6 5,839,251 12/6/2020
4.7.5 7,425,559 9/27/2020
4.7.4 5,338,961 8/22/2020
4.7.3 1,900,213 7/31/2020
4.7.2 16,969,646 5/18/2020
4.7.1 182,862 5/15/2020
4.7.0 6,342,597 3/20/2020
4.6.8 20,777,778 11/4/2019
4.6.7 14,355,435 8/25/2019
4.6.6 3,882,922 7/14/2019
4.6.5 4,402,783 6/14/2019
4.6.4 3,201,376 5/28/2019
4.6.3 3,716,535 4/30/2019
4.6.2 2,806,758 4/2/2019
4.6.1 339,555 3/29/2019
4.6.0 1,036,809 3/21/2019
4.5.11 23,729,813 11/6/2018
4.5.10 6,691,172 9/17/2018
4.5.9 1,772,680 8/24/2018
4.5.8 2,623,453 8/5/2018
4.5.7 1,353,836 7/19/2018
4.5.6 3,985,505 5/29/2018
4.5.5 969,459 5/25/2018
4.5.4 4,865,625 5/5/2018
4.5.3 2,295,892 4/16/2018
4.5.2 1,283,902 4/6/2018
4.5.1 426,242 4/3/2018
4.5.0 11,058,200 3/25/2018
4.4.13 986,828 2/27/2018
4.4.12 8,025,952 8/8/2017
4.4.11 2,611,649 6/17/2017
4.4.10 521,949 5/31/2017
4.4.9 1,217,717 5/5/2017
4.4.8 240,299 4/28/2017
4.4.7 167,793 4/25/2017
4.4.6 414,654 4/15/2017
4.4.5 586,332 3/28/2017
4.4.4 687,388 3/10/2017
4.4.3 840,997 2/17/2017
4.4.2 531,466 2/6/2017
4.4.1 2,388,976 12/24/2016
4.4.0 396,472 12/14/2016
4.3.11 1,378,526 11/7/2016
4.3.10 1,090,516 10/11/2016
4.3.9 576,334 9/18/2016
4.3.8 831,640 9/5/2016
4.3.7 779,102 8/6/2016
4.3.6 332,051 7/23/2016
4.3.5 1,084,829 6/12/2016
4.3.4 932,847 5/16/2016
4.3.3 548,714 4/28/2016
4.3.2 121,582 4/26/2016
4.3.1 130,789 4/20/2016
4.3.0 178,602 4/16/2016
4.2.3 2,390,284 12/20/2015
4.2.2 417,475 12/2/2015
4.2.1 1,021,439 11/21/2015
4.2.0 551,308 10/24/2015
4.1.2 1,233,921 9/20/2015
4.1.1 196,670 9/12/2015
4.1.0 272,701 8/31/2015
4.0.1 1,197,779 6/18/2015
4.0.0 1,629,125 6/9/2015
3.2.1 1,194,001 4/24/2015
3.2.0 2,200,131 1/2/2015
3.1.0 2,072,785 6/24/2014
3.0.0 313,051 6/2/2014
2.1.0 3,532,388 10/10/2013
2.0.1.2 1,643,378 4/8/2013
2.0.0.2000 3,653,464 7/18/2011
1.0.0.505 1,106,483 1/7/2011

NLog 4.5 adds structured logging and .NET Standard support/UPW without breaking changes! Also a lot features has been added!


List of important changes in NLog 4.5

**Features:**

- Support for .Net Standard 2.0 [#2263] + [#2402] (@snakefoot)
- Support for .Net Standard 1.5 [#2341] (@snakefoot)
- Support for .Net Standard 1.3 (and UWP) [#2441] + [#2597] (Remember to manually flush on app suspend). (@snakefoot)
- Introduced Structured logging [#2208] + [#2262] + [#2244] + [#2544] (@snakefoot, @304NotModified, @jods4, @nblumhardt) - see https://github.com/NLog/NLog/wiki/How-to-use-structured-logging
- Json conversion also supports object properties [#2179],  [#2555] (@snakefoot, @304NotModified)
- event-properties layout-renderer can now render objects as json [#2241] (@snakefoot, @304NotModified)
- exception layout-renderer can now render exceptions as json [#2357] (@snakefoot)
- Default file archive logic is now easier to use [#1993] (@snakefoot)
- Introduced InstallationContext.ThrowExceptions [#2214] (@rbarillec)
- WebServiceTarget - Allow configuration of proxy address [#2375] (@snakefoot)
- WebServiceTarget - JsonPost with JsonLayout without being wrapped in parameter [#2590] (@snakefoot)
- ${guid}, added GeneratedFromLogEvent [#2226] (@snakefoot)
- TraceTarget RawWrite to always perform Trace.WriteLine independent of LogLevel [#1968] (@snakefoot)
- Adding OverflowAction options to BufferingTargetWrapper [#2276] (@mikegron)
- WhenRepeatedFilter - Filtering of identical LogEvents  [#2123] + [#2297] (@snakefoot)
- ${callsite} added CleanNamesOfAsyncContinuations option [#2292] (@tkhaugen, @304NotModified)
- ${ndlctiming} allows timing of ndlc-scopes [#2377] (@snakefoot)
- NLogViewerTarget - Enable override of the Logger-name [#2390] (@snakefoot)
- ${sequenceid} added [#2411] (@MikeFH)  
- Added "regex-matches" for filtering [#2437] (@MikeFH)
- ${gdc}, ${mdc} & {mdlc} - Support Format parameter [#2500] (@snakefoot)
- ${currentDir} added [#2491] (@UgurAldanmaz)
- ${AssemblyVersion}: add type (File, Assembly, Informational) option [#2487] (@alexangas)
- FileTarget: Support byte order mark [#2456] (@KYegres)
- TargetWithContext - Easier to create custom NLog targets with support for MDLC and NDLC [#2467] (@snakefoot)
- ${callname-filename} - Without line number [#2591] (@brunotag)
- MDC + MDLC with SetScoped property support  [#2592] (@MikeFH)
- LoggingConfiguration AddRule includes final-parameter [#2612] (@893949088)

**BugFixes:**
- Improve archive stability during concurrent file access [#1889] (@snakefoot)
- FallbackGroup could lose log events [#2265] (@frabar666)
- ${exception} - only include separator when items are available [#2257] (@jojosardez)
- LogFactory - Fixes broken EventArgs for ConfigurationChanged [#1897] (@snakefoot)
- Do not report wrapped targets as unused targets [#2290] (@thesmallbang)
- Added IIncludeContext, implemented missing properties [#2117] (@304NotModified)
- Improve logging of callsite linenumber for async-methods [#2386] (@snakefoot)
- NLogTraceListener - DisableFlush is enabled by default when AutoFlush=true [#2407] (@snakefoot)
- NLogViewer - Better defaults for connection limits [#2404] (@304NotModified)
- LoggingConfiguration.LoggingRules is not thread safe [#2393], [#2418]
- Fix XmlLoggingConfiguration reloading [#2475] (@snakefoot)
- Database Target now supports EntityFramework ConnectionStrings [#2510] (@Misiu, @snakefoot)
- LoggingConfiguration.RemoveTarget now works while actively logging [#2549] (@jojosardez, @snakefoot)
- FileTarget does not fail on platforms without global mutex support [#2604] (@snakefoot)
- LoggingConfiguration does not fail when AutoReload is not possible on the platforms without FileWatcher [#2603]  (@snakefoot)

**Performance:**
- More targets has OptimizeBufferReuse enabled by default [#1913] + [#1923] + [#1912] + [#1911] + [#1910] + [#1909] + [#1908] + [#1907] + [#2560]   (@snakefoot)
- StringBuilderPool - Improved Layout Render Performance by reusing StringBuilders [#2208]   (@snakefoot)
- JsonLayout - Improved Layout Performance, by optimizing use of StringBuilder [#2208]   (@snakefoot)
- FileTarget - Faster byte-encoding of log messsages, by using crude Encoding.GetMaxByteCount() instead of exact Encoding.GetByteCount() [#2208] (@snakefoot)
- Target - Precalculate Layout should ignore sub-layouts for complex layout (Ex Json) [#2378]  (@snakefoot)
- MessageLayoutRenderer - Skip `string.Format` allocation (for caching) when writing to a single target, instead format directly into output buffer. [#2507]  (@snakefoot)

for full list, see https://github.com/NLog/NLog/blob/master/CHANGELOG.md

for what is supported in each platform, see https://github.com/NLog/NLog/wiki/platform-support