Mitf.Observability 1.0.0

Mitf.Observability

MITF ASP.NET Core observability bootstrap for .NET 10 apps:

• Consul optional config source (KV bootstrap + reload)
• Serilog sinks: Console, Loki, PostgreSQL, Elasticsearch, SQL Server
• OpenTelemetry traces, metrics, logs, Prometheus /metrics scraping

Everything is disabled by default and turned on via configuration.

Install

dotnet add package Mitf.Observability

Wire-up

using Observability.Hosting;
using Observability.Logger;
using Observability.Telemetry;

var builder = WebApplication.CreateBuilder(args);

builder.AddObservabilityBootstrap();

var app = builder.Build();

app.UseObservability();

if (builder.Configuration.GetValue("InternalLoggerOptions:Enabled", false))
{
 app.UseMiddleware<ApiLoggingMiddleware>();
}

Configuration (appsettings.json)

{
 "ConfigSource": {
 "Type": "appsettings",
 "ApplicationName": "my-service"
 },
 "InternalLoggerOptions": {
 "Enabled": false,
 "LogType": "Console",
 "ConnectionString": "",
 "TableName": "Logs_"
 },
 "Observability": {
 "Enabled": false,
 "ServiceName": "MyService.Api",
 "CollectorUrl": "http://otel-collector:4317",
 "EnableTracing": false,
 "EnableMetrics": false,
 "EnableLogging": false,
 "PrometheusEndpoint": "/metrics"
 }
}

When Observability:Enabled=true and all three sub-flags are false, tracing, metrics, and logging are auto-enabled.

Serilog LogType values

Docker observability stack

Pair with Consul, Loki, Tempo, Prometheus, Grafana, and OTEL Collector. See the insurance-provider-hub docker-compose.yml observability profile and infra/ configs as the reference template.

Publishing

Maintainers: run scripts/publish-mitf-observability.ps1 with a NuGet API key. See docs/hub/PUBLISH-MITF-OBSERVABILITY.md in the source repository.