NLog.Web (ASP.NET & ASP.NET Core)

These packages are extensions to NLog.

The packages contain targets and layout-renderes specific to ASP.NET (Core), MVC and IIS.

Getting started with NLog

• Getting started for ASP.NET Core 3
• Getting started for ASP.NET Core 2
• Getting started for .NET Core 2 Console application
• Getting started for ASP.NET Core 1 (csproj - vs2017)
• How to use structured logging

Config

• All config options: nlog-project.org/config

Troubleshooting

• Troubleshooting
• Internal log

Releases

For updates and releases, check CHANGELOG.MD or Releases

ASP.NET Core

ASP.NET Core 1, 2, 3 and 5 are supported!

Supported platforms:

• For ASP.NET Core 5, .NET 5
• For ASP.NET Core 3, .NET Core 3.0
• For ASP.NET Core 2, .NET Standard 2.0+ and .NET 4.6+
• For ASP.NET Core 1, .NET Standard 1.5+ and .NET 4.5.x

ℹ️ Missing the trace and debug logs in .NET Core 2? Check your appsettings.json

Use the NLog.Web.AspNetCore package

• Supported layout renderers for ASP.NET Core

There is a special package for ASP.NET Core / MVC Core. This is needed because we can't detect if ASP.NET or ASP.NET Core is used. The package depends on NLog.Extensions.Logging - which integrates with the ASP.NET Core logging system.

ASP.NET (non-core)

Use the NLog.Web package.

• Supported targets for ASP.NET
• Supported layout renderers for ASP.NET
• Simply install the package. NLog will detect the extension automatically.

HTTP module (ASP.NET non-core)

note: not listed on https://nlog-project.org/config

There is a ASP.NET ASP.NET HttpModule that enables NLog to hook BeginRequest and EndRequest events easily.

The NLogHttpModule needs a registration in the web.config:

<system.webServer> 
	<modules runAllManagedModulesForAllRequests="true"> 
		<add name="NLog" type="NLog.Web.NLogHttpModule, NLog.Web" />
	</modules>
</system.webServer>

Contributions

Contributions are highly appreciated! Please make sure if works for ASP.NET and ASP.NET Core if possible and make sure it is covered by unit tests.

License

BSD