FactFoundry.TelemetryForge.Web 1.1.0

FactFoundry.TelemetryForge.Web

ASP.NET and Blazor Server telemetry for TelemetryForge — privacy-first, server-side request tracking with no JavaScript.

Installation

dotnet add package FactFoundry.TelemetryForge.Web

Setup

builder.Services.AddTelemetryForge(options =>
{
    options.Endpoint   = "https://telemetry.yourdomain.com";
    options.ApiKey     = "your-site-api-key";
    options.UseGaCookie = false;            // default: false — include _ga cookie for cross-session identity
    options.GeoProvider = GeoProvider.Auto; // default: Auto — or Cloudflare, CloudFront, Vercel, Akamai, None
});

app.UseTelemetryForge(); // register middleware in the request pipeline

How It Works

• ASP.NET requests — the middleware sends a page_view event per HTTP request, capturing page path, status code, duration, referrer, User-Agent, and language
• Blazor Server — the circuit handler sends a page_view event on each navigation and a circuit_close event when the circuit disconnects

Both components are registered automatically by AddTelemetryForge().

Custom Events (Blazor)

Inject ITelemetryForge to send custom events from anywhere in a Blazor circuit:

@inject ITelemetryForge Telemetry

<button @onclick="OnSubmit">Submit</button>

@code {
    private void OnSubmit()
    {
        Telemetry.TrackEvent("form_submit", new Dictionary<string, object>
        {
            ["form"] = "contact"
        });
    }
}

Blazor Navigation Tracking

Call TrackNavigation from a NavigationManager.LocationChanged handler to track page views within a Blazor circuit:

@inject TelemetryForgeCircuitHandler CircuitHandler
@inject NavigationManager Navigation
@implements IDisposable

@code {
    protected override void OnInitialized()
    {
        Navigation.LocationChanged += OnLocationChanged;
    }

    private void OnLocationChanged(object? sender, LocationChangedEventArgs e)
    {
        CircuitHandler.TrackNavigation(new Uri(e.Location).AbsolutePath);
    }

    public void Dispose() => Navigation.LocationChanged -= OnLocationChanged;
}

What Gets Sent

Each event is a lightweight JSON payload posted to POST /api/telemetry/web:

Privacy

• No cookies set by the library
• No JavaScript emitted
• Raw IPs are hashed server-side — only the hash with rotating salt is stored, which cannot identify individual users across multiple sessions

Requirements

• .NET 8, 9, or 10
• A running TelemetryForge Server instance

License

MIT