ArgusLogs.UI 1.0.11

ArgusLogs.UI

A zero-dependency, high-performance, embedded log-viewer middleware package for ASP.NET Core with multi-target support across .NET 5.0, 6.0, 7.0, 8.0, 9.0, and 10.0.

Key Features

• 🚀 Zero External Infrastructure: Streams local log files in reverse order without requiring ClickHouse, PostgreSQL, or external databases.
• 📦 Embedded UI: 100% self-contained dark-mode dashboard (zero npm, zero CDN dependencies).
• 🔒 ArgusLogs.Core Integration: Auto-discovers and validates license keys (ECDsa NIST P-256) and configuration (LogFilePath, LogFileNameFormat, Format, UseShortKeys).
• ⚡ O(1) Reverse File Streaming: 64KB seek chunks from EOF backward to display the latest logs first with minimal memory overhead.
• 🛠️ SwaggerUI-Style DX: Single-line middleware registration via app.UseArgusUI().

Quickstart

Minimal APIs (.NET 6–10)

using ArgusLogs.UI;

var builder = WebApplication.CreateBuilder(args);

// Register Core Logging
builder.Services.AddArgusLogging(options =>
{
    options.LicenseKey = "YOUR-ARGUS-LICENSE-KEY";
});

// Optional: Register UI Services
builder.Services.AddArgusUI();

var app = builder.Build();

// Enable Embedded Log Viewer Dashboard
app.UseArgusUI(options =>
{
    options.RoutePrefix = "/argus-logs";
});

app.Run();

Navigate to http://localhost:<port>/argus-logs to inspect live structured logs.

Security

Protect the embedded dashboard in production with the built-in login page or host-app authorization filters.

Built-in login page

app.UseArgusUI(options =>
{
    options.RoutePrefix = "/argus-logs";
    options.RequireLogin("admin", "change-me-in-production");
    options.SessionDuration = TimeSpan.FromHours(8);
});

When RequireAuthentication is enabled:

• Unauthenticated visitors are redirected to /argus-logs/login
• API routes return 401 Unauthorized until a session cookie is issued
• Sessions are stored in an HttpOnly cookie signed with HMAC-SHA256

ASP.NET Core authentication integration

If your app already authenticates users, add a filter instead of (or in addition to) the built-in login:

using ArgusLogs.UI.Options;

app.UseArgusUI(options =>
{
    options.RoutePrefix = "/argus-logs";
    options.AddAuthorizationFilter(new AspNetCoreUserAuthorizationFilter());
});

Place UseArgusUI after UseAuthentication() so HttpContext.User is populated.

License plan limits (Free tier)

ArgusLogs.UI enforces plan-based caps automatically:

When TieredStorage is registered, AddArgusUI() clamps RetentionDays and BatchSize to the licensed maximum. Anonymous viewer cookies receive 429 Too Many Requests when the concurrent limit is exceeded. Authenticated sign-in replaces the least-recently-active session so a new login can displace an existing viewer instead of being blocked.

GET /argus-logs/api/license-limits

Local-only access

options.AddAuthorizationFilter(new LocalRequestsOnlyAuthorizationFilter());