.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.3.0
dotnet add package NLog --version 4.3.0
<PackageReference Include="NLog" Version="4.3.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add NLog --version 4.3.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: NLog, 4.3.0"
#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.3.0

// Install NLog as a Cake Tool
#tool nuget:?package=NLog&version=4.3.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

NLog is a logging platform for .NET with rich log routing and management capabilities. It can help you produce and manage high-quality logs for your application regardless of its size or complexity.
This package installs NLog.dll with includes core logging functionality.
For your main project also need to install "NLog Configuration" package.

Product Versions
.NET Framework net35 net40 net403 net45 net451 net452 net46 net461 net462 net463 net47 net471 net472 net48
MonoAndroid monoandroid10
Silverlight sl4 sl5
Windows Phone wp8 wp81
Xamarin.iOS xamarinios10
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

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

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,056 5/16/2022
5.0.0-rc2 83,648 1/19/2022
5.0.0-rc1 63,036 12/20/2021
5.0.0-preview.3 42,367 10/26/2021
5.0.0-preview.2 10,756 10/3/2021
5.0.0-preview.1 11,611 8/25/2021
4.7.15 508,251 3/26/2022
4.7.14 463,539 2/23/2022
4.7.13 1,622,625 12/5/2021
4.7.12 1,218,634 10/24/2021
4.7.11 3,912,713 8/18/2021
4.7.10 3,849,990 5/14/2021
4.7.9 3,633,934 3/24/2021
4.7.8 1,950,807 2/25/2021
4.7.7 1,777,981 1/20/2021
4.7.6 3,272,183 12/6/2020
4.7.5 3,825,968 9/27/2020
4.7.4 3,009,760 8/22/2020
4.7.3 1,123,776 7/31/2020
4.7.2 7,334,155 5/18/2020
4.7.1 97,340 5/15/2020
4.7.0 3,844,819 3/20/2020
4.6.8 12,116,050 11/4/2019
4.6.7 8,947,392 8/25/2019
4.6.6 2,373,143 7/14/2019
4.6.5 3,081,217 6/14/2019
4.6.4 2,269,833 5/28/2019
4.6.3 2,157,881 4/30/2019
4.6.2 1,741,968 4/2/2019
4.6.1 230,407 3/29/2019
4.6.0 711,445 3/21/2019
4.5.11 12,282,058 11/6/2018
4.5.10 4,857,285 9/17/2018
4.5.9 1,285,599 8/24/2018
4.5.8 1,820,814 8/5/2018
4.5.7 993,842 7/19/2018
4.5.6 2,662,780 5/29/2018
4.5.5 695,976 5/25/2018
4.5.4 2,571,489 5/5/2018
4.5.3 1,370,718 4/16/2018
4.5.2 885,844 4/6/2018
4.5.1 273,652 4/3/2018
4.5.0 5,540,812 3/25/2018
4.4.13 725,829 2/27/2018
4.4.12 5,988,944 8/8/2017
4.4.11 1,694,652 6/17/2017
4.4.10 378,013 5/31/2017
4.4.9 977,811 5/5/2017
4.4.8 162,317 4/28/2017
4.4.7 108,585 4/25/2017
4.4.6 307,693 4/15/2017
4.4.5 448,015 3/28/2017
4.4.4 543,549 3/10/2017
4.4.3 679,268 2/17/2017
4.4.2 379,623 2/6/2017
4.4.1 1,306,778 12/24/2016
4.4.0 286,923 12/14/2016
4.3.11 975,236 11/7/2016
4.3.10 695,962 10/11/2016
4.3.9 456,910 9/18/2016
4.3.8 618,385 9/5/2016
4.3.7 596,137 8/6/2016
4.3.6 258,965 7/23/2016
4.3.5 815,557 6/12/2016
4.3.4 714,644 5/16/2016
4.3.3 373,096 4/28/2016
4.3.2 88,584 4/26/2016
4.3.1 107,424 4/20/2016
4.3.0 136,219 4/16/2016
4.2.3 1,618,397 12/20/2015
4.2.2 294,313 12/2/2015
4.2.1 430,227 11/21/2015
4.2.0 385,989 10/24/2015
4.1.2 761,407 9/20/2015
4.1.1 155,847 9/12/2015
4.1.0 203,535 8/31/2015
4.0.1 764,588 6/18/2015
4.0.0 951,192 6/9/2015
3.2.1 816,701 4/24/2015
3.2.0 1,429,224 1/2/2015
3.1.0 1,444,307 6/24/2014
3.0.0 217,935 6/2/2014
2.1.0 1,635,380 10/10/2013
2.0.1.2 926,642 4/8/2013
2.0.0.2000 1,698,664 7/18/2011
1.0.0.505 446,233 1/7/2011

KNOWN ISSUE: ${var:myvar} won't work well with the Filetarget in 4.3.0. Will be fixed in 4.3.1. See https://github.com/NLog/NLog/issues/1381


WARNING: if throwExceptions is set to true, it's likely you will see more exceptions then before. Advise: don't set throwExceptions to true in production environments. See also news post.


News post: http://nlog-project.org/2016/04/16/nlog-4-3-has-been-released.html

# Features
- Support Windows Phone 8, Xamarin Android and Xamarin iOS (beta)
- Consistent handling of exceptions (BEHAVIOUR CHANGE)
- Control of exception throwing for configuration errors
- API improvements
- Relative paths for fileTarget
- InternalLogger: write to System.Diagnostics.Trace
- Mail Target: Allow virtual paths for SMTP pickup
- EventTarget: option to set the max length of the message and action (discard, split, truncate)
- MethodCallTarget: allow optional parameters in called methods.
- ConsoleTarget: Regex cache is instead of compiled regex, for better memory usage. This is configurable.
- Database target: don't require "ProviderName" attribute when using `<connectionStrings>`
- RegistryLayout: Support for layouts, RegistryView (32, 64 bit) and all root key names (HKCU/HKLM etc)
- Allow to free CallContext in `MappedDiagnosticsLogicalContext`
- LogFactory: Add generic-type versions of `GetLogger()` and `GetCurrentClassLogger()`
- Added `Logger.Swallow(Task task)`
- Unused targets will be logged to the internal logger
- Config classes are now thread-safe.
- InternalLogger: improved logging of exceptions (analogous to normal Logger)
- More logging to the internal logger (e.g. Async wrapper and buffer wrapper)
- Added timestamp options for the internal logger.
- Autoload NLog.config in assets folder on Android

# Bug fixes
Among others:

- `${callsite}` works now for async methods!
- A **lot of** Filetarget bug fixes regarding with archiving, locking and concurrent writing.
Most noticeable:
  - Use last-write-time for archive file name. This is far more stable.
   In the past there were some issues with unexpected archive filenames.
  - Fix: archiving won't work when a there is a date in the filename
  - Fix: archiving not working properly with AsyncWrapper
  - Fix: Footer for archiving
  - Fix: Crashes with relative path without `${basedir}`
  - Fix: Archive files are never created when there are lot of write in log file
- NetworkTarget: fix possible deadlock
- Fix autoreload nlog.config with parent configs.
- WebServiceTarget: Fix HTTP GET protocol
- Bugfix: Internallogger creates folder, even when turned off
- Fix possible Nullref in `${variable}`
- `${processtime}`: incorrect milliseconds formatting
- `${processtime}`: fix incorrect negative time (rounding issue)
- FileTarget: Fix writing log files to root dir
- Check for TimeToSleepBetweenBatches in AsyncWrapper