wagnerhsu / sample-nlog.web

NLog integration for ASP.NET & ASP.NET Core 1-3

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 5
• Getting started for ASP.NET Core 3
• Getting started for ASP.NET Core 2
• Getting started for .NET Core 2 Console application
• 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

The NLog.Web.AspNetCore-package supports the 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+

ℹ️ Missing the trace and debug logs? Check your appsettings.json

Use the NLog.Web.AspNetCore package

• Supported layout renderers for ASP.NET Core

ASP.NET (non-core)

The NLog.Web-package works with classic ASP.NET MVC

• Supported targets for ASP.NET
• Supported layout renderers for ASP.NET
• NLog 5.0 requires that NLog.config must include NLog.Web in extensions:

  <!-- enable ASP.NET layout renderers -->
  <extensions>
    <add assembly="NLog.Web"/>
  </extensions>

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