Web request logging and enrichment for classic ASP.NET applications (System.Web).
Package - SerilogWeb.Classic | Platforms - .NET 4.5
This package replaces the Serilog.Extras.Web package previously included in the Serilog project.
When you work with an ASP.NET web application, this package adds additional enrichers and an HttpModule
to enhance the logging output. The following enrichers are available:
- HttpRequestId A GUID used to identify requests.
- HttpRequestNumber an incrementing number per request.
- HttpRequestTraceId GUID matching the RequestTraceIdentifier assigned by IIS and used throughout ASP.NET/ETW. IIS ETW tracing must be enabled for this to work.
- HttpSessionId The current ASP.NET session id.
- UserName The current username or, when anonymous, a defined value. By default this is set to (anonymous).
var log = new LoggerConfiguration()
.WriteTo.ColoredConsole()
.Enrich.With<HttpRequestIdEnricher>()
.Enrich.With<UserNameEnricher>()
.CreateLogger();
To override the username enricher behaviour:
var log = new LoggerConfiguration()
.WriteTo.ColoredConsole()
.Enrich.With(new UserNameEnricher("not known yet", System.Environment.UserName))
.CreateLogger();
The ApplicationLifecycleModule will automatically be enabled and will write information events about the current method and url that is being accessed. Optionally you also store any form data that is posted to the server. When an unhandled exception occurs, the module will capture it and log it as an error event.
To enable the posting of form data:
ApplicationLifecycleModule.LogPostedFormData = LogPostedFormDataOption.Always;
// or
ApplicationLifecycleModule.LogPostedFormData = LogPostedFormDataOption.OnlyOnError;
Any fields containing the phrase 'password' will be filtered from the logged form data. This can be disabled with ApplicationLifecycleModule.FilterPasswordsInFormData = false
.
If you want to disable the logging completely, use the following statement:
ApplicationLifecycleModule.IsEnabled = false;