NLog 4.3.0

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.

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.

Release Notes

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

Dependencies

This package has no dependencies.

NuGet packages (1.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, 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 (234)

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.
JustArchiNET/ArchiSteamFarm
C# application with primary purpose of idling Steam cards from multiple accounts simultaneously.
Sonarr/Sonarr
Smart PVR for newsgroup and bittorrent users.
Jackett/Jackett
API Support for your favorite torrent trackers

Version History

Version Downloads Last updated
4.7.5 505,358 9/27/2020
4.7.4 726,159 8/22/2020
4.7.3 380,474 7/31/2020
4.7.2 2,167,810 5/18/2020
4.7.1 47,554 5/15/2020
4.7.0 1,720,697 3/20/2020
4.6.8 5,695,108 11/4/2019
4.6.7 4,803,340 8/25/2019
4.6.6 1,504,393 7/14/2019
4.6.5 1,905,178 6/14/2019
4.6.4 1,514,590 5/28/2019
4.6.3 1,313,924 4/30/2019
4.6.2 1,020,669 4/2/2019
4.6.1 138,864 3/29/2019
4.6.0 445,552 3/21/2019
4.5.11 6,501,301 11/6/2018
4.5.10 3,317,815 9/17/2018
4.5.9 946,659 8/24/2018
4.5.8 1,327,721 8/5/2018
4.5.7 707,994 7/19/2018
4.5.6 1,908,436 5/29/2018
4.5.5 474,255 5/25/2018
4.5.4 1,611,221 5/5/2018
4.5.3 915,430 4/16/2018
4.5.2 666,546 4/6/2018
4.5.1 201,768 4/3/2018
4.5.0 2,718,434 3/25/2018
4.4.13 539,984 2/27/2018
4.4.12 4,392,932 8/8/2017
4.4.11 1,115,188 6/17/2017
4.4.10 285,719 5/31/2017
4.4.9 750,598 5/5/2017
4.4.8 115,157 4/28/2017
4.4.7 87,981 4/25/2017
4.4.6 246,978 4/15/2017
4.4.5 344,085 3/28/2017
4.4.4 405,220 3/10/2017
4.4.3 558,115 2/17/2017
4.4.2 291,390 2/6/2017
4.4.1 840,427 12/24/2016
4.4.0 230,598 12/14/2016
4.3.11 775,106 11/7/2016
4.3.10 515,967 10/11/2016
4.3.9 386,085 9/18/2016
4.3.8 500,188 9/5/2016
4.3.7 467,321 8/6/2016
4.3.6 215,921 7/23/2016
4.3.5 693,427 6/12/2016
4.3.4 591,278 5/16/2016
4.3.3 286,940 4/28/2016
4.3.2 73,265 4/26/2016
4.3.1 90,923 4/20/2016
4.3.0 99,671 4/16/2016
4.2.3 1,172,951 12/20/2015
4.2.2 224,694 12/2/2015
4.2.1 211,624 11/21/2015
4.2.0 316,426 10/24/2015
4.1.2 566,204 9/20/2015
4.1.1 112,038 9/12/2015
4.1.0 158,511 8/31/2015
4.0.1 589,003 6/18/2015
4.0.0 611,499 6/9/2015
3.2.1 628,064 4/24/2015
3.2.0 1,104,303 1/2/2015
3.1.0 1,134,252 6/24/2014
3.0.0 177,239 6/2/2014
2.1.0 991,855 10/10/2013
2.0.1.2 621,818 4/8/2013
2.0.0.2000 1,041,150 7/18/2011
1.0.0.505 211,761 1/7/2011
Show less