Application Real-Time Monitoring Service:Laporkan data aplikasi .NET melalui Zipkin

Dapatkan titik akhir Zipkin

1. Masuk ke Konsol Tracing Analysis.

2. Di panel navigasi sebelah kiri, klik Cluster Configurations. Lalu, klik tab Access point information.

3. Di bilah navigasi atas, pilih wilayah. Di bagian Cluster Information, aktifkan Show Token.

4. Di bagian Client, klik Jaeger atau Zipkin.

5. Di kolom Related Information, salin URL titik akhirnya.

Langkah 1: Instal paket NuGet

dotnet add package zipkin4net.middleware.aspnetcore
dotnet add package zipkin4net

Langkah 2: Daftarkan dan mulai tracer

Tambahkan kode berikut ke logika startup aplikasi Anda untuk mengonfigurasi zipkin4net dan menghubungkannya ke titik akhir ARMS Tracing Analysis Anda.

lifetime.ApplicationStarted.Register(() => {
    TraceManager.SamplingRate = 1.0f;
    var logger = new TracingLogger(loggerFactory, "zipkin4net");

    // Ganti dengan titik akhir Zipkin Anda dari Konsol Tracing Analysis.
    // Jangan tambahkan /api/v2/spans ke URL.
    var httpSender = new HttpZipkinSender("<your-zipkin-endpoint>", "application/json");

    var tracer = new ZipkinTracer(httpSender, new JSONSpanSerializer());
    TraceManager.RegisterTracer(tracer);
    TraceManager.Start(logger);
});
lifetime.ApplicationStopped.Register(() => TraceManager.Stop());
app.UseTracing(applicationName);

Ganti placeholder berikut dengan nilai aktual Anda:

Langkah 3: Lacak permintaan HTTP keluar

Tambahkan TracingHandler ke pipeline HttpClient Anda agar panggilan HTTP keluar secara otomatis dilacak dan dikorelasikan dengan rentang induk.

public override void ConfigureServices(IServiceCollection services)
{
    services.AddHttpClient("Tracer").AddHttpMessageHandler(provider =>
        TracingHandler.WithoutInnerHandler(provider.GetService<IConfiguration>()["applicationName"]));
}

Langkah 1: Instal paket NuGet

dotnet add package zipkin4net.middleware.aspnetcore
dotnet add package zipkin4net

Langkah 2: Daftarkan dan mulai tracer

// Konfigurasikan pelacakan.
TraceManager.SamplingRate = 1.0f;
var logger = new ConsoleLogger();

// Ganti dengan titik akhir Zipkin Anda dari Konsol Tracing Analysis.
// Jangan tambahkan /api/v2/spans ke URL.
var httpSender = new HttpZipkinSender("<your-zipkin-endpoint>", "application/json");

var tracer = new ZipkinTracer(httpSender, new JSONSpanSerializer());
TraceManager.RegisterTracer(tracer);
TraceManager.Start(logger);

// Hentikan TraceManager saat aplikasi dimatikan.
var properties = new AppProperties(appBuilder.Properties);
var token = properties.OnAppDisposing;

if (token != CancellationToken.None)
{
    token.Register(() =>
    {
        TraceManager.Stop();
    });
}

// Daftarkan middleware OWIN.
appBuilder.UseZipkinTracer(System.Configuration.ConfigurationManager.AppSettings["applicationName"]);

Langkah 3: Lacak permintaan HTTP keluar

Bungkus HttpClient Anda dengan TracingHandler untuk menyebarkan konteks jejak melintasi batas layanan.

using (var httpClient = new HttpClient(new TracingHandler(applicationName)))
{
    var response = await httpClient.GetAsync(callServiceUrl);
    var content = await response.Content.ReadAsStringAsync();

    await context.Response.WriteAsync(content);
}

Langkah 1: Instal paket NuGet

Hanya pustaka pelacakan inti yang diperlukan untuk instrumentasi manual.

dotnet add package zipkin4net

Langkah 2: Daftarkan dan mulai tracer

TraceManager.SamplingRate = 1.0f;
var logger = new ConsoleLogger();

// Ganti dengan titik akhir Zipkin Anda dari Konsol Tracing Analysis.
// Jangan tambahkan /api/v2/spans ke URL.
var httpSender = new HttpZipkinSender("<your-zipkin-endpoint>", "application/json");

var tracer = new ZipkinTracer(httpSender, new JSONSpanSerializer());
TraceManager.RegisterTracer(tracer);
TraceManager.Start(logger);

Langkah 3: Buat dan catat rentang

Buat rentang akar untuk setiap permintaan atau operasi, lalu catat event siklus hidupnya.

var trace = Trace.Create();

Trace.Current = trace;
trace.Record(Annotations.ClientSend());

trace.Record(Annotations.Rpc("client"));
trace.Record(Annotations.Tag("mytag", "spanFrist"));
trace.Record(Annotations.ServiceName("dotnetManual"));
// ... lakukan operasi Anda di sini
testCall();

trace.Record(Annotations.ClientRecv());

Untuk mencatat rentang anak (misalnya, panggilan downstream dalam permintaan yang sama), panggil Child() pada jejak saat ini:

var trace = Trace.Current.Child();
Trace.Current = trace;
trace.Record(Annotations.ServerRecv());
trace.Record(Annotations.Rpc("server"));
trace.Record(Annotations.Tag("mytag", "spanSecond"));
trace.Record(Annotations.ServiceName("dotnetManual"));
// ... lakukan operasi Anda di sini
trace.Record(Annotations.ServerSend());

(Opsional) Langkah 4: Tambahkan tag kustom

Lampirkan tag kustom ke rentang untuk mempermudah troubleshooting. Misalnya, catat kode status HTTP atau tandai error.

tracer.activeSpan().setTag("http.status_code", "200");

Langkah 5: Sebarkan konteks jejak antar layanan

Dalam sistem terdistribusi, konteks jejak ikut serta dalam setiap permintaan RPC sehingga rentang dari layanan berbeda dapat dikorelasikan menjadi satu jejak tunggal. Pustaka zipkin4net menggunakan propagasi B3, yang meneruskan empat nilai melalui header HTTP:

Rentang Klien                                                Rentang Server
┌──────────────────┐                                       ┌──────────────────┐
│                  │                                       │                  │
│   KonteksJejak   │           Header Permintaan HTTP      │   KonteksJejak   │
│ ┌──────────────┐ │          ┌───────────────────┐        │ ┌──────────────┐ │
│ │ TraceId      │ │          │ X-B3-TraceId      │        │ │ TraceId      │ │
│ │              │ │          │                   │        │ │              │ │
│ │ ParentSpanId │ │ Inject   │ X-B3-ParentSpanId │Extract │ │ ParentSpanId │ │
│ │              ├─┼─────────>│                   ├────────┼>│              │ │
│ │ SpanId       │ │          │ X-B3-SpanId       │        │ │ SpanId       │ │
│ │              │ │          │                   │        │ │              │ │
│ │ Sampled      │ │          │ X-B3-Sampled      │        │ │ Sampled      │ │
│ └──────────────┘ │          └───────────────────┘        │ └──────────────┘ │
│                  │                                       │                  │
└──────────────────┘                                       └──────────────────┘

Sisi klien — injeksikan konteks jejak ke header permintaan keluar:

_injector.Inject(clientTrace.Trace.CurrentSpan, request.Headers);

Sisi server — ekstrak konteks jejak dari header permintaan masuk:

var traceContext = traceExtractor.Extract(context.Request.Headers);
var trace = traceContext == null ? Trace.Create() : Trace.CreateFromId(traceContext);

Jika tidak ada konteks jejak dalam header masuk, jejak akar baru akan dibuat. Jika ada, jejak yang sudah ada akan dilanjutkan.