RepletoryLib.Tracing 1.0.0

RepletoryLib.Tracing

OpenTelemetry distributed tracing with Jaeger and OTLP exporter support.

Part of the RepletoryLib ecosystem -- standalone, reusable .NET 10 libraries with zero business logic.

Overview

RepletoryLib.Tracing provides distributed tracing using OpenTelemetry with automatic instrumentation for ASP.NET Core and HTTP client requests. Traces can be exported to Jaeger, OTLP-compatible collectors, or the console.

Key Features

• OpenTelemetry integration -- Industry-standard distributed tracing
• Auto-instrumentation -- ASP.NET Core and HttpClient traces captured automatically
• Multiple exporters -- Console, Jaeger, and OTLP (Jaeger, Grafana Tempo, etc.)
• ITracingService -- Start custom activities, add tags, and record exceptions
• Configurable sampling -- Control trace sampling ratio

Installation

dotnet add package RepletoryLib.Tracing

Dependencies

Prerequisites

• Jaeger or OTLP-compatible collector for viewing traces

docker-compose up -d jaeger
# Jaeger UI: http://localhost:16686

Quick Start

using RepletoryLib.Tracing;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddRepletoryTracing(builder.Configuration);

{
  "Tracing": {
    "ServiceName": "MyApp",
    "ServiceVersion": "1.0.0",
    "Exporter": "OTLP",
    "OtlpEndpoint": "http://localhost:4317",
    "SamplingRatio": 1.0
  }
}

Configuration

TracingOptions

Usage Examples

Custom Tracing

using RepletoryLib.Tracing.Interfaces;

public class OrderService
{
    private readonly ITracingService _tracing;

    public OrderService(ITracingService tracing) => _tracing = tracing;

    public async Task ProcessOrderAsync(Order order)
    {
        using var activity = _tracing.StartActivity("ProcessOrder");
        _tracing.AddTag("order.id", order.Id.ToString());
        _tracing.AddTag("order.total", order.Total.ToString());

        try
        {
            await ValidateOrderAsync(order);
            await ChargePaymentAsync(order);
            await SendConfirmationAsync(order);
        }
        catch (Exception ex)
        {
            _tracing.RecordException(ex);
            throw;
        }
    }
}

Integration with Other RepletoryLib Packages

License

This project is licensed under the MIT License.

Copyright (c) 2024-2026 Repletory.

For complete documentation, infrastructure setup, and configuration reference, see the RepletoryLib main repository.