NLog 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

Install-Package NLog -Version 4.7.1

dotnet add package NLog --version 4.7.1

<PackageReference Include="NLog" Version="4.7.1" />

paket add NLog --version 4.7.1

Release Notes

## 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/

Dependencies

• .NETFramework 3.5

  • No dependencies.

• .NETFramework 4.0 Client

  • No dependencies.

• .NETFramework 4.5

  • No dependencies.

• .NETStandard 1.3

  • Microsoft.Extensions.PlatformAbstractions (>= 1.0.0)
  • NETStandard.Library (>= 1.6.0)
  • System.ComponentModel.Primitives (>= 4.1.0)
  • System.ComponentModel.TypeConverter (>= 4.1.0)
  • System.Data.Common (>= 4.1.0)
  • System.Diagnostics.StackTrace (>= 4.0.1)
  • System.Net.NameResolution (>= 4.0.0)
  • System.Net.Requests (>= 4.0.11)
  • System.Reflection.TypeExtensions (>= 4.1.0)
  • System.Xml.XmlDocument (>= 4.0.1)

• .NETStandard 1.5

  • NETStandard.Library (>= 1.6.0)
  • System.ComponentModel.Primitives (>= 4.1.0)
  • System.ComponentModel.TypeConverter (>= 4.1.0)
  • System.Data.Common (>= 4.1.0)
  • System.Diagnostics.Process (>= 4.1.0)
  • System.Diagnostics.StackTrace (>= 4.0.1)
  • System.Diagnostics.TraceSource (>= 4.0.0)
  • System.IO.FileSystem.Watcher (>= 4.0.0)
  • System.Net.NameResolution (>= 4.0.0)
  • System.Net.Requests (>= 4.0.11)
  • System.Reflection.TypeExtensions (>= 4.1.0)
  • System.Runtime.Loader (>= 4.0.0)
  • System.Threading.Thread (>= 4.0.0)
  • System.Xml.XmlDocument (>= 4.0.1)

• .NETStandard 2.0

  • No dependencies.

• MonoAndroid 4.4

  • No dependencies.

• Silverlight 4.0

  • No dependencies.

• Silverlight 5.0

  • No dependencies.

• WindowsPhone 8.0

  • No dependencies.

• Xamarin.iOS 1.0

  • No dependencies.

Used By

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	22.8M
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"	10.6M
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	4.1M
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	2.8M
NLog.Extended NLog.Extended.dll provides MSMQ target and AppSetting renderer	2.3M

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.	51.4K
Wox-launcher/Wox Launcher for Windows, an alternative to Alfred and Launchy.	19.4K
JustArchiNET/ArchiSteamFarm C# application with primary purpose of idling Steam cards from multiple accounts simultaneously.	6.1K
Sonarr/Sonarr Smart PVR for newsgroup and bittorrent users.	6.1K
Jackett/Jackett API Support for your favorite torrent trackers	5.2K

Version History