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

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

NLog is a logging platform for .NET with rich log routing and management capabilities.
NLog supports traditional logging, structured logging and the combination of both.

Supported platforms:

- .NET Framework 3.5, 4, 4.5, 4.6, 4.7 & 4.8
- .NET Standard 1.3+ and 2.0+;
- .NET Framework 4 client profile
- Xamarin Android, Xamarin iOs
- UWP
- Windows Phone 8
- Silverlight 4 and 5
- Mono 4

For ASP.NET Core, check: NLog.Web.AspNetCore

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

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.2 717,260 4/30/2024
5.3.1 61,122 4/27/2024
5.2.8 4,783,397 12/29/2023
5.2.7 1,237,788 11/28/2023
5.2.6 431,678 11/19/2023
5.2.5 2,297,124 10/15/2023
5.2.4 2,045,224 9/6/2023
5.2.3 1,883,117 8/5/2023
5.2.2 2,662,543 7/4/2023
5.2.1 160,670 7/1/2023
5.2.0 2,914,041 5/30/2023
5.1.5 304,276 5/25/2023
5.1.4 1,243,957 4/29/2023
5.1.3 3,012,833 3/28/2023
5.1.2 3,518,235 2/17/2023
5.1.1 4,519,020 12/29/2022
5.1.0 3,055,561 11/27/2022
5.0.5 3,535,595 10/25/2022
5.0.4 4,929,617 9/1/2022
5.0.3 162,123 8/31/2022
5.0.2 1,233,688 8/12/2022
5.0.1 4,434,222 6/12/2022
5.0.0 4,979,893 5/16/2022
4.7.15 8,871,622 3/26/2022
4.7.14 2,574,651 2/23/2022
4.7.13 6,325,290 12/5/2021
4.7.12 3,968,868 10/24/2021
4.7.11 13,952,598 8/18/2021
4.7.10 9,060,103 5/14/2021
4.7.9 7,866,014 3/24/2021
4.7.8 4,191,877 2/25/2021
4.7.7 3,274,856 1/20/2021
4.7.6 5,541,530 12/6/2020
4.7.5 7,032,944 9/27/2020
4.7.4 5,123,213 8/22/2020
4.7.3 1,833,592 7/31/2020
4.7.2 15,797,880 5/18/2020
4.7.1 171,403 5/15/2020
4.7.0 6,026,655 3/20/2020
4.6.8 19,620,230 11/4/2019
4.6.7 13,628,119 8/25/2019
4.6.6 3,721,987 7/14/2019
4.6.5 4,234,493 6/14/2019
4.6.4 3,095,707 5/28/2019
4.6.3 3,469,453 4/30/2019
4.6.2 2,635,221 4/2/2019
4.6.1 329,125 3/29/2019
4.6.0 996,645 3/21/2019
4.5.11 22,164,510 11/6/2018
4.5.10 6,442,326 9/17/2018
4.5.9 1,705,749 8/24/2018
4.5.8 2,538,678 8/5/2018
4.5.7 1,321,057 7/19/2018
4.5.6 3,770,564 5/29/2018
4.5.5 941,890 5/25/2018
4.5.4 4,638,225 5/5/2018
4.5.3 2,152,260 4/16/2018
4.5.2 1,227,078 4/6/2018
4.5.1 398,111 4/3/2018
4.5.0 10,262,733 3/25/2018
4.4.13 950,072 2/27/2018
4.4.12 7,777,475 8/8/2017
4.4.11 2,526,748 6/17/2017
4.4.10 506,766 5/31/2017
4.4.9 1,186,870 5/5/2017
4.4.8 233,469 4/28/2017
4.4.7 156,830 4/25/2017
4.4.6 399,504 4/15/2017
4.4.5 572,940 3/28/2017
4.4.4 670,554 3/10/2017
4.4.3 824,739 2/17/2017
4.4.2 505,196 2/6/2017
4.4.1 2,122,201 12/24/2016
4.4.0 379,684 12/14/2016
4.3.11 1,315,964 11/7/2016
4.3.10 1,057,231 10/11/2016
4.3.9 556,536 9/18/2016
4.3.8 809,095 9/5/2016
4.3.7 754,001 8/6/2016
4.3.6 324,415 7/23/2016
4.3.5 1,043,834 6/12/2016
4.3.4 913,414 5/16/2016
4.3.3 521,569 4/28/2016
4.3.2 117,164 4/26/2016
4.3.1 129,026 4/20/2016
4.3.0 175,812 4/16/2016
4.2.3 2,291,815 12/20/2015
4.2.2 407,173 12/2/2015
4.2.1 983,651 11/21/2015
4.2.0 536,540 10/24/2015
4.1.2 1,152,972 9/20/2015
4.1.1 192,346 9/12/2015
4.1.0 267,037 8/31/2015
4.0.1 1,153,181 6/18/2015
4.0.0 1,510,375 6/9/2015
3.2.1 1,149,507 4/24/2015
3.2.0 2,124,805 1/2/2015
3.1.0 2,005,083 6/24/2014
3.0.0 301,795 6/2/2014
2.1.0 3,347,035 10/10/2013
2.0.1.2 1,586,138 4/8/2013
2.0.0.2000 3,486,791 7/18/2011
1.0.0.505 998,395 1/7/2011

## Bugfixes
- SplitGroup Target Wrapper should not skip remaining targets when single target fails (@snakefoot)
- ColoredConsoleTarget - Fix bug in handling of newlines without word-highlight (@snakefoot)
- ${processid} will no longer fail because unable to lookup ${processdir} on Mono Android (@snakefoot)

## Features
- LogManager.Setup().LoadConfigurationFromFile("NLog.config") added to fluent setup (@snakefoot + @304NotModified)
- LogManager.Setup().GetCurrentClassLogger() added to fluent setup (@snakefoot + @304NotModified)
- LogManager.Setup().SetupInternalLogger(s => s.AddLogSubscription()) added to fluent setup (@snakefoot + @304NotModified)
- ColoredConsoleTarget - Added Condition option to control when to do word-highlight (@snakefoot)
- Added new option CaptureStackTrace to ${stacktrace} and ${callsite} to skip implicit capture by Logger (@snakefoot)
- Exception-LayoutRenderer with new option BaseException for rendering innermost exception (@snakefoot)

## Improvements
- FileTarget - Batch write to filestream in max chunksize of 100 times BufferSize (@snakefoot)
- InternalLogger include whether NLog comes from GlobalAssemblyCache when logging NLog version (@snakefoot)
- InternalLogger LogToFile now support ${processdir} to improve support for single-file-publish (@snakefoot)
- Added ${processdir} that matches ${basedir:processDir=true} for consistency with InternalLogger (@snakefoot)
- Object property reflection now support IReadOnlyDictionary as expando object (@snakefoot)
- InternalLogger include more details like FilePath when loading NLog.config file (@snakefoot)
- Added support for Nullable when doing conversion of property types (@304NotModified)
- InternalLogger Warnings when skipping unrecognized LayoutRenderer options (@snakefoot)
- MappedDiagnosticsLogicalContext - SetScoped with IReadOnlyList also for Xamarin (@snakefoot)
- Object property reflection automatically performs ToString for System.Reflection.Module (@snakefoot)
- Improve ${basedir:fixtempdir=true} to work better on Linux when TMPDIR not set (@snakefoot)
- NetworkTarget respect MaxQueueSize for http- / https-protocol (@snakefoot)
- LogFactory.LoadConfiguration() reports searched paths when throwing FileNotFoundException (@304NotModified)
- ReplaceNewLines-LayoutRenderer will also remove windows newlines on the Linux platform (@Silvenga)

## Performance
- FileTarget - Skip checking file-length when only using ArchiveEvery (@snakefoot)
- ObjectGraphScanner performs caching of property reflection for NLog config items (@snakefoot)
- Condition expressions now handles operator like '==' without memory boxing (@snakefoot)
- ObjectGraphScanner should only check for layout-attributes on Layouts and LayoutRenderers (@snakefoot)
- MessageTemplate parsing of properties skips unnecessary array allocation (@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/