Elmah.AspNetCore 1.0.1

Elmah.AspNetCore

ELMAH (Error Logging Middleware and Handlers) for ASP.NET Core.

Features include:

• Logging of unhandled exceptions
• Friendly UI to view captured errors along with contextual information
• Hooks to include handled exceptions and additional contextual information
• Various methods to persist error logs
• Supports securing UI via built-in ASP.Net Core functionality
• Notifications of errors through email or custom notifiers
• Integration with Microsoft.Extensions.Logging to capture logs made during a request
• Supports .NET 6+

Basic usage

First, install the Elmah.AspNetCore Nuget package into your app.

dotnet add package Elmah.AspNetCore

Next, in your application's Program.cs file, configure Elmah:

using Elmah.AspNetCore;

var builder = WebApplication.CreateBuilder(args);

builder.Host.UseElmah(); // <- Add this to configure Elmah

var app = builder.Build();

app.UseErrorHandler();
app.UseElmahMiddleware(); // <- Add this to register middleware

app.MapElmah(); // <- Add this to register Elmah endpoints

builder.Host.UseElmah() registers and configures the Elmah services. An overload which accepts an action is available to modify the configuration.

app.UseElmahMiddleware() registers the middleware used by Elmah to start capturing errors and contextual information. Only middleware registered after the Elmah middleware will be included in the error capturing. It is recommended that this is included before most other middleware. For best results, call after the built-in UseExceptionHandler().

app.MapElmah() registers the routes used to serve content for the Elmah UI. By default these will be under /elmah, but the method includes an overload which allows overriding the root path.