🚀 RootAlert: Real-time Exception Tracking & Alerts for .NET!

RootAlert is a powerful, lightweight real-time error tracking and alerting library for .NET applications. Whether you're building a small API or a large-scale enterprise system, RootAlert helps you monitor unhandled exceptions and get instant alerts in Microsoft Teams, Slack, and (soon) Email!

🔥 Why Use RootAlert?

✅ Automatically capture unhandled exceptions via middleware.

✅ Batch alerts to prevent spam while still getting timely notifications.

✅ Multi-service alerting – Send error notifications to Teams, Slack, and Email.

✅ Customizable batch intervals – Choose when to receive grouped alerts.

✅ Rich error logs with request details, headers, and stack traces.

---

📦 Installation & Setup

RootAlert is available on NuGet:

 dotnet add package RootAlert --version 0.1.5

Or via Package Manager:

 Install-Package RootAlert -Version 0.1.5

1️⃣ Add RootAlert to Your .NET Project

In Program.cs, configure RootAlert with multiple alert destinations:

using RootAlert.Config;
using RootAlert.Extensions;

var builder = WebApplication.CreateBuilder(args);

var rootAlertOptions = new List<RootAlertOption>
{
    new RootAlertOption
    {
        AlertMethod = AlertType.Teams,
        WebhookUrl = "https://your-teams-webhook-url"
    },
    new RootAlertOption
    {
        AlertMethod = AlertType.Slack,
        WebhookUrl = "https://your-slack-webhook-url"
    }
};

var rootAlertSetting = new RootAlertSetting
{
    BatchInterval = TimeSpan.FromSeconds(20),
    RootAlertOptions = rootAlertOptions,
};


builder.Services.AddRootAlert(rootAlertSetting);

var app = builder.Build();

// ✅ Handle exceptions first
app.UseMiddleware<ExceptionHandlingMiddleware>();

// ✅ Then, log errors with RootAlert
app.UseRootAlert();

app.UseRouting();
app.UseEndpoints(endpoints => { endpoints.MapControllers(); });

app.Run();

✅ Now, RootAlert will capture all unhandled exceptions and send alerts to multiple services!

---

⚠️ Important Notes

❗ If an exception filter is added, RootAlert won't work.

Reason: Exception filters handle errors before middleware gets a chance to process them. Since RootAlert works as middleware, it will never see the exception if a filter catches it first.

✅ Solution: Ensure RootAlert is added after any existing exception-handling middleware.

If your application has a global exception-handling middleware, register RootAlert after it to ensure exceptions are logged correctly. Example:

app.UseMiddleware<ExceptionHandlingMiddleware>(); // Your existing middleware
app.UseRootAlert(); // Register RootAlert after the exception middleware

---

🏆 Microsoft Teams Integration

RootAlert supports Microsoft Teams integration via:

1. Incoming Webhooks (Connector) – Simple and quick setup. (Will be deprecated)
2. Microsoft Teams Workflow API – Easier than Power Automate, with a built-in Webhook template.

---

🔹 Option 1: Using an Incoming Webhook (Connector)

This method is the easiest way to receive error alerts in a Teams channel.

📌 Steps to Get a Teams Webhook URL

1. Open Microsoft Teams and go to the desired channel.
2. Click "…" (More options) → Connectors.
3. Find "Incoming Webhook" and click "Configure".
4. Name it RootAlert Notifications and click Create.
5. Copy the Webhook URL and use it in your RootAlert configuration.

---

🔹 Option 2: Using Microsoft Teams Workflow API (via Webhook Template)

This method is even easier than Power Automate and uses a built-in workflow to receive data via Webhook.

🎥 Watch this video for a step-by-step guide:



🔗 YouTube Link: https://www.youtube.com/watch?v=jHTU_jUnswY

📌 Steps to Configure Teams Workflow API

1. Open Microsoft Teams and Go to Workflows

   • Click on “…” (More options) → Workflows. --> Create

2. Select "Post to a channel when a webhook request is received" Template

   • Search for "Post to a channel when a webhook request is received" and select the ready-made template.
   • Click Next to proceed.

3. Choose Team and Channel

   • Select the Team where you want to post alerts.
   • Choose the Channel where notifications should appear.

4. Copy the Webhook URL

   • After selecting the Team and Channel, Teams will generate a Webhook URL.
   • Copy this URL and use it in your RootAlert settings.

---

💬 Slack Integration

🔹 How to Set Up a Slack Webhook

1. Go to https://api.slack.com/apps.
2. Create a new Slack App → Enable Incoming Webhooks.
3. Click Add New Webhook to Workspace, choose a channel.
4. Copy the Webhook URL and paste it in RootAlertOptions.

🔹 Example Slack Alert (Blocks & Sections Format)

RootAlert formats messages beautifully in Slack:

---

🚨 Example Error Alert

This is how RootAlert captures errors and logs detailed request information:

🆔 Error ID: abc123
⏳ Timestamp: 02/05/2025 4:02:41 AM
----------------------------------------------------
🌐 REQUEST DETAILS
🔗 URL: /weatherforecast
📡 HTTP Method: GET
----------------------------------------------------
📩 REQUEST HEADERS
📝 User-Agent: Mozilla/5.0
----------------------------------------------------
⚠️ EXCEPTION DETAILS
❗ Type: DivideByZeroException
💬 Message: Attempted to divide by zero.
----------------------------------------------------
🔍 STACK TRACE
   at Program.Main() in Program.cs:line 54
   at RootAlertMiddleware.Invoke()
----------------------------------------------------

---

🔜 Coming Soon!

✔ Database Storage - Store logs in MSSQL and Postgres
For Redis ->> using storage with Redis
✔ Email Alerts via SMTP - Get notifications in your inbox.

✔ Severity Filtering - Customize alerts based on error level.

---