ExceptionNotification.Core is a NET core package that provides a set of notifiers for sending exception notifications when errors occur in your NET Core API. So far, the notifiers can deliver notifications only via e-mail, HipChat, and Slack. Its idea is based on the great ExceptionNotification gem that provides notifiers for Ruby applications.
- NET Core 2.2 SDK
Install this package using the NuGet command line:
PM> Install-Package ExceptionNotification.Core -Version 1.6.0ExceptionNotification.Core provides a middleware that catches exceptions for API requests. It also provides an interface to manually send notifications from a background process.
To setup the package you must add some credentials to your appsettings.<environment>.json file:
{
"ExceptionNotification": {
"Email": {
"SmtpServer": "your.server.com",
"SmtpPort": "25",
"SmtpUser": "username",
"SmtpPassword": "password",
"EnableSsl": true,
"UseCredentials": true,
"Sender": {
"DisplayName": "John Doe",
"Address": "[email protected]"
},
"Recipients": [
{
"DisplayName": "Mary",
"Address": "[email protected]"
}
]
},
"Hipchat": {
"RoomName": "Your Room",
"ApiToken": "D12@....."
},
"Slack": {
"WebhookUri": "https://...",
"Channel": "#channel-name",
"Username": "aperson"
}
}
}SmtpServer- required - Specifies the remote e-mail server address.SmtpPort- required - Port used by the e-mail server.SmtpUser- optional - If your e-mail server requires authentication, this setting specifies the username.SmtpPassword- optional - If your e-mail server requires authentication, this setting specifies the password.EnableSsl- optional.UseCredentials- optional - Defaults totrue. It can be set tofalsein case that you are using a relay server to send e-mails. In such case, you don't need to specify theSmtpUserandSmtpPassword.Sender- required - Specifices who the notification message is from.Recipients- required - List of recipients that will receive the notification message.
RoomName- required - Specifies the HipcHat's room name where the notification message will be published to.ApiToken- required - The API token that allows access to your HipChat account.
WebhookUri- required - The incoming Webhook URI on Slack.Channel- optional - Channel's name in which the message will appear.Username- optional - Username of the bot.
The package initialization should be setup in the Startup.cs:
public class Startup
{
// ...
public void Configure(IApplicationBuilder app)
{
// Bind options from appsettings file.
var config = new ExceptionNotifierConfiguration();
Configuration.Bind("ExceptionNotification", config);
app.AddExceptionNotification(config);
}
}Take into account that the app.AddExceptionNotifier() call adds the ExceptionMiddleware middleware to your application under the covers. Since the order of middlewares matter, you would want to call this method at the very beginning of the Configure. Thus, the ExceptionMiddleware gets added before all others.
In case that you want to send notifications from a background process, you can make use of the ExceptionNotifier interface:
try
{
// ...
}
catch(Exception exception)
{
ExceptionNotifier.NotifyException(exception);
}- This package currently provides e-mail, HipChat, and Slack notifiers. It would be ideal to implement other notifiers as well.
- More testing is also needed.
- Extend configuration to allow custom exception notification subject.
- Add more detailed information about request and session to exception notification messages.
We encourage you to contribute to ExceptionNotification.Core by following the CONTRIBUTING instructions.
This package is available as open source under the MIT license.