JonjubNet.Observability 1.0.7

JonjubNet.Observability

Biblioteca de observabilidad para aplicaciones .NET con soporte para Logging estructurado, Métricas y Tracing distribuido.

Resumen

Tres pilares de observabilidad

Logging estructurado — 6 sinks (soporte multi-sink)

Métricas — 7 sinks (soporte multi-sink)

Tracing distribuido — 4 exporters (soporte multi-exporter)

Características principales

Instalación

# Paquete completo (recomendado)
Install-Package JonjubNet.Observability -Version 1.0.7

# Solo Logging
Install-Package JonjubNet.Observability.Logging.Core -Version 1.0.7

# Solo Metrics
Install-Package JonjubNet.Observability.Metrics.Core -Version 1.0.7

# Solo Tracing
Install-Package JonjubNet.Observability.Tracing.Core -Version 1.0.7

Uso rápido

1. Registrar servicios

using JonjubNet.Observability.Hosting;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddJonjubNetLogging(builder.Configuration);
builder.Services.AddJonjubNetMetrics(builder.Configuration);
builder.Services.AddJonjubNetTracing(builder.Configuration);

2. Usar en código

public class OrderService
{
    private readonly ILoggingClient _logging;
    private readonly IMetricsClient _metrics;
    private readonly ITracingClient _tracing;

    public OrderService(
        ILoggingClient logging,
        IMetricsClient metrics,
        ITracingClient tracing)
    {
        _logging = logging;
        _metrics = metrics;
        _tracing = tracing;
    }

    public async Task<Order> CreateOrderAsync(OrderRequest request)
    {
        using var span = _tracing.StartSpan("create_order", SpanKind.Server);
        
        try
        {
            _metrics.Increment("orders_created_total", value: 1.0, tags: new() { ["status"] = "processing" });
            _logging.LogInformation("Creating order", category: "Orders", properties: new() { ["customerId"] = request.CustomerId });

            var order = await ProcessOrderAsync(request);

            span.Status = SpanStatus.Ok;
            return order;
        }
        catch (Exception ex)
        {
            _logging.LogError("Failed to create order", exception: ex, category: "Orders");
            span.Status = SpanStatus.Error;
            span.RecordException(ex);
            throw;
        }
    }
}

3. Configuración (múltiples sinks)

{
  "JonjubNet": {
    "Logging": {
      "Enabled": true,
      "Sinks": [
        { "Type": "Console", "Enabled": true, "Order": 1 },
        { "Type": "Elasticsearch", "Enabled": true, "Order": 2 }
      ]
    },
    "Metrics": {
      "Enabled": true,
      "Sinks": [
        { "Type": "Prometheus", "Enabled": true, "Order": 1 },
        { "Type": "InfluxDB", "Enabled": true, "Order": 2 }
      ]
    },
    "Tracing": {
      "Enabled": true,
      "Exporters": [
        { "Type": "OpenTelemetry", "Enabled": true, "Order": 1 },
        { "Type": "Kafka", "Enabled": true, "Order": 2 }
      ]
    }
  }
}

Legacy: Si Sinks está vacío, usa el campo único Sink (enum) para backward compatibility.

Arquitectura

Logging/           Core → interfaces, LoggingClient, LogRegistry
  Core/            Infrastructure → sinks (Console, Kafka, ES, OTel, HTTP)
  Infrastructure/
Metrics/           Core → interfaces, MetricsClient, MetricRegistry
  Core/            Infrastructure → sinks (Prometheus, InfluxDB, StatsD, Kafka, OTel, ES, HTTP)
  Infrastructure/
Tracing/           Core → interfaces, TracingClient, TraceRegistry
  Core/            Infrastructure → exporters (OTel, Kafka, ES, HTTP)
  Infrastructure/
Shared/            Context, Kafka, OpenTelemetry, Security, Utils
Presentation/      Hosting, middleware, NuGet package

Ver Arquitectura completa.

Documentación

• Mapa de documentación ← Empezar aquí
• Arquitectura
• ADRs - Decisiones de arquitectura
• Guías de desarrollo
• Operaciones y configuración
• Diagramas

Estado de implementación

Ver Estado de implementación para detalles.