NLog 4.6.3

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

There is a newer version of this package available.
See the version list below for details.
Install-Package NLog -Version 4.6.3
dotnet add package NLog --version 4.6.3
<PackageReference Include="NLog" Version="4.6.3" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add NLog --version 4.6.3
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Release Notes

Bugfixes:

- Fixed potential memory issue and message duplication with large strings (@snakefoot)
- TargetWithContext - serialize MDC and MDLC values properly (@304NotModified)

Features:

- Added WithProperty and SetProperty on Logger (@snakefoot)
- ${EventProperties} - Added ObjectPath for rendering nested property (@snakefoot, @304NotModified)
- ${ShortDate} added support for IRawValue + IStringValueRenderer (@snakefoot)
- Added truncate ambient property, e.g. ${message:truncate=80} (@snakefoot)
- ConsoleTarget & ColoredConsoleTarget  - Added AutoFlush and improve default flush behavior (@snakefoot)

Improvements:

- FileTarget - Introduced EnableFileDeleteSimpleMonitor without FileSystemWatcher for non-Windows (@snakefoot)
- LogFactory - GetLogger should validate name of logger (@snakefoot)
- FallbackGroupTarget - Fixed potential issue with WINDOWS_PHONE (@snakefoot)
- NLog config file loading: use process name (e.g. applicationname.exe.nlog) when app.config is not available (@snakefoot)

Performance:

- Split string - avoid allocation of object array. Added StringHelpers.SplitAndTrimTokens (@snakefoot)
- AppSettingLayoutRenderer - Mark as ThreadSafe and ThreadAgnostic (@snakefoot)

Misc:

- Update docs of various context classes (@304NotModified)
- Move NLogPackageLoaders for better unittest debugging experience of NLog (@304NotModified)
- Make HttpNetworkSender mockable, add unit test, introduce NSubsitute (@304NotModified)
- 10 pull requests with refactorings (@snakefoot, @304NotModified)

Full changelog: https://github.com/NLog/NLog/blob/master/CHANGELOG.md

For all config options and platform support, check https://nlog-project.org/config/

NuGet packages (1.9K)

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, use NLog.Web.AspNetCore: 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/dev/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
NLog.Extended
NLog.Extended.dll provides MSMQ target and AppSetting renderer

GitHub repositories (239)

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

Repository Stars
shadowsocks/shadowsocks-windows
If you want to keep a secret, you must also hide it from yourself.
Wox-launcher/Wox
Launcher for Windows, an alternative to Alfred and Launchy.
files-community/Files
A modern file explorer that pushes the boundaries of the platform.
JustArchiNET/ArchiSteamFarm
C# application with primary purpose of idling Steam cards from multiple accounts simultaneously.
Sonarr/Sonarr
Smart PVR for newsgroup and bittorrent users.

Version History

Version Downloads Last updated
4.7.7 10,638 1/20/2021
4.7.6 296,779 12/6/2020
4.7.5 960,044 9/27/2020
4.7.4 1,027,901 8/22/2020
4.7.3 469,638 7/31/2020
4.7.2 2,770,743 5/18/2020
4.7.1 52,411 5/15/2020
4.7.0 1,948,835 3/20/2020
4.6.8 6,327,873 11/4/2019
4.6.7 5,205,288 8/25/2019
4.6.6 1,583,279 7/14/2019
4.6.5 2,017,368 6/14/2019
4.6.4 1,584,272 5/28/2019
4.6.3 1,376,835 4/30/2019
4.6.2 1,075,866 4/2/2019
4.6.1 148,710 3/29/2019
4.6.0 467,320 3/21/2019
4.5.11 6,938,082 11/6/2018
4.5.10 3,461,169 9/17/2018
4.5.9 983,747 8/24/2018
4.5.8 1,377,962 8/5/2018
4.5.7 734,295 7/19/2018
4.5.6 1,989,157 5/29/2018
4.5.5 494,412 5/25/2018
4.5.4 1,699,475 5/5/2018
4.5.3 956,950 4/16/2018
4.5.2 681,789 4/6/2018
4.5.1 206,958 4/3/2018
4.5.0 2,902,016 3/25/2018
4.4.13 562,511 2/27/2018
4.4.12 4,573,233 8/8/2017
4.4.11 1,146,724 6/17/2017
4.4.10 292,034 5/31/2017
4.4.9 770,068 5/5/2017
4.4.8 119,657 4/28/2017
4.4.7 89,487 4/25/2017
4.4.6 253,665 4/15/2017
4.4.5 353,099 3/28/2017
4.4.4 417,908 3/10/2017
4.4.3 570,800 2/17/2017
4.4.2 300,747 2/6/2017
4.4.1 874,969 12/24/2016
4.4.0 234,867 12/14/2016
4.3.11 792,127 11/7/2016
4.3.10 530,957 10/11/2016
4.3.9 393,015 9/18/2016
4.3.8 509,335 9/5/2016
4.3.7 479,035 8/6/2016
4.3.6 219,713 7/23/2016
4.3.5 705,236 6/12/2016
4.3.4 604,493 5/16/2016
4.3.3 296,137 4/28/2016
4.3.2 74,111 4/26/2016
4.3.1 92,757 4/20/2016
4.3.0 101,943 4/16/2016
4.2.3 1,204,737 12/20/2015
4.2.2 229,585 12/2/2015
4.2.1 214,517 11/21/2015
4.2.0 320,577 10/24/2015
4.1.2 578,871 9/20/2015
4.1.1 117,078 9/12/2015
4.1.0 161,797 8/31/2015
4.0.1 600,951 6/18/2015
4.0.0 644,355 6/9/2015
3.2.1 642,184 4/24/2015
3.2.0 1,123,020 1/2/2015
3.1.0 1,156,049 6/24/2014
3.0.0 180,709 6/2/2014
2.1.0 1,025,209 10/10/2013
2.0.1.2 629,896 4/8/2013
2.0.0.2000 1,062,276 7/18/2011
1.0.0.505 221,634 1/7/2011
Show less