👁 Image
StackSpot.Tracing 1.0.1

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/