Hellnet.Observability 1.3.4

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package Hellnet.Observability --version 1.3.4
                    


                    

                
NuGet\Install-Package Hellnet.Observability -Version 1.3.4
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="Hellnet.Observability" Version="1.3.4" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Hellnet.Observability" Version="1.3.4" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Hellnet.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 Hellnet.Observability --version 1.3.4
                    


                    

                
#r "nuget: Hellnet.Observability, 1.3.4"
#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 Hellnet.Observability@1.3.4
#: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=Hellnet.Observability&version=1.3.4
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Hellnet.Observability&version=1.3.4
                    


                            Install as a Cake Tool

Hellnet Observability

Library de observabilidade para microsserviços .NET 10, baseada em OpenTelemetry com structured logging (Serilog), distributed tracing e metrics — setup em 1 linha, native OTel API.

dotnet add package Hellnet.Observability

Quick start

export HELLNET_SERVICE_NAME=my-service
export HELLNET_OTLP_ENDPOINT=http://alloy.monitoring:4317
export HELLNET_OTLP_PROTOCOL=grpc

using Hellnet.Observability;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddHellnetTelemetry();

var app = builder.Build();
app.UseHellnetObservability();
app.UseHellnetHealthChecks();
app.Run();

Usage

All-in-one (recomendado)

builder.Services.AddHellnetTelemetry();

Registra logging, tracing, metrics, health checks e ITelemetry em 1 chamada.

Pipelines individuais

builder.Services.AddHellnetLogging();           // Serilog + OTLP
builder.Services.AddHellnetTracing(t => ...);   // OTel tracing
builder.Services.AddHellnetMetrics(m => ...);   // OTel metrics
builder.Services.AddHellnetHealthChecks();      // /live, /ready, /health

Injetar telemetry em qualquer lugar

public class OrderService(ITelemetry tel)
{
    public async Task Process(Order order)
    {
        using var span = tel.ActivitySource.StartActivity("process-order");
        span?.SetTag("order.id", order.Id);

        tel.Logger<OrderService>().LogInformation("Processing {Id}", order.Id);

        tel.Meter.CreateCounter<long>("orders.processed").Add(1);
        tel.Meter.CreateHistogram<double>("order.value").Record((double)order.Total);
    }
}

Health checks

// Endpoints (depois de UseHellnetHealthChecks):
//   GET /live    — liveness probe (self check)
//   GET /ready   — readiness probe (self + OTLP collector)
//   GET /health  — aggregate

// Adicionar custom checks:
builder.Services.AddHellnetHealthChecks(checks =>
    checks.AddCheck("db", new MyDbCheck(), tags: ["ready"]));

Custom tracing source

builder.Services.AddHellnetTracing(t =>
    t.AddSource("MyApp.CustomTraces"));

Custom meter

builder.Services.AddHellnetMetrics(m =>
    m.AddMeter("MyApp.CustomMetrics"));

Resiliência (Polly)

Health check do OTLP collector usa retry (2x) + timeout (3s).
Configurável via HellnetResilience:

HellnetResilience.RetryCount = 5;
HellnetResilience.TimeoutDuration = TimeSpan.FromSeconds(10);

Required env vars

Variable Exemplo Descrição
HELLNET_SERVICE_NAME order-api Service identifier
HELLNET_OTLP_ENDPOINT http://alloy.monitoring:4317 OTLP collector endpoint
HELLNET_OTLP_PROTOCOL grpc / http Transport protocol

Fail-fast: a aplicação não inicia sem essas três.

Variable Default Descrição
HELLNET_LOG_LEVEL Information Mínimo level de log
HELLNET_ENV_FILE — Caminho do .env em development

Instrumentação automática

Camada Package
HTTP (incoming) OpenTelemetry.Instrumentation.AspNetCore
HTTP (outgoing) OpenTelemetry.Instrumentation.Http
Database OpenTelemetry.Instrumentation.EntityFrameworkCore
SQL OpenTelemetry.Instrumentation.SqlClient
Runtime OpenTelemetry.Instrumentation.Runtime
Process OpenTelemetry.Instrumentation.Process

Inclusas por padrão no AddHellnetTelemetry().

Tech stack

Categoria Library
OTel OpenTelemetry SDK 1.16.0 + OTLP exporter
Logging Serilog 4.3.1 (compact JSON, async console)
Resilience Polly.Core 8.7.0
.NET 10.0, C# 14

Licença

Apache 2.0 © 2026 Hellnet

Product 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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.3.13 148 7/17/2026
1.3.12 120 7/17/2026
1.3.10 117 7/16/2026
1.3.9 125 7/16/2026
1.3.4 124 7/9/2026
1.3.2-beta.39 77 7/9/2026
1.3.2-beta.38 72 7/9/2026
1.3.2-beta.37 74 7/9/2026
1.3.2-beta.36 71 7/9/2026
1.3.2-beta.35 73 7/9/2026
1.3.2-beta.34 75 7/9/2026
1.3.2-beta.33 70 7/9/2026
1.3.2-beta.32 69 7/9/2026
1.3.2-beta.31 71 7/9/2026
1.3.2-beta.30 71 7/9/2026
1.3.2-beta.29 85 7/9/2026
1.3.2-beta.28 70 7/9/2026
1.3.2-beta.27 74 7/9/2026
1.3.2-beta.26 75 7/9/2026
1.3.2-beta.25 85 7/9/2026
Loading failed