.NET Standard 1.3 .NET Framework 3.5
There is a newer version of this package available.
See the version list below for details.
Install-Package NLog -Version 4.6.8
dotnet add package NLog --version 4.6.8
<PackageReference Include="NLog" Version="4.6.8" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add NLog --version 4.6.8
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: NLog, 4.6.8"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. 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.6.8

// Install NLog as a Cake Tool
#tool nuget:?package=NLog&version=4.6.8
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows
.NET Core netcoreapp1.0 netcoreapp1.1 netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1
.NET Standard netstandard1.3 netstandard1.4 netstandard1.5 netstandard1.6 netstandard2.0 netstandard2.1
.NET Framework net35 net40 net40-client net403 net45 net451 net452 net46 net461 net462 net463 net47 net471 net472 net48
MonoAndroid monoandroid monoandroid44
MonoMac monomac
MonoTouch monotouch
Silverlight sl4 sl5
Tizen tizen30 tizen40 tizen60
Universal Windows Platform uap uap10.0
Windows Phone wp8 wp81
Xamarin.iOS xamarinios xamarinios10
Xamarin.Mac xamarinmac
Xamarin.TVOS xamarintvos
Xamarin.WatchOS xamarinwatchos
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2.2K)

Showing the top 5 NuGet packages that depend on NLog:

Package Downloads
NLog.Extensions.Logging The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

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 The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

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 The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

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 The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

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 The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

NLog.Extended.dll provides MSMQ target and AppSetting renderer

GitHub repositories (204)

Showing the top 5 popular GitHub repositories that depend on NLog:

Repository Stars
microsoft/PowerToys
Windows system utilities to maximize productivity
Wox-launcher/Wox
Launcher for Windows, an alternative to Alfred and Launchy.
BeyondDimension/SteamTools
🛠「Watt Toolkit」是一个开源跨平台的多功能 Steam 工具箱。
Jackett/Jackett
API Support for your favorite torrent trackers
Sonarr/Sonarr
Smart PVR for newsgroup and bittorrent users.
Version Downloads Last updated
5.0.0 23,592 5/16/2022
5.0.0-rc2 83,689 1/19/2022
5.0.0-rc1 63,042 12/20/2021
5.0.0-preview.3 42,376 10/26/2021
5.0.0-preview.2 10,764 10/3/2021
5.0.0-preview.1 11,611 8/25/2021
4.7.15 509,402 3/26/2022
4.7.14 463,934 2/23/2022
4.7.13 1,623,840 12/5/2021
4.7.12 1,219,116 10/24/2021
4.7.11 3,914,157 8/18/2021
4.7.10 3,850,500 5/14/2021
4.7.9 3,634,504 3/24/2021
4.7.8 1,951,056 2/25/2021
4.7.7 1,778,278 1/20/2021
4.7.6 3,272,515 12/6/2020
4.7.5 3,826,430 9/27/2020
4.7.4 3,010,010 8/22/2020
4.7.3 1,123,860 7/31/2020
4.7.2 7,334,672 5/18/2020
4.7.1 97,345 5/15/2020
4.7.0 3,845,022 3/20/2020
4.6.8 12,116,975 11/4/2019
4.6.7 8,948,024 8/25/2019
4.6.6 2,373,343 7/14/2019
4.6.5 3,081,413 6/14/2019
4.6.4 2,269,941 5/28/2019
4.6.3 2,158,128 4/30/2019
4.6.2 1,742,018 4/2/2019
4.6.1 230,645 3/29/2019
4.6.0 711,476 3/21/2019
4.5.11 12,283,024 11/6/2018
4.5.10 4,857,571 9/17/2018
4.5.9 1,285,632 8/24/2018
4.5.8 1,820,912 8/5/2018
4.5.7 993,892 7/19/2018
4.5.6 2,662,914 5/29/2018
4.5.5 695,990 5/25/2018
4.5.4 2,571,701 5/5/2018
4.5.3 1,370,825 4/16/2018
4.5.2 885,878 4/6/2018
4.5.1 273,667 4/3/2018
4.5.0 5,541,624 3/25/2018
4.4.13 725,864 2/27/2018
4.4.12 5,989,204 8/8/2017
4.4.11 1,694,743 6/17/2017
4.4.10 378,053 5/31/2017
4.4.9 977,900 5/5/2017
4.4.8 162,318 4/28/2017
4.4.7 108,615 4/25/2017
4.4.6 307,694 4/15/2017
4.4.5 448,048 3/28/2017
4.4.4 543,595 3/10/2017
4.4.3 679,288 2/17/2017
4.4.2 379,635 2/6/2017
4.4.1 1,307,118 12/24/2016
4.4.0 286,930 12/14/2016
4.3.11 975,251 11/7/2016
4.3.10 695,972 10/11/2016
4.3.9 456,917 9/18/2016
4.3.8 618,412 9/5/2016
4.3.7 596,165 8/6/2016
4.3.6 258,979 7/23/2016
4.3.5 815,575 6/12/2016
4.3.4 714,675 5/16/2016
4.3.3 373,141 4/28/2016
4.3.2 88,584 4/26/2016
4.3.1 107,427 4/20/2016
4.3.0 136,220 4/16/2016
4.2.3 1,618,542 12/20/2015
4.2.2 294,334 12/2/2015
4.2.1 430,229 11/21/2015
4.2.0 385,994 10/24/2015
4.1.2 761,458 9/20/2015
4.1.1 155,849 9/12/2015
4.1.0 203,546 8/31/2015
4.0.1 764,597 6/18/2015
4.0.0 951,227 6/9/2015
3.2.1 816,750 4/24/2015
3.2.0 1,429,289 1/2/2015
3.1.0 1,444,381 6/24/2014
3.0.0 217,943 6/2/2014
2.1.0 1,635,504 10/10/2013
2.0.1.2 926,647 4/8/2013
2.0.0.2000 1,698,765 7/18/2011
1.0.0.505 446,333 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/