Wallsmedia.Microsoft.Extensions.Logging.NLog
2.2.0
See the version list below for details.
dotnet add package Wallsmedia.Microsoft.Extensions.Logging.NLog --version 2.2.0
NuGet\Install-Package Wallsmedia.Microsoft.Extensions.Logging.NLog -Version 2.2.0
<PackageReference Include="Wallsmedia.Microsoft.Extensions.Logging.NLog" Version="2.2.0" />
paket add Wallsmedia.Microsoft.Extensions.Logging.NLog --version 2.2.0
#r "nuget: Wallsmedia.Microsoft.Extensions.Logging.NLog, 2.2.0"
// Install Wallsmedia.Microsoft.Extensions.Logging.NLog as a Cake Addin #addin nuget:?package=Wallsmedia.Microsoft.Extensions.Logging.NLog&version=2.2.0 // Install Wallsmedia.Microsoft.Extensions.Logging.NLog as a Cake Tool #tool nuget:?package=Wallsmedia.Microsoft.Extensions.Logging.NLog&version=2.2.0
Microsoft.Extensions.Logging.NLog
Version 2.2.0
- Support SDK v.2.2.0
Version 2.1.0
- Add support the feature turn on/off scope logging
- Support SDK v.2.1.3
Microsoft.Extensions.Logging.NLog is an adapter between NLog and Microsoft.Extensions.Logging.
It allows to simplify using NLog by utilizing ILoggerFactory and ILogger interfaces in an application.
NLog is a flexible and free logging platform for various .NET platforms, including .NET standard. NLog makes it easy to write to several targets. (database, file, console) and change the logging configuration on-the-fly.
Nuget.org
- Nuget package Microsoft.Extensions.Logging.NLog
Adding Microsoft.Extensions.Logging.NLog
You have to define two configurations:
Create the NLog configuration xml
<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
autoReload="true"
internalLogLevel="Warn"
internalLogFile="c:\temp\internal-nlog.txt">
<targets>
<target xsi:type="Null" name="NullLog" />
<target xsi:type="Null" name="SystemLog" />
<target xsi:type="Console" name="ConsoleInfoLog" />
<target xsi:type="Console" name="ConsoleErrorLog" error="true" />
<target xsi:type="File" name="CommonInfoLogFile"
fileName="\Logs\RestWebApplication\Info\RestWebApp_CommonInfo-P_${processid}-${shortdate:universalTime=true}.log"
layout="${longdate:universalTime=true}|${event-properties:item=EventId.Id}|${logger}|${uppercase:${level}}|${message}| ${exception}" />
<target xsi:type="File" name="BusinessErrorLogFile"
fileName="\Logs\RestWebApplication\BusinessError\RestWebApp_BusinessError-P_${processid}-${shortdate:universalTime=true}.log"
layout="${longdate:universalTime=true}|${event-properties:item=EventId.Id}|${logger}|${uppercase:${level}}|${message}| ${exception}" />
<target xsi:type="File" name="FatalErrorLogFile"
fileName="\Logs\RestWebApplication\Error\RestWebApp_FatalError-P_${processid}-${shortdate:universalTime=true}.log"
layout="${longdate:universalTime=true}|${event-properties:item=EventId.Id}|${logger}|${uppercase:${level}}|${message}| ${exception:innerFormat=Message,Method,StackTrace:maxInnerExceptionLevel=1:format=Message,Method,StackTrace}" />
</targets>
<rules>
<logger name="FatalError" writeTo="FatalErrorLogFile,CommonInfoLogFile" minlevel="Error" final="true" enabled="true" />
<logger name="BusinessError" writeTo="BusinessErrorLogFile,CommonInfoLogFile" minlevel="Error" final="true" enabled="true" />
<logger name="CommonInfo" writeTo="CommonInfoLogFile" minlevel="Info" final="true" enabled="true" />
<logger name="ConsoleError" writeTo="ConsoleErrorLog,FatalErrorLogFile,CommonInfoLogFile" minlevel="Error" final="true" enabled="true" />
<logger name="ConsoleInfo" writeTo="ConsoleInfoLog,CommonInfoLogFile" minlevel="Info" final="true" enabled="true" />
<logger name="Microsoft*" minlevel="Trace" writeTo="SystemLog" final="true" enabled="false" />
<logger name="*" minlevel="Trace" writeTo="NullLog" />
</rules>
</nlog>
Create NLogLoggerSettings configuration section in "appsettings.json".
The NLogLoggerSettings section defines the Category Name "filter" and Category Name "mapper".
{
"NLogLoggerSettings": {
"IncludeScopes": true,
"AcceptedCategoryNames": [ /* Filter of category name */
"ConsoleInfo", /* The category name is accepted as a "NLog logger name" */
"CommonInfo", /* The category name is accepted as a "NLog logger name" */
"ConsoleError", /* The category name is accepted as a "NLog logger name" */
"FatalError", /* The category name is accepted as a "NLog logger name" */
"BusinessError", /* The category name is accepted as a "NLog logger name" */
"*Error*", /* The category name that contains "Error" is accepted as a "NLog logger name" */
"*Info", /* The category name that ends with "Info" is accepted as a "NLog logger name" */
"Com*", /* The category name that starts with "Com" is accepted as a "NLog logger name" */
"*" /* Any category name will be accepted as a "NLog logger name" */
],
/* Map category name "ABC" to "NLog logger name" = "ConsoleError" */
"AcceptedAliasesCategoryNames:ABD": "ConsoleError"
/* Map category name that ends with "*Hosted" to "NLog logger name" = "ConsoleError" */
"AcceptedAliasesCategoryNames:*Hosted": "ConsoleError"
/* Map category name that starts with "Microsoft.AspNetCore*" to "NLog logger name" = "ConsoleError" */
"AcceptedAliasesCategoryNames:Microsoft.AspNetCore*": "ConsoleError"
/* Map category name that contains "*AspNetCore*" to "NLog logger name" = "ConsoleError"*/
"AcceptedAliasesCategoryNames:*AspNetCore*": "ConsoleError"
/* Map any category to "NLog logger name" = "ConsoleError" */
"AcceptedAliasesCategoryNames:*": "ConsoleError"
}
}
The AcceptedCategoryNames - "category name filter" is used to filter-in category names. It is expected that the category name is exact match to <logger name="...." in the NLog xml configuration.
The AcceptedAliasesCategoryNames - "category name mapper" is used to filter-in category names and map them onto new name that expected to be match to <logger name="..." in the NLog xml configuration.
Web Host Builder configuration
After defining the configurations, add in the Web Host Builder configuring of Microsoft.Extensions.Logging.LoggerFactory the following initialization code:
.ConfigureLogging((hostingContext, logging) =>
{
// ** Add Microsoft.Extensions.Logging.NLog
string logPath = Path.Combine(hostingContext.HostingEnvironment.ContentRootPath, $"nlog.{hostingContext.HostingEnvironment.EnvironmentName}.config");
if (!File.Exists(logPath))
{
throw new MissingMemberException($"Missing NLog configuration file '{logPath}'");
}
var nLoggingConfiguration = new XmlLoggingConfiguration(logPath);
var logJsonCgf = hostingContext.Configuration.GetSection(nameof(NLogLoggerSettings));
if (!logJsonCgf.Exists())
{
throw new MissingMemberException($"Missing configuration section '{nameof(NLogLoggerSettings)}'");
}
logging.AddNLogLogger(logJsonCgf, nLoggingConfiguration);
}
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | 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 | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- Microsoft.Extensions.Configuration (>= 2.2.0)
- Microsoft.Extensions.Configuration.Binder (>= 2.2.0)
- Microsoft.Extensions.Logging (>= 2.2.0)
- NLog (>= 4.5.11)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Singed assembly; version for netstandard2.0 and Microsoft.Extensions.Logging 2.2.0-*