FGutierrez.Core.Observability 1.1.3

.NET 8.0

dotnet add package FGutierrez.Core.Observability --version 1.1.3

NuGet\Install-Package FGutierrez.Core.Observability -Version 1.1.3

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="FGutierrez.Core.Observability" Version="1.1.3" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="FGutierrez.Core.Observability" Version="1.1.3" />
                    

                            Directory.Packages.props

<PackageReference Include="FGutierrez.Core.Observability" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add FGutierrez.Core.Observability --version 1.1.3

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: FGutierrez.Core.Observability, 1.1.3"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#:package FGutierrez.Core.Observability@1.1.3

#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.

#addin nuget:?package=FGutierrez.Core.Observability&version=1.1.3
                    

                            Install as a Cake Addin

#tool nuget:?package=FGutierrez.Core.Observability&version=1.1.3
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

📊 FGutierrez.Core.Observability

🚀 Overview

FGutierrez.Core.Observability is a high-performance .NET observability library designed to standardize telemetry across distributed systems using OpenTelemetry.

The package provides a unified and production-ready integration layer for:

Distributed tracing
Metrics collection
Structured logging
Health monitoring
Cross-signal correlation

with minimal setup and cloud-native compatibility.

🎯 Why This Library?

Configuring OpenTelemetry manually across multiple services often introduces:

repetitive boilerplate
inconsistent telemetry standards
fragmented diagnostics
missing trace correlation

This library solves those issues by providing a centralized observability foundation for .NET microservices.

✨ Features

🔭 OpenTelemetry Native

Built on stable OpenTelemetry SDKs with OTLP-first architecture.

📈 Metrics Collection

Automatic instrumentation for:

ASP.NET Core
Runtime metrics
HTTP clients
Custom application meters

🧾 Distributed Tracing

Captures and exports traces with:

TraceId propagation
Span correlation
OTLP exporter support

🪵 Structured Logging

Integrated Serilog pipeline with:

TraceId enrichment
SpanId enrichment
JSON structured logs

🩺 Health Monitoring

Built-in endpoints:

/health
/ready

with standardized responses.

🧠 Self-Context Awareness

Automatically detects:

Service name
Environment
Service version

🗄️ SQL Observability

Captures SQL activity for performance analysis.

Configurable to avoid sensitive data exposure.

🔗 Ecosystem Integration

Native integration with:

FGutierrez.Core.Idempotency

Metrics and traces are automatically correlated without additional configuration.

🛡️ Resilience-First Startup

The library validates configuration and OTLP connectivity safely during startup.

If exporters or collectors are unavailable:

the application continues running
telemetry degrades gracefully
no startup crashes occur

📦 Installation

dotnet add package FGutierrez.Core.Observability

⚙️ Configuration

appsettings.json

{
  "OpenTelemetry": {
    "Tracing": {
      "Enabled": true,
      "OtlpEndpoint": "http://localhost:4317"
    },
    "Metrics": {
      "Enabled": true,
      "OtlpEndpoint": "http://localhost:4317",
      "Meters": [
        "FGutierrez.Core.Idempotency"
      ]
    },
    "Logging": {
      "Enabled": true,
      "OtlpEndpoint": "http://localhost:4317"
    }
  }
}

🧑‍💻 Quick Start

var builder = WebApplication.CreateBuilder(args);

builder.AddObservability(
    environment: builder.Environment.EnvironmentName,
    serviceName: "OrderService",
    serviceNamespace: "Company.Core"
);

var app = builder.Build();

app.UseObservabilityEndpoints();

app.Run();

🏗️ Included Components

Extensions/
├── HealthCheckEndpointsExtensions.cs
├── HealthCheckExtensions.cs
├── OpenTelemetryMetricsExtensions.cs
├── OpenTelemetryTracingExtensions.cs
└── SerilogExtensions.cs

🏗️ Architecture

Observability Flow

📊 Supported Signals

Signal	Support
Traces	✅
Metrics	✅
Logs	✅
Health Checks	✅
Correlation IDs	✅

🛠️ Requirements

Component	Version
.NET SDK	8.0+
OpenTelemetry Collector	Recommended
OTLP gRPC Endpoint	Port 4317

🚀 Recommended Stack

This library works especially well with:

OpenTelemetry Collector
Grafana
Prometheus
Jaeger
Loki
Docker Compose
Kubernetes

🧪 Engineering Principles

FGutierrez.Core.Observability follows:

Observability-First architecture
Cloud-native engineering
Middleware-first integrations
Production-grade defaults
Minimal boilerplate
Vendor-neutral telemetry

🤝 Contributing

Contributions and improvements are welcome.

Development Flow

Fork the repository
Create a feature branch
Commit changes
Submit a Pull Request

📄 License

⭐ Support

If this project helps you, consider giving it a star on GitHub.

Product	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.

Product

.NET

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net8.0
- Microsoft.Data.SqlClient (>= 5.2.2)
- Microsoft.Extensions.Configuration.Abstractions (>= 8.0.0)
- Microsoft.Extensions.Configuration.Binder (>= 8.0.2)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.2)
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.2)
- Microsoft.Extensions.Options (>= 8.0.2)
- 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 (>= 8.0.3)
- Serilog.Enrichers.Thread (>= 4.0.0)
- Serilog.Sinks.OpenTelemetry (>= 4.1.1)

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