MSAPulse 1.0.1

MSAPulse

Production-Ready Observability Kit for .NET 10

MSAPulse is a lightweight, drop-in observability infrastructure designed for .NET applications. It solves logging, tracing, and database monitoring challenges with a single configuration line, eliminating the need for complex boilerplate code.

Unlike black-box NuGet packages, MSAPulse provides full source code ownership, allowing you to inspect, modify, and extend the architecture without vendor lock-in.

Key Features

Distributed Tracing & Logging

• Auto-Correlation: Generates a unique CorrelationId for every HTTP request and propagates it through the entire stack.
• Structured Logging: Pre-configured Serilog integration with rich context (MachineName, ThreadId, UserAgent, RequestPath).
• Visual Dashboard: Includes a ready-to-use Docker setup for Seq (or compatible log servers).

Database Performance (EF Core)

• Slow Query Detection: Automatically intercepts and logs SQL queries exceeding your defined threshold (default: 500ms).
• Deep Insight: Captures the exact SQL command, parameters, and execution duration.
• Zero Code Change: Works via DbCommandInterceptor, requiring no changes to your existing repositories.

Source Code Control

• Clean Architecture: Strictly separated into Core (Interfaces/Models) and Infrastructure (Implementation).
• .NET 10 Ready: Built using the latest LTS features for maximum performance.
• No Hidden Dependencies: You own the code.

Integration Guide (3 Minutes)

1. Add Projects to Solution

Copy the src/MSAPulse.Core and src/MSAPulse.Infrastructure folders into your solution directory.

dotnet sln add src/MSAPulse.Core/MSAPulse.Core.csproj
dotnet sln add src/MSAPulse.Infrastructure/MSAPulse.Infrastructure.csproj

2. Add Reference

Link MSAPulse to your Web API project:

dotnet add YourWebApi/YourWebApi.csproj reference src/MSAPulse.Infrastructure/MSAPulse.Infrastructure.csproj

3. Configure Program.cs

Wire up the services and middleware in your startup file.

using MSAPulse.Infrastructure.Extensions;

var builder = WebApplication.CreateBuilder(args);

// 1. Register MSAPulse Services
builder.Services.AddMSAPulse(builder.Configuration);

// 2. Add Performance Interceptor to EF Core
builder.Services.AddDbContext<AppDbContext>((sp, options) =>
{
    options.UseSqlServer(connectionString)
           .AddMSAPulseInterceptor<AppDbContext>(sp);
});

var app = builder.Build();

// 3. Enable Middleware (Must be at the top of the pipeline)
app.UseMSAPulse();

app.Run();

Configuration

Control behavior via appsettings.json.

{
  "MSAPulse": {
    "SlowQueryThresholdMs": 500,        // Log warning if query takes > 500ms
    "EnablePerformanceTracking": true,  // Collect internal metrics
    "IncludeExceptionDetails": false,   // Set true for Development
    "SeqUrl": "http://localhost:5341"   // Log server URL
  }
}

Dashboard Setup

MSAPulse includes a docker-compose.yml file to spin up a local visualization dashboard (Seq) instantly.

docker-compose up -d

Access the dashboard at: http://localhost:8081

Architecture

MSAPulse.Core: Pure C# logic, Interfaces, Models. (Zero external dependencies).

MSAPulse.Infrastructure: Implementations, Middleware, Serilog configuration, and EF Core Interceptors.

License

MIT License

Copyright © 2025 MSA Technologies.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software.