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
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
Use the NLog.Web.AspNetCore package
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