BarakoCMS.Diagnostics
4.3.1
See the version list below for details.
dotnet add package BarakoCMS.Diagnostics --version 4.3.1
NuGet\Install-Package BarakoCMS.Diagnostics -Version 4.3.1
<PackageReference Include="BarakoCMS.Diagnostics" Version="4.3.1" />
<PackageVersion Include="BarakoCMS.Diagnostics" Version="4.3.1" />
<PackageReference Include="BarakoCMS.Diagnostics" />
paket add BarakoCMS.Diagnostics --version 4.3.1
#r "nuget: BarakoCMS.Diagnostics, 4.3.1"
#:package BarakoCMS.Diagnostics@4.3.1
#addin nuget:?package=BarakoCMS.Diagnostics&version=4.3.1
#tool nuget:?package=BarakoCMS.Diagnostics&version=4.3.1
<div align="center"> <img src="https://raw.githubusercontent.com/BaryoDev/barakoCMS/master/assets/icon.png" width="96" height="96" alt="BarakoCMS.Diagnostics logo" /> <h1>BarakoCMS.Diagnostics</h1> <p><em>Collect browser errors from your frontend so you can find them later.</em></p> </div>
Your app POSTs captured browser errors — message, stack, page, user — and this module deduplicates them by fingerprint with an occurrence count, so a bug hit 4,000 times is one row that says 4,000 rather than 4,000 rows.
Enable it
dotnet add package BarakoCMS.Diagnostics
builder.Services.AddBarakoCMS(builder.Configuration);
var app = builder.Build();
app.UseBarakoCMS();
The package reference plus a restart is the install. AddBarakoCMS finds every module in the
application's dependency context, and BarakoCMS:Modules:Enabled decides which of them run
(BarakoCMS__Modules__Enabled=Diagnostics). Unset, every referenced module runs and the API logs
one warning saying so. To name it by hand instead, put
modules.Add(new BarakoCMS.Diagnostics.DiagnosticsModule())
in the AddBarakoCMS callback; discovery skips a type the host already added. See MODULES.md in
the repository.
Endpoints
| Method & path | Purpose | Access |
|---|---|---|
POST /api/client-errors |
Report a batch of captured errors | Anonymous |
GET /api/client-errors |
Browse what has been reported for the current tenant (every tenant for a caller holding the role globally) | Admin / SuperAdmin |
POST /api/client-errors/{id}/resolve |
Mark a fingerprint resolved, with an optional reference (a ticket or pull request link or number, up to 500 characters) and note (up to 2,000); { "resolved": false } reopens it and clears both |
Admin / SuperAdmin |
An error is kept per tenant: the report's tenant, or the tenant the request resolved to when it
names none. The same fault in two tenants is two rows, and resolving another tenant's error answers
404 unless the caller holds the role globally. Tenants are stored lowercased.
Reporting is anonymous on purpose: the errors worth catching often happen before anyone signs in.
That makes it a spammable endpoint, so it runs under its own tighter telemetry rate-limit policy
rather than the global budget.
Sending errors
The barakoCMS admin ships a reporter you can copy. Two rules matter if you write your own: send with
plain fetch rather than an HTTP client that retries or refreshes tokens (a reporter that can fail
by reporting is a loop), and cap sends per page session so a render loop cannot flood the API.
Part of barakoCMS
This is an optional module for barakoCMS, an open-source
headless CMS for .NET 10. Every module is published under the barakocms-module tag, so a single
search on nuget.org returns the whole set.
Contributions are welcome — including a module icon or other design work. See CONTRIBUTING.md.
Licensed under MPL-2.0.
If barakoCMS is useful to you, a star on the repository helps other people find it.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- AspNetCore.HealthChecks.Npgsql (>= 9.0.0)
- AspNetCore.HealthChecks.System (>= 9.0.0)
- AspNetCore.HealthChecks.UI (>= 9.0.0)
- AspNetCore.HealthChecks.UI.Client (>= 9.0.0)
- AspNetCore.HealthChecks.UI.InMemory.Storage (>= 9.0.0)
- BarakoCMS (>= 4.5.0)
- BarakoCMS.Abstractions (>= 4.5.0)
- BCrypt.Net-Next (>= 4.2.0)
- FastEndpoints (>= 8.3.0)
- FastEndpoints.Security (>= 8.3.0)
- FastEndpoints.Swagger (>= 8.3.0)
- IdentityModel (>= 7.0.0)
- JasperFx (>= 2.75.2)
- KubernetesClient (>= 18.0.13)
- Marten (>= 9.40.0)
- Microsoft.Extensions.DependencyModel (>= 10.0.12)
- Microsoft.Extensions.Http.Resilience (>= 10.10.0)
- Microsoft.IdentityModel.JsonWebTokens (>= 8.23.0)
- Otp.NET (>= 1.4.1)
- prometheus-net.AspNetCore (>= 8.2.1)
- Serilog.AspNetCore (>= 10.0.0)
- Serilog.Sinks.Console (>= 6.1.1)
- Serilog.Sinks.File (>= 7.0.0)
- System.IdentityModel.Tokens.Jwt (>= 8.23.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 4.5.3 | 85 | 11/16/2026 |
| 4.5.2 | 68 | 11/6/2026 |
| 4.5.1 | 114 | 10/25/2026 |
| 4.5.0 | 99 | 10/23/2026 |
| 4.4.1 | 103 | 10/20/2026 |
| 4.4.0 | 105 | 10/14/2026 |
| 4.3.2 | 118 | 10/4/2026 |
| 4.3.1 | 123 | 9/29/2026 |
| 4.3.0 | 115 | 9/21/2026 |
| 4.1.1 | 110 | 9/18/2026 |
| 4.0.0 | 152 | 9/7/2026 |
| 0.2.0 | 141 | 8/20/2026 |
| 0.1.4 | 140 | 8/15/2026 |
| 0.1.3 | 206 | 8/5/2026 |
| 0.1.2 | 131 | 8/3/2026 |
| 0.1.1 | 142 | 7/21/2026 |
| 0.1.0 | 100 | 7/18/2026 |