DebugProbe.AspNetCore 1.6.0

DebugProbe.AspNetCore

DebugProbe.AspNetCore is a lightweight ASP.NET Core debugging tool for inspecting HTTP traffic directly inside your application.

It captures request and response data, exposes a local dashboard, and helps compare traces across environments so you can spot differences between local, staging, and other API runs.

Links

• Website: debugprobe.dev
• Documentation: debugprobe.dev/docs
• Roadmap: Roadmap.md
• Live demo: demo.debugprobe.dev/debug
• Demo API: demo.debugprobe.dev/swagger
• NuGet: DebugProbe.AspNetCore

Install

dotnet add package DebugProbe.AspNetCore

Quick Start

builder.Services.AddDebugProbe();

app.UseDebugProbe();

Start your application and open:

http://localhost:{port}/debug

Optional Configuration

builder.Services.AddDebugProbe(options =>
{
    options.MaxEntries = 10;

    options.MaxBodyCaptureSizeKb = 256;

    options.AllowLocalCompareTargets = true;

    options.IgnorePaths =
    [
        "/api/auth/login",
        "/api/auth/refresh"
    ];
});

app.UseDebugProbe();

Features

• Request inspection
• Response inspection
• Headers, query string, and body capture
• Error visibility
• Local debugging dashboard
• Trace comparison across runs or environments
• JSON formatting for captured payloads
• Configurable body capture limits
• Ignored path configuration for noisy or sensitive endpoints
• Sensitive header masking
• Outgoing HttpClient request tracing

Trace Compare

DebugProbe can compare a local trace with a trace captured by another DebugProbe-enabled application.

Typical workflow:

1. Run both applications with DebugProbe enabled.
2. Open the local dashboard at /debug.
3. Open the trace you want to compare.
4. Use the compare action and provide the remote application's base URL and trace ID.

Compare is useful when checking differences between local and remote environments, repeated runs, or two versions of the same API flow.

Dynamic values such as IDs, timestamps, tokens, and selected headers are normalized so the compare view focuses on meaningful request and response differences.

Security Defaults

DebugProbe masks common sensitive headers automatically:

• Authorization
• Cookie
• Set-Cookie

Intended Usage

DebugProbe is designed primarily for local development and controlled development environments.

If you use it outside local development, protect the dashboard with authentication, restrict network access, and avoid capturing sensitive endpoints or payloads.

Documentation

For full setup details, screenshots, dashboard behavior, configuration options, and live examples, see the documentation:

https://debugprobe.dev/docs

Contributing

Contributions are welcome. Please read CONTRIBUTING.md before opening an issue or pull request.

License

DebugProbe.AspNetCore is licensed under the Apache License 2.0.