RuntimeLens.AspNetCore 1.0.1

RuntimeLens.AspNetCore

ASP.NET Core integration for RuntimeLens providing request telemetry middleware, DI extensions, [ProfileMethod] action filter, and automated DiagnosticSource listeners.

Target Frameworks

• .NET 8.0 | .NET 9.0 | .NET 10.0

Extension Methods & Attribute Reference

1. DI Service & Middleware Registration

2. [ProfileMethod] Action Filter Attribute

[AttributeUsage(AttributeTargets.Method | AttributeTargets.Class, Inherited = true, AllowMultiple = false)]
public sealed class ProfileMethodAttribute : Attribute
{
    public string? OperationName { get; } // Custom operation name (null = method name)
    public string Category { get; }       // Classification category tag (default: "Method")

    public ProfileMethodAttribute(string? operationName = null, string category = "Method");
}

Automated Telemetry Listeners

• HTTP Request Middleware: Captures HTTP Method, Route Path, Status Code, Latency, Memory allocated, Client IP, and Query parameters.
• EF Core & SQL Listener: Intercepts DiagnosticSource events from Microsoft.EntityFrameworkCore and System.Data.SqlClient / Microsoft.Data.SqlClient to record SQL statements and latency.
• Outgoing HttpClient Listener: Intercepts System.Net.Http outgoing calls and appends child sub-spans.
• Built-in Noise Filter: Excludes Chrome DevTools, Hot Reload (/signalr), BrowserLink, /favicon.ico, and .map source map requests automatically.

Code Examples

1. ASP.NET Core Setup (Program.cs)

using RuntimeLens.AspNetCore.Extensions;
using RuntimeLens.Options;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddControllers();

// Register RuntimeLens telemetry services in DI container
builder.Services.AddRuntimeLens(options =>
{
    // Enable automated diagnostic listeners
    options.EnableSqlTracking = true;       // Intercept EF Core & SQL database queries
    options.EnableHttpTracking = true;      // Intercept incoming/outgoing HTTP calls
    options.EnableMemoryTracking = true;    // Track memory allocations per request
    options.EnableGcTracking = true;        // Track GC collections per request

    // Configure storage backend (File-based persistence)
    options.Storage.Mode = StorageMode.File;
    options.Storage.FilePath = "runtimelens-web-traces.json";
    options.Storage.MaxSnapshotsInMemory = 5000;

    // Configure filtering & thresholds
    options.Filters.SlowRequestThresholdMs = 400.0; // Slow threshold: 400ms
    options.Filters.TrackDashboardRequests = false; // Ignore self-profiling dashboard routes
    options.Filters.IgnorePath("/healthz");         // Ignore healthcheck endpoint
});

var app = builder.Build();

app.UseRouting();

// Enable RuntimeLens telemetry middleware (place AFTER UseRouting)
app.UseRuntimeLens();

app.MapControllers();

app.Run();

2. Controller Action Profiling ([ProfileMethod])

using Microsoft.AspNetCore.Mvc;
using RuntimeLens.Abstractions;
using RuntimeLens.AspNetCore.Filters;

[ApiController]
[Route("api/[controller]")]
public class ProductsController : ControllerBase
{
    private readonly IRuntimeLens _lens;

    public ProductsController(IRuntimeLens lens)
    {
        _lens = lens; // Inject telemetry engine
    }

    [HttpGet("{id}")]
    [ProfileMethod("GetProductById", Category = "Catalog")] // Automated action method profiling
    public async Task<IActionResult> GetProduct(int id)
    {
        // Attach custom diagnostic tags to current active action scope
        _lens.AddTag("product.id", id.ToString());

        // Create explicit child sub-span scope for specific internal operations
        using (var cacheSpan = _lens.StartScope("CheckCache", category: "Cache"))
        {
            cacheSpan.AddTag("cache.key", $"product:{id}");
            await Task.Delay(10); // Simulate cache lookup
        } // Sub-span closed and attached to action trace tree

        return Ok(new { Id = id, Name = "Sample Product" });
    } // Action method completed and recorded automatically by ProfileMethodActionFilter
}

Learn More

👉 RuntimeLens GitHub Repository