Appulse.Core 1.0.1

Appulse

Production-grade structured logging middleware for ASP.NET Core 8+.

Appulse captures HTTP traffic, in-code logs, and exceptions; stores them asynchronously via System.Threading.Channels for zero impact on the hot path; and provides a built-in realtime Blazor dashboard.

Features

• Zero-blocking Hot Path: All log writes use System.Threading.Channels to decouple capture from DB I/O.
• Granular HTTP Capture: Configure whitelist/blacklist to skip, partially log, or redact requests.
• Structured Logging: Includes a Serilog Sink (WriteTo.Appulse()) to unify application logs and HTTP logs.
• Data Sanitization: Mask sensitive headers and JSON body fields (e.g. Authorization, password) automatically before storage.
• High-Performance Storage: Uses Dapper + UNNEST for true bulk inserts to PostgreSQL.
• Embedded Realtime Dashboard: Blazor Server-based dashboard directly embedded in your app, updated via SignalR.
• Auto Data Retention: Opt-in background job to clean up logs older than X days.

Getting Started

1. Install Packages

dotnet add package Appulse.AspNetCore
dotnet add package Appulse.Storage.Postgres
dotnet add package Appulse.Serilog

2. Configure Services

In your Program.cs:

using Appulse.AspNetCore;
using Appulse.Storage.Postgres;
using Serilog;
using Appulse.Serilog;

var builder = WebApplication.CreateBuilder(args);

// Configure Serilog
builder.Services.AddSerilog((services, config) =>
{
    config.WriteTo.Appulse(services);
});

// Add Appulse
builder.Services.AddAppulse(options =>
{
    // By default, dashboard requires the user to have the "AppulseAdmin" role.
    options.Dashboard.RequireAuthentication = !builder.Environment.IsDevelopment();
});

var connectionString = builder.Configuration.GetConnectionString("AppulseDb");
builder.Services.AddAppulsePostgres(connectionString);

var app = builder.Build();

// Add middlewares (must be early in the pipeline)
app.UseAppulse(); 

app.Run();

3. View the Dashboard

Run your application and navigate to /appulse to view the realtime dashboard.

Advanced Configuration

Data Sanitization

builder.Services.AddAppulse(options =>
{
    options.EnableSanitization = true;
    options.MaskedHeaders.Add("X-API-Key");
    options.MaskedBodyFields.Add("secretToken");
});

Data Retention

builder.Services.AddAppulse(options =>
{
    options.EnableDataRetention = true;
    options.RetentionDays = 30;
    options.RetentionRunInterval = TimeSpan.FromDays(1);
});

RBAC for Dashboard

By default, the dashboard requires users to have the AppulseAdmin role if RequireAuthentication = true. You can customize the required role:

builder.Services.AddAppulse(options =>
{
    options.Dashboard.RequiredRole = "SuperAdmin";
});

Architecture

Please check out our design documents in docs-internal/ for Architecture Decision Records (ADR).