StackSpot.Tracing 1.0.0

StackSpot Tracing

Este componente foi projetado para apoiar os desenvolvedores a configurar e utilizar o Opentelemetry com exporter para Jaeger e Instrumentação AWS X-Ray.

Versões suportadas

• net5.0
• net6.0

Uso

1. Adicione o pacote NuGet StackSpot.Tracing ao seu projeto.

dotnet add package StackSpot.Tracing

2. Configure as variáveis.

• AppName - Nome da Aplicação - Campo Obrigatório.
• ExporterType - Tipo de Exportação (Jaeger, x-ray ou otlp).
• Host - Hostname do agent - comunicação via UDP.
• Port - Porta do agent - comunicação via UDP.
• ConsoleExporter - Exportar para o console.
• UseGrpcClientInstrumentation - Habilitar instrumentação gRPC.
• UseHttpClientInstrumentation - Habilitar instrumentação http.
• Tags - Headers que serão propagados.

Você pode configurar as variáveis no arquivo appsettings.json.

{
  "AppName": "MyAppName",  
  "Telemetry": {
    "ExporterType": "Jaeger",
    "Host": "127.0.0.1",
    "Port": 6831,
    "ConsoleExporter": true,
    "UseHttpClientInstrumentation": true,
    "UseGrpcClientInstrumentation": true,
    "Tags": [
            "X-B3-TraceId",
            "X-B3-ParentSpanId",
            "X-B3-SpanId"
     ]    
  }
}

3. Adicione ao seu IServiceCollection via services.AddOpenTelemetryTracing() no Startup da aplicação ou Program.

        public void ConfigureServices(IServiceCollection services)
        {
            services.AddOpenTelemetryTracing(Configuration);
        }

4. Ambiente local

Esta etapa não é obrigatória. Execute o comando abaixo para disponibilizar container jaegertracing:

docker run -d -p6831:6831/udp -p16686:16686 jaegertracing/all-in-one:latest

Para visualizar os traces acesse: http://localhost:16686/