Seq is the go-to structured log viewer for .NET teams — and for good reason. It's polished, powerful, and developer-friendly. But for many projects — local development, internal tools, small teams — running a separate log viewer process adds complexity that isn't always necessary.
SinkSharp ships a built-in real-time log dashboard as part of SinkSharp.Sinks.Dashboard. It mounts on your existing ASP.NET Core host — same port, no separate process, no external dependency. Free forever.
💡 The dashboard is a sink in SinkSharp's pipeline — log events flow through the same enrichment and formatting stages as any other sink, then get broadcast to connected browsers via SignalR. It replays the last 500 events to new connections so you never miss context when you open the tab.
Setup — Web API (Same Port)
For ASP.NET Core Web API and Minimal API apps, the dashboard mounts on your existing host. No extra port, no separate Kestrel instance:
dotnet add package SinkSharp.Core
dotnet add package SinkSharp.Sinks.Dashboard
dotnet add package SinkSharp.Sinks.Console
dotnet add package SinkSharp.Sinks.FileDashboardSink dashSink = null!;
builder.Services.AddSinkSharpWithHealth(options => options
.MinimumLevel(LogLevel.Information)
.MinimumLevelFor("Microsoft", LogLevel.Warning)
.MinimumLevelFor("System.Net", LogLevel.Error)
.WithCorrelationId()
.WithEnvironment(builder.Environment.ApplicationName,
builder.Environment.EnvironmentName)
.WithPiiMasking()
.WithDashboard(out dashSink) // ← returns DashboardSink
.WriteTo(new ColoredConsoleSink())
.WriteTo(new RollingFileSink("logs", "SinkSharp.WebApi")));
// Register SignalR hub with DI
builder.Services.AddSinkSharpDashboard(dashSink);
var app = builder.Build();
// One-line correlation middleware (Web API / Minimal API)
// Reads X-Correlation-Id header, generates if missing,
// sets AsyncLocal, writes ID back in response header.
app.UseSinkSharp();
// Mount dashboard — same host and port as your API
app.UseSinkSharpDashboard("/sinksharp/dashboard");
app.MapHealthChecks("/health");
app.Run();Once running, three endpoints are available on your existing host and port:
https://localhost:5001/sinksharp/dashboard ← real-time log UI
https://localhost:5001/sinksharp/dashboard/hub ← SignalR hub
https://localhost:5001/sinksharp/dashboard/stats ← JSON queue statsSetup — Console App / Worker Service (Standalone Port)
For console apps and Worker Services without an HTTP pipeline, the dashboard runs as a standalone DashboardServer on its own port:
var builder = SinkSharpBuilder
.Create()
.MinimumLevel(LogLevel.Debug)
.WithCorrelationId()
.WithEnvironment("MyApp", "Development")
.WithPiiMasking()
.WithDashboard(out var dashSink)
.WriteTo(new ColoredConsoleSink())
.WriteTo(new RollingFileSink("logs", "MyApp"));
var logger = builder.BuildLogger("MyApp");
// Standalone dashboard on port 5341 (same default as Seq)
var dashboard = new DashboardServer(dashSink, port: 5341, queue: builder.GetQueue());
await dashboard.StartAsync();
await dashboard.Ready;
// Dashboard available at:
// http://localhost:5341 ← UI
// http://localhost:5341/hub ← SignalR
// http://localhost:5341/stats ← JSON statsHow the Dashboard Works
The DashboardSink sits at the end of SinkSharp's pipeline. After enrichment, PII masking, and formatting, each log event is converted to a DashboardLogEvent and handled in two ways:
- Added to a ring buffer of the last 500 events (configurable via
bufferSizeinWithDashboard()). New browser connections receive this buffer immediately on connect — you open the tab and see context without waiting for new events. - Broadcast to all connected clients via SignalR's
Clients.All.SendAsync("log", ev)— live streaming with no polling.
public async ValueTask EmitAsync(LogEvent logEvent, CancellationToken ct = default)
{
var ev = DashboardLogEvent.From(logEvent);
Buffer.Add(ev); // ring buffer
if (_hub is not null)
await _hub.Clients.All.SendAsync("log", ev, ct); // live broadcast
}Health Check Integration
When you use AddSinkSharpWithHealth(), SinkSharp registers a health check that monitors the queue state. The /stats endpoint returns live queue metrics:
{
"totalEnqueued": 14823,
"totalProcessed": 14820,
"totalDropped": 0,
"pendingCount": 3,
"uptimeSeconds": 3612
}The /health endpoint from app.MapHealthChecks("/health") reflects the queue state: Healthy when pending is normal, Degraded when pending exceeds warnAt (default 10,000), Unhealthy when totalDropped > 0.
SinkSharp Dashboard vs Seq
| Feature | Seq | SinkSharp Dashboard |
|---|---|---|
| Cost | Paid licence required | Free forever (Apache 2.0) |
| Setup | Separate process, separate port | Mounts on existing host/port |
| Real-time streaming | ✓ | ✓ via SignalR |
| Level filtering | ✓ | ✓ |
| Full-text search | ✓ (powerful) | ✓ (recent buffer) |
| Correlation trace | ✓ | ✓ |
| Long-term retention | ✓ (database backed) | Last 500 events in memory |
| Cloud deployment | ✓ | Local/dev use |
| Health check | ✗ | ✓ queue stats + /health |
| PII masking | ✗ built-in | ✓ built-in |
The SinkSharp dashboard is designed for local development and internal tools — not as a full Seq replacement for production observability at scale. For production, point SinkSharp.Sinks.File at your log aggregation pipeline (Loki, Azure Monitor, Elastic) and use the dashboard locally.
Configuring the Buffer Size
The ring buffer defaults to 500 events. For longer replay history, increase it in WithDashboard():
// Default — last 500 events replayed on new connection
.WithDashboard(out dashSink)
// Extended — last 2000 events
.WithDashboard(out dashSink, bufferSize: 2000)Buffer events live in memory — keep this proportional to your event payload size. For most apps, 500 events is enough to trace a full user session.
Summary
- Install
SinkSharp.Sinks.Dashboardand call.WithDashboard(out dashSink)in your builder - Web API:
AddSinkSharpDashboard(dashSink)+UseSinkSharpDashboard("/path")— mounts on your existing port - Console/Worker:
new DashboardServer(dashSink, port: 5341)— standalone server - Ring buffer of 500 events replayed on connect — open the tab anytime and see context
- Live streaming via SignalR — no polling, sub-second latency
- Health check at
/healthand queue stats at/statsincluded withAddSinkSharpWithHealth()
Try SinkSharp in your project
Free dashboard, PII masking, correlation propagation — one package, drop-in ILogger replacement.