NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
NuGet, #99 most downloaded on NuGet
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 6, 7, 8, 9 and 10 - .NET Standard 2.0 and 2.1 - .NET Framework 3.5 - 4.8 - Xamarin Android + iOS (.NET Standard) - Mono 4 For integrating NLog with Microsoft.Extensions.Logging, check: https://www.nuget.org/packages/NLog.Extensions.Logging For using NLog with ASP.NET Core, check: https://www.nuget.org/packages/NLog.Web.AspNetCore
Latest stable
6.2.2
Last release 1 months ago
15 Oct 2026
Ships on a steady schedule
a new release about every 4 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
98 versions withdrawn
withdrawn after publishing
127 years old
222 releases · first in 1900
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
Nothing published for this version
Nothing published for this version
#### Improvements - #4836 Fixed missing initialization of layout-parameters for ConditionMethodExpression (#4836) (@snakefoot) - #4821 LogEventInfo -
#### Improvements - #4799 Added IncludeEventProperties + IncludeScopeProperties to improve transition (#4799) (@snakefoot) - #4786 Refactored code to
@GitHubPang made their first contribution in https://github.com/NLog/NLog/pull/4649
#### Bugfixes - #4627 PropertiesDictionary - Fixed threading issue in EventProperties (#4627) (@snakefoot) - #4631 FileTarget - Failing to CleanupInit
#### Bugfixes - #4519 JsonSerializer - Fix CultureNotFoundException with Globalization Invariant Mode (#4519) (@snakefoot) #### Features - #4475 WebSe
## Bugfixes - #4401 JsonSerializer - Fixed bug when handling custom IConvertible returning TypeCode.Empty (#4401) (@snakefoot) ## Improvements - #4391
## Bugfixes - #4349 Fixed TrimDirectorySeparators to not use the root-path on Linux (#4349) (@snakefoot) - #4353 Fixed FileTarget archive cleanup with
## Bugfixes - #4316 Fix TrimDirectorySeparators to handle root-path on Windows and Linux to load Nlog.config from root-path (#4316) (@snakefoot) ## Im
## Bugfixes - #4229 Skip lookup MainModule.FileName on Android platform to avoid crash (#4229) (@snakefoot) - #4202 JsonLayout - Generate correct json
## Bugfixes - #4142 JsonSerializer - Ensure invariant formatting of DateTimeOffset (#4142) (@snakefoot) - #4172 AsyncTaskTarget - Flush when buffer is
## Bugfixes - #4106 FileTarget - New current file should write start header, when archive operation is performed on previous file (#4106) (@snakefoot)
## Features - #4076 DatabaseTarget - Added AllowDbNull for easier support for nullable parameters (#4076) (@snakefoot) ## Bugfixes - #4069 Fluent LogB
#### Features - #4017 Allow to change the RuleName of a LoggingRule (#4017) (@304NotModified) - #3974 logging of AggregrateException.Data to prevent i
#### Bugfixes - #3969 FileTarget - ArchiveOldFileOnStartup not working together with ArchiveAboveSize (@snakefoot) #### Improvements - #3962 XSD: Adde
## Features - #3871 LogManager.Setup().LoadConfigurationFromFile("NLog.config") added to fluent setup (@snakefoot + @304NotModified) - #3909 LogManage
${stacktrace} and ${callsite} to skip implicit capture by Logger (@snakefoot)${processdir} that matches ${basedir:processDir=true} for consistency with InternalLogger (@snakefoot)${processid} will no longer fail because unable to lookup ${processdir} on Mono Android (@snakefoot)## Features - #3686 + #3740 LogManager.Setup() allows fluent configuration of LogFactory options (@snakefoot + @304NotModified) - #3610 LogManager.Set
See https://github.com/NLog/NLog/blob/master/CHANGELOG.md
See https://github.com/NLog/NLog/blob/master/CHANGELOG.md
#### Bugfixes - #3566 DatabaseTarget - Auto escape special chars in password, and improve handling of empty username/password (@304NotModified) - #358
#### Features - #3531 Added ${object-path} / ${exception:objectpath=PropertyName}, for rendering a property of an object (e.g. an exception) (#3531) (
## Features - #3514 Added XmlLoggingConfiguration(XmlReader reader) ctor, improved docs and annotations (@dmitrychilli, @304NotModified) - #3513 AutoF
## Bugfixes - #3476 Fix broken XSD schema - NLog.Schema package (@snakefoot, @304NotModified) ## Features - #3478 XSD: Support <value> in <variable> (
Fixes - #3392 NLog.Schema: Added missing defaultAction attribute on filters element in XSD (@304NotModified) - #3415 AsyncWrapper in Blocking Mode can
Fixes
Features
Improvements
<PackageReference> (@304NotModified)Performance
10 pull requests with refactorings (@snakefoot, @304NotModified)
### Bugfixes - #3260 Fix escaping nested close brackets when parsing layout renderers (@lobster2012-user) - #3271 NLog config - Fixed bug where empty
#### Bugfixes - #3199 LoggingConfigurationParser - Fixed bug in handling of extensions prefix (@snakefoot) - #3253 Fix wrong warnings on element (only
<nlog> element (only wrong warnings) (#3253) (@snakefoot, @304NotModified)See https://nlog-project.org/2019/03/20/nlog-4-6-is-live.html
See https://nlog-project.org/2019/03/20/nlog-4-6-is-live.html
LibLog Breaking change
OpenNestedContext or OpenMappedContext.See also NLog 4.6 Milestone
Features
<filter> (@304NotModified)<rule> support for one or more '*' and '?' wildcards and in any position (@beppemarazzi)Improvements
Performance
LibLog Breaking change
OpenNestedContext or OpenMappedContext.See also NLog 4.6 Milestone
Oops, again a breaking change with the previous NLog 4.6 RC
Oops, again a breaking change with the previous NLog 4.6 RC
Note, there are no breaking changes with NLog 4.5.11. Semver is important!
LibLog Breaking change
OpenNestedContext or OpenMappedContext.See also NLog 4.6 Milestone
Full changelog: https://github.com/NLog/NLog/blob/master/CHANGELOG.md
Supported can be found on https://nlog-project.org/config/
Breaking changes since NLog 4.6 RC1, no breaking changes with 4.5.11
Breaking changes since NLog 4.6 RC1, no breaking changes with 4.5.11
See https://github.com/NLog/NLog/blob/dev/CHANGELOG.md
Various refactorings (15 pull requests) (@beppemarazzi, @304NotModified, @snakefoot)
Features:
Enhancements:
Performance:
LibLog Breaking change
OpenNestedContext or OpenMappedContext.See also NLog 4.6 Milestone
Full changelog: https://github.com/NLog/NLog/blob/master/CHANGELOG.md
### Enhancements - #2985 LogBuilder - Support fluent assignment of message-template after properties (@snakefoot) - #2983 JsonSerializer - Use Referen
- #2883 Fix LoadConfiguration for not found config file (@snakefoot, @304NotModified)
Fixes
## Fixes - #2865 JSON encoding should create valid JSON for special double values (hotfix) (@snakefoot) ## Enhancements - #2846 Include Entry Assembly
Fixes
Improvements
## Features - #2809 MethodCallTarget - Support for Lamba method (@snakefoot) - #2816 MessageTemplates - Support rendering of alignment + padding (@sna
## Features - #2792 OutputDebugStringTarget - Support Xamarin iOS and Android (@snakefoot) - #2776 FileTarget - Introduced OpenFileFlushTimeout to hel
Fixup for NLog.WindowsEventLog package
## Fixes - #2736 FileTarget - Calculate correct archive date when multiple file appenders (@snakefoot) ## Features - #2726 WhenRepeated - Support logg
Sonar warning fixes: #2691, #2694, #2693, #2690, #2685, #2683, #2696 (@snakefoot, @304NotModified)
#### Fixes - #2662 FileTarget - Improve handling of archives with multiple active files (@snakefoot) #### Enhancements - #2587 Internal Log - Include
#### Features - #2648 ${processtime} and ${time} added invariant option (@snakefoot) #### Fixes - #2643 UWP with NetStandard2 on Net Native does not s
Some small fixes and (performance) improvements. No critical bugs are reported for NLog 4.5.
Some small fixes and (performance) improvements. No critical bugs are reported for NLog 4.5.
NLog 4.5 adds structured logging and .NET Standard support/UPW without breaking changes! Also many features has been added!
NLog 4.5 adds structured logging and .NET Standard support/UPW without breaking changes! Also many features has been added!
List of important changes in NLog 4.5
Features:
BugFixes:
Performance:
string.Format allocation (for caching) when writing to a single target, instead format directly into output buffer. #2507 (@snakefoot)For a full list of all the enhancements and performance improvements: NLog 4.5 Pull Requests
NLog 4.5 adds structured logging and .NET Standard support/UPW without breaking changes! Also a lot features has been added!
List of important changes in NLog 4.5
Features
Fixes
Performance
string.Format allocation (for caching) when writing to a single target, instead format directly into output buffer. #2507 (@snakefoot)Changes since rc 07:
- #2612 add final param to AddRule Methods (#2612) (@893949088) - #2590 WebServiceTarget - JsonPost with support for single nameless parameter (@snake
AddRule Methods (#2612) (@893949088)- #2585 NLog 4.5 rc6 version and changelog (#2585) (@304NotModified) - #2581 MessageTemplateParameter(s) ctors to internal (@304NotModified) - #2576 F
- #2571 4.5 rc5 version and release notes (@304NotModified) - #2572 copyright 2018 (@304NotModified) - #2570 Update nuspec NLog.Config and NLog.Schema
- #2490 LogEventInfo.MessageTemplateParameters as class instead of interface (#2490) (@snakefoot) - #2510 Database target entity framework connection
- #2460 NLog 4.5 rc3 version and changelog (@304NotModified) - #2459 StringBuilderExt.CopyToStream - Optimize MemoryStream allocation (@snakefoot) - #
NLog 4.5 adds structured logging and .NET Standard support/UPW without breaking changes!
NLog 4.5 adds structured logging and .NET Standard support/UPW without breaking changes!
- #2414 Revert breaking change of NestedDiagnosticsLogicalContext.Pop() (@304NotModified) - #2415 NetStandard15 - Moved dependency System.Xml.XmlSeria
Nothing published for this version
- #2359 WrapperLayoutRendererBase - Transform with access to LogEventInfo (@snakefoot) - #2357 ExceptionLayoutRenderer - Support Serialize Format (@sn
- #2346 Add messageTemplateParser to XSD (@304NotModified) - #2348 NLog MessageTemplateParameter with CaptureType (@snakefoot)
- #2340 NLog - MessageTemplateParameters - Always parse when IsPositional (@304NotModified, @snakefoot) - #2337 Use string interpolation (@c0shea) - #
Structured logging is back! - #2318 NLog 4.5 beta 4 (@304NotModified) - #2326 NLog - ValueSerializer - Faster integer and enum (@snakefoot) - #2328 fi
Structured logging is back!
- #2298 Search also for lowercase nlog.config (@304NotModified) - #2297 WhenRepeatedFilter - Log after timeout (@snakefoot)
Note: structured logging has been removed in this beta and will be reintroduced in later betas
.NET Standard 2 support
Note: structured logging has been removed in this beta and will be reintroduced in later betas
One column per quarter.