README.md

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.

• (ASP.NET Core 1+2)
• (ASP.NET)

Getting started

• Getting started with ASP.NET Core 2
• Getting started with .NET Core 2 Console application
• Getting started with ASP.NET Core 1 (csproj - vs2017)
• Getting Started with ASP.NET Core 1 (project.json - vs2015)
• Multiple blogs to get started with ASP.NET Core and NLog

Updates

For updates and releases, check CHANGELOG.MD or Releases

ASP.NET Core 1 / ASP.NET Core 2

ℹ️ 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.

Installation

Include in your nlog.config:

<!-- enable asp.net core layout renderers -->
<extensions>
  <add assembly="NLog.Web.AspNetCore"/>
</extensions>

ASP.NET (non-core)

Use the NLog.Web package.

• Supported targets for ASP.NET
• Supported layout renderers for ASP.NET

Installation

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>

License

BSD