FGutierrez.Core.Observability
1.1.1
See the version list below for details.
dotnet add package FGutierrez.Core.Observability --version 1.1.1
NuGet\Install-Package FGutierrez.Core.Observability -Version 1.1.1
<PackageReference Include="FGutierrez.Core.Observability" Version="1.1.1" />
<PackageVersion Include="FGutierrez.Core.Observability" Version="1.1.1" />
<PackageReference Include="FGutierrez.Core.Observability" />
paket add FGutierrez.Core.Observability --version 1.1.1
#r "nuget: FGutierrez.Core.Observability, 1.1.1"
#:package FGutierrez.Core.Observability@1.1.1
#addin nuget:?package=FGutierrez.Core.Observability&version=1.1.1
#tool nuget:?package=FGutierrez.Core.Observability&version=1.1.1
FGutierrez.Core.Observability
🚀 Overview
FGutierrez.Core.Observability is a high-performance, enterprise-grade .NET observability library designed to standardize telemetry across microservices using OpenTelemetry (OTLP).
It enables metrics, distributed tracing, and structured logging with a single-line integration and full cross-signal correlation.
🎯 Why This Library?
Using raw OpenTelemetry often results in repetitive boilerplate, inconsistent telemetry, and poor correlation.
This library provides:
- A single unified entry point
- Standardized observability practices
- Automatic Trace ↔ Logs ↔ Metrics correlation
✨ Features
OTLP-First Architecture
Built on stable OpenTelemetry Protocol (v1.15.1) with no experimental dependencies.
Backend-Agnostic Metrics
Push-based OTLP exporter compatible with Grafana, Jaeger, Prometheus, and InfluxDB.
SQL Deep Insights
Captures SQL queries for performance analysis (configurable to avoid sensitive data).
Correlated Structured Logging
Serilog integration with TraceId and SpanId enrichment.
Self-Context Awareness
Auto-detects service name, version, and environment.
Health Checks
/health and /ready endpoints with structured output.
📦 Installation
dotnet add package FGutierrez.Core.Observability
🧑💻 Usage
var builder = WebApplication.CreateBuilder(args);
builder.AddObservability(
environment: builder.Environment.EnvironmentName,
serviceName: "OrderService",
serviceNamespace: "Company.Core"
);
var app = builder.Build();
app.UseObservabilityEndpoints();
app.Run();
🏗️ Architecture
App → OTLP → OpenTelemetry Collector → Backend (Grafana, Jaeger, etc.)
🛠️ Requirements
Requires an OpenTelemetry Collector listening on OTLP gRPC port 4317.
🤝 Contributing
Fork, create branch, and submit PR.
📄 License
MIT License
⭐ Support
Star the repo and share!
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. 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. |
-
net8.0
- Microsoft.Data.SqlClient (>= 7.0.1)
- OpenTelemetry.Exporter.OpenTelemetryProtocol (>= 1.15.3)
- OpenTelemetry.Extensions.Hosting (>= 1.15.3)
- OpenTelemetry.Instrumentation.AspNetCore (>= 1.15.2)
- OpenTelemetry.Instrumentation.Http (>= 1.15.1)
- OpenTelemetry.Instrumentation.Runtime (>= 1.15.1)
- OpenTelemetry.Instrumentation.SqlClient (>= 1.15.2)
- Serilog.AspNetCore (>= 10.0.0)
- Serilog.Enrichers.Thread (>= 4.0.0)
- Serilog.Sinks.OpenTelemetry (>= 4.2.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 |
|---|---|---|
| 1.1.3 | 169 | 5/26/2026 |
| 1.1.2 | 129 | 5/25/2026 |
| 1.1.1 | 141 | 5/14/2026 |
| 1.1.0 | 154 | 4/12/2026 |
| 1.0.1-beta.1 | 65 | 4/11/2026 |