HttpLens 1.0.0

HttpLens

Install one NuGet package, add two lines of code, and see every outbound HTTP call your app makes — in a browser dashboard.

Features

• Automatic interception — captures all HttpClient requests/responses via IHttpClientFactory
• Embedded dashboard — dark/light theme SPA served at /_httplens
• Sensitive header masking — Authorization, Cookie, X-Api-Key and custom headers masked before storage
• Request/response body capture — with configurable size limits and truncation
• Polly retry detection — groups retry attempts visually in the dashboard
• Export — one-click copy as cURL or C# HttpClient code; download HAR 1.2 files
• Correlation — W3C Trace ID, inbound request path, HttpClient name
• In-memory ring buffer — configurable max records, thread-safe
• Real-time updates — polling fallback (SignalR planned)

Installation

dotnet add package HttpLens

Quick Start

var builder = WebApplication.CreateBuilder(args);

// 1. Register HttpLens services
builder.Services.AddHttpLens();

var app = builder.Build();

// 2. Mount the dashboard
app.MapHttpLensDashboard();

app.Run();

Then open https://localhost:5001/_httplens in your browser.

Configuration

builder.Services.AddHttpLens(options =>
{
    options.MaxStoredRecords = 1000;
    options.SensitiveHeaders.Add("X-Custom-Secret");
    options.CaptureRequestBody = true;
});

Polly Retry Detection

To group Polly retry attempts in the dashboard:

builder.Services
    .AddHttpClient("MyClient")
    .AddStandardResilienceHandler()   // Polly resilience
    .Services
    .AddHttpClient("MyClient")
    .AddRetryDetection();             // HttpLens retry tracking

Retried requests are grouped visually — the first attempt appears as a normal row, subsequent retries appear indented beneath it.

Export Features

• cURL — Click "📋 Copy" on the Export tab to copy a ready-to-paste cURL command
• C# — Copy a complete HttpClient / HttpRequestMessage code snippet
• HAR — Click "📦 HAR" to download all filtered traffic as a HAR 1.2 file (importable in Chrome DevTools)

Dark / Light Theme

Toggle between dark and light themes using the 🌙/☀️ button in the header. Preference is saved to localStorage.

API Endpoints

License

MIT