There is a newer version of this package available.
See the version list below for details.
dotnet add package NLog --version 4.3.0
                    
NuGet\Install-Package NLog -Version 4.3.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.3.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="NLog" Version="4.3.0" />
                    
Directory.Packages.props
<PackageReference Include="NLog" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add NLog --version 4.3.0
                    
#r "nuget: NLog, 4.3.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.
#addin nuget:?package=NLog&version=4.3.0
                    
Install as a Cake Addin
#tool nuget:?package=NLog&version=4.3.0
                    
Install as a Cake Tool

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 Compatible and additional computed target framework versions.
.NET Framework net35 is compatible.  net40 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 monoandroid10 is compatible. 
Silverlight sl4 is compatible.  sl5 is compatible. 
Windows Phone wp8 is compatible.  wp81 was computed. 
Xamarin.iOS xamarinios10 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

NuGet packages (2.8K)

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

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

Repository Stars
shadowsocks/shadowsocks-windows
A C# port of shadowsocks
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.
srwi/EverythingToolbar
Everything integration for the Windows taskbar.
JosefNemec/Playnite
Video game library manager with support for wide range of 3rd party libraries and game emulation support, providing one unified interface for your games.
Flow-Launcher/Flow.Launcher
:mag: Quick file search & app launcher for Windows with community-made plugins
AutoDarkMode/Windows-Auto-Night-Mode
Automatically switches between the dark and light theme of Windows 10 and Windows 11
Richasy/Bili.Uwp
适用于新系统UI的哔哩
NLog/NLog
NLog - Flexible and Structured Logging for various .NET Platforms
LykosAI/StabilityMatrix
Multi-Platform Package Manager for Stable Diffusion
canton7/SyncTrayzor
Windows tray utility / filesystem watcher / launcher for Syncthing
ServiceStack/ServiceStack
Thoughtfully architected, obscenely fast, thoroughly enjoyable web services for all
Prowlarr/Prowlarr
Prowlarr is an indexer manager/proxy built on the popular *arr .net/reactjs base stack to integrate with your various PVR apps, supporting management of both Torrent Trackers and Usenet Indexers.
Azure/azure-powershell
Microsoft Azure PowerShell
Lidarr/Lidarr
Looks and smells like Sonarr but made for music.
focus-creative-games/luban
luban是一个强大、易用、优雅、稳定的游戏配置解决方案。luban is a powerful, easy-to-use, elegant and stable game configuration solution.
ravendb/ravendb
ACID Document Database
Version Downloads Last Updated
6.0.1 91,792 6/27/2025
6.0.0 89,637 6/21/2025
6.0.0-rc4 1,553 6/15/2025
6.0.0-rc3 2,107 6/8/2025
6.0.0-rc2 2,037 6/1/2025
6.0.0-rc1 1,801 5/25/2025
6.0.0-preview1 5,796 4/29/2025
5.5.0 507,809 5/29/2025
5.4.0 4,971,537 2/2/2025
5.3.4 10,747,649 9/12/2024
5.3.3 2,758,678 8/12/2024
5.3.2 8,538,096 4/30/2024
5.3.1 214,620 4/27/2024
5.2.8 12,387,678 12/29/2023
5.2.7 2,780,720 11/28/2023
5.2.6 669,091 11/19/2023
5.2.5 4,816,327 10/15/2023
5.2.4 3,677,439 9/6/2023
5.2.3 3,838,605 8/5/2023
5.2.2 5,161,236 7/4/2023
5.2.1 220,690 7/1/2023
5.2.0 5,072,218 5/30/2023
5.1.5 475,011 5/25/2023
5.1.4 1,929,841 4/29/2023
5.1.3 4,648,505 3/28/2023
5.1.2 4,808,687 2/17/2023
5.1.1 6,106,978 12/29/2022
5.1.0 4,368,847 11/27/2022
5.0.5 4,820,932 10/25/2022
5.0.4 7,015,254 9/1/2022
5.0.3 194,778 8/31/2022
5.0.2 1,576,995 8/12/2022
5.0.1 6,092,506 6/12/2022
5.0.0 7,296,961 5/16/2022
4.7.15 13,624,103 3/26/2022
4.7.14 3,288,929 2/23/2022
4.7.13 8,538,813 12/5/2021
4.7.12 4,724,611 10/24/2021
4.7.11 17,440,611 8/18/2021
4.7.10 11,092,812 5/14/2021
4.7.9 8,916,248 3/24/2021
4.7.8 4,956,104 2/25/2021
4.7.7 3,868,352 1/20/2021
4.7.6 6,348,630 12/6/2020
4.7.5 8,107,952 9/27/2020
4.7.4 5,731,300 8/22/2020
4.7.3 2,000,887 7/31/2020
4.7.2 18,905,301 5/18/2020
4.7.1 195,788 5/15/2020
4.7.0 6,928,725 3/20/2020
4.6.8 22,870,446 11/4/2019
4.6.7 15,803,148 8/25/2019
4.6.6 4,173,785 7/14/2019
4.6.5 5,238,879 6/14/2019
4.6.4 3,438,008 5/28/2019
4.6.3 4,266,588 4/30/2019
4.6.2 3,096,771 4/2/2019
4.6.1 358,377 3/29/2019
4.6.0 1,107,248 3/21/2019
4.5.11 27,112,256 11/6/2018
4.5.10 7,175,176 9/17/2018
4.5.9 1,891,067 8/24/2018
4.5.8 2,735,104 8/5/2018
4.5.7 1,407,205 7/19/2018
4.5.6 4,396,999 5/29/2018
4.5.5 1,007,861 5/25/2018
4.5.4 5,299,827 5/5/2018
4.5.3 2,539,344 4/16/2018
4.5.2 1,404,791 4/6/2018
4.5.1 473,280 4/3/2018
4.5.0 13,633,873 3/25/2018
4.4.13 1,047,301 2/27/2018
4.4.12 8,430,029 8/8/2017
4.4.11 2,729,638 6/17/2017
4.4.10 549,866 5/31/2017
4.4.9 1,270,678 5/5/2017
4.4.8 249,799 4/28/2017
4.4.7 188,525 4/25/2017
4.4.6 437,894 4/15/2017
4.4.5 607,697 3/28/2017
4.4.4 718,108 3/10/2017
4.4.3 868,540 2/17/2017
4.4.2 581,640 2/6/2017
4.4.1 2,929,751 12/24/2016
4.4.0 422,921 12/14/2016
4.3.11 1,506,970 11/7/2016
4.3.10 1,134,530 10/11/2016
4.3.9 612,946 9/18/2016
4.3.8 864,518 9/5/2016
4.3.7 828,348 8/6/2016
4.3.6 345,491 7/23/2016
4.3.5 1,167,707 6/12/2016
4.3.4 967,955 5/16/2016
4.3.3 591,735 4/28/2016
4.3.2 127,757 4/26/2016
4.3.1 134,572 4/20/2016
4.3.0 189,812 4/16/2016
4.2.3 2,561,862 12/20/2015
4.2.2 439,403 12/2/2015
4.2.1 1,046,220 11/21/2015
4.2.0 572,036 10/24/2015
4.1.2 1,381,806 9/20/2015
4.1.1 204,718 9/12/2015
4.1.0 285,651 8/31/2015
4.0.1 1,271,821 6/18/2015
4.0.0 1,862,872 6/9/2015
3.2.1 1,292,946 4/24/2015
3.2.0 2,308,038 1/2/2015
3.1.0 2,186,379 6/24/2014
3.0.0 334,068 6/2/2014
2.1.0 3,843,053 10/10/2013
2.0.1.2 1,701,436 4/8/2013
2.0.0.2000 3,934,843 7/18/2011
1.0.0.505 1,370,981 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