ANcpSdk.AspNetCore.ServiceDefaults
1.3.26
merged into my qyl. opentelemtry as generator
dotnet add package ANcpSdk.AspNetCore.ServiceDefaults --version 1.3.26
NuGet\Install-Package ANcpSdk.AspNetCore.ServiceDefaults -Version 1.3.26
<PackageReference Include="ANcpSdk.AspNetCore.ServiceDefaults" Version="1.3.26" />
<PackageVersion Include="ANcpSdk.AspNetCore.ServiceDefaults" Version="1.3.26" />
<PackageReference Include="ANcpSdk.AspNetCore.ServiceDefaults" />
paket add ANcpSdk.AspNetCore.ServiceDefaults --version 1.3.26
#r "nuget: ANcpSdk.AspNetCore.ServiceDefaults, 1.3.26"
#:package ANcpSdk.AspNetCore.ServiceDefaults@1.3.26
#addin nuget:?package=ANcpSdk.AspNetCore.ServiceDefaults&version=1.3.26
#tool nuget:?package=ANcpSdk.AspNetCore.ServiceDefaults&version=1.3.26
ANcpSdk.AspNetCore.ServiceDefaults
Opinionated service defaults for ASP.NET Core applications, inspired by .NET Aspire.
Features
- OpenTelemetry: Logging, metrics (ASP.NET Core, HTTP, Runtime), tracing with OTLP export
- Health Checks:
/health(readiness) and/alive(liveness) endpoints - Service Discovery: Microsoft.Extensions.ServiceDiscovery enabled
- HTTP Resilience: Standard resilience handlers with retries and circuit breakers
- JSON Configuration: CamelCase naming, enum converters, nullable annotations
- Security: Forwarded headers, HTTPS redirect, HSTS, antiforgery
- OpenAPI: Optional OpenAPI document generation
- DevLogs: Frontend console log bridge for unified debugging (Development only)
Usage
var builder = WebApplication.CreateBuilder(args);
builder.UseANcpSdkConventions();
var app = builder.Build();
app.MapANcpSdkDefaultEndpoints();
app.Run();
Configuration
builder.UseANcpSdkConventions(options =>
{
options.Https.Enabled = true;
options.OpenApi.Enabled = true;
options.AntiForgery.Enabled = false;
options.DevLogs.Enabled = true; // Default: true in Development
options.OpenTelemetry.ConfigureTracing = tracing => tracing.AddSource("MyApp");
});
DevLogs - Frontend Console Bridge
Captures browser console.log/warn/error and sends to server logs. Enabled by default in Development.
Add to your HTML (only served in Development):
<script src="/dev-logs.js"></script>
All frontend logs appear in server output with [BROWSER] prefix:
info: DevLogEntry[0] [BROWSER] User clicked button
warn: DevLogEntry[0] [BROWSER] Deprecated API called
error: DevLogEntry[0] [BROWSER] Failed to fetch data
Configuration:
options.DevLogs.Enabled = true; // Default: true
options.DevLogs.RoutePattern = "/api/dev-logs"; // Default
options.DevLogs.EnableInProduction = false; // Default: false
Auto-Registration
When used with ANcpLua.NET.Sdk.Web, service defaults are auto-registered via source generation.
Opt-out: <AutoRegisterServiceDefaults>false</AutoRegisterServiceDefaults>
License
MIT
| 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
- Microsoft.AspNetCore.Diagnostics.Middleware (>= 10.1.0)
- Microsoft.AspNetCore.OpenApi (>= 10.0.1)
- Microsoft.Extensions.Compliance.Redaction (>= 10.1.0)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.1)
- Microsoft.Extensions.Http.Resilience (>= 10.1.0)
- Microsoft.Extensions.Logging (>= 10.0.1)
- Microsoft.Extensions.ServiceDiscovery (>= 10.1.0)
- Microsoft.Extensions.Telemetry (>= 10.1.0)
- Microsoft.Extensions.Telemetry.Abstractions (>= 10.1.0)
- OpenTelemetry.Exporter.Console (>= 1.14.0)
- OpenTelemetry.Exporter.OpenTelemetryProtocol (>= 1.14.0)
- OpenTelemetry.Extensions.Hosting (>= 1.14.0)
- OpenTelemetry.Instrumentation.AspNetCore (>= 1.14.0)
- OpenTelemetry.Instrumentation.Http (>= 1.14.0)
- OpenTelemetry.Instrumentation.Runtime (>= 1.14.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 |
|---|