OpenTelemetry 介紹

我在之前的幾篇文章都介紹了 OpenTelemetry, 你可以在這里找到

??OpenTelemetry - 云原生下可觀測(cè)性的新標(biāo)準(zhǔn)

? 深入研究.NET 5的開放式遙測(cè)

OpenTelemetry是谷歌和微軟共同推進(jìn)的云原生監(jiān)控的新規(guī)范， 兼容OpenTracing和OpenCensus

OpenTelemetry的終極目標(biāo)是：實(shí)現(xiàn)Metrics、Tracing、Logging的融合及大一統(tǒng)，作為APM的數(shù)據(jù)采集終極解決方案。

因?yàn)楝F(xiàn)在正式版本還沒有發(fā)布，我們現(xiàn)在只能使用rc版本，所以在Nuget開啟 包括預(yù)發(fā)行版,你可以在這里看到里程碑，https://github.com/open-telemetry/opentelemetry-dotnet/milestones

在webapi中接入OpenTelemetry服務(wù)

創(chuàng)建一個(gè)webapi項(xiàng)目，.NET 版本選5.0, 創(chuàng)建完成后，需要安裝下邊幾個(gè)包，選最新版本就好?

OpenTelemetry.Extensions.Hosting?提供服務(wù)擴(kuò)展?

OpenTelemetry.Instrumentation.AspNetCore?采集AspNetCore診斷數(shù)據(jù)?

OpenTelemetry.Instrumentation.Http?采集Http診斷數(shù)據(jù)?

安裝完成后，修改Startup.cs的 ConfigureServices() 方法

public void ConfigureServices(IServiceCollection services){ services.AddOpenTelemetryTracing((builder) => builder.AddAspNetCoreInstrumentation().AddHttpClientInstrumentation()); ....}

接下來(lái)，修改 WeatherForecastController, 來(lái)模擬簡(jiǎn)單的接口調(diào)用

[HttpGet]public async Task<IActionResult> Get(){HttpClient client = new HttpClient();await Task.Delay(new Random().Next(1000, 3000));_ = await client.GetStringAsync("http://www.baidu.com");await Task.Delay(new Random().Next(1000, 3000));_ = await client.GetStringAsync("http://www.baidu.com"); return Ok();}

上面的工作完成以后，我們還需要一個(gè)導(dǎo)出 Exporter 的組件，把數(shù)據(jù)導(dǎo)出到外部平臺(tái)，比如Jaeger, Zipkin, Prometheus 等，然后這些平臺(tái)會(huì)處理數(shù)據(jù)，然后展示出來(lái)。

ConsoleExporter

ConsoleExporter 是最簡(jiǎn)單的導(dǎo)出數(shù)據(jù)的實(shí)現(xiàn)，它會(huì)把診斷數(shù)據(jù)輸出到控制臺(tái)

安裝包?OpenTelemetry.Exporter.Console，然后修改 ConfigureServices 如下：

services.AddOpenTelemetryTracing((builder) => builder.AddAspNetCoreInstrumentation().AddHttpClientInstrumentation().AddConsoleExporter() );

然后啟動(dòng)我們的項(xiàng)目，訪問 http://localhost:5000/WeatherForecast 接口，控制臺(tái)會(huì)輸出下面的信息：

這些是診斷數(shù)據(jù)的基礎(chǔ)格式，如果你了解OpenTracing，你會(huì)發(fā)現(xiàn)，為什么這里是 Activity，而不是 Span，這不符合規(guī)范。確實(shí)是這樣，因?yàn)?NET 中已經(jīng)有了 Activity 類型，所以.NET 團(tuán)隊(duì)決定重用它，并且在 .NET 5增強(qiáng)為 ActivitySource, 所以在.NET 中，你可以把 Span 和 Activity 概念互換。

JaegerExporter

Jaeger 是Uber推出的一款開源分布式追蹤系統(tǒng)。

安裝包?OpenTelemetry.Exporter.Jaeger，然后修改 ConfigureServices 如下：

services.AddOpenTelemetryTracing((builder) => builder.SetResourceBuilder(ResourceBuilder.CreateDefault().AddService("webapi-demo")).AddAspNetCoreInstrumentation().AddHttpClientInstrumentation().AddJaegerExporter(options => {options.AgentHost = "localhost";options.AgentPort = 6831;}) );

在Docker中，執(zhí)行下邊的命令，安裝Jaeger

docker run -d --name jaeger \ -p 5775:5775/udp \-p 6831:6831/udp \-p 6832:6832/udp \-p 5778:5778 \-p 16686:16686 \-p 14268:14268 \-p 14250:14250 \ jaegertracing/all-in-one:1.21

稍等片刻，安裝完成以后，訪問 http://localhost:16686 可以看到Jaeger的頁(yè)面

然后啟動(dòng)我們的項(xiàng)目，訪問幾次 http://localhost:5000/WeatherForecast 接口，然后再訪問Jaeger的頁(yè)面，選擇我們的服務(wù)查詢，可以看到下邊的請(qǐng)求信息：

ZipkinExporter

Zipkin 是Twitter推出的一款開源分布式追蹤系統(tǒng)。

安裝包?OpenTelemetry.Exporter.Zipkin，然后修改 ConfigureServices 如下：

services.AddOpenTelemetryTracing((builder) => builder .AddAspNetCoreInstrumentation().AddHttpClientInstrumentation().AddZipkinExporter(options => {options.ServiceName = "webapi-demo";options.Endpoint = new Uri("http://localhost:9411/api/v2/spans");}) );

在Docker中，執(zhí)行下邊的命令，安裝Zipkin

docker run -d -p 9411:9411 openzipkin/zipkin

安裝完成后，訪問 http://localhost:9411 可以看到Zipkin的首頁(yè)：

然后啟動(dòng)我們的項(xiàng)目，訪問幾次 http://localhost:5000/WeatherForecast 接口，然后再回到Zipkin的頁(yè)面， 可以看到下面的請(qǐng)求信息：

Trace的頁(yè)面：

總結(jié)

本文嘗試在.NET 5 中引入了 OpenTelemetry，可以看到使用起來(lái)非常的方便，對(duì)接第三方的分布式追蹤平臺(tái)，我們只需要改動(dòng)極少的代碼，這就是OpenTelemetry大一統(tǒng)的標(biāo)準(zhǔn)。?

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ??? ? ? ? ??

歡迎掃碼關(guān)注我們的公眾號(hào) 【全球技術(shù)精選】，可以加入到.NET APM Group 微信群, 一起來(lái)交流APM和監(jiān)控相關(guān)的技術(shù)。

總結(jié)

以上是生活随笔為你收集整理的当 .NET 5 遇上OpenTelemetry，会碰撞出怎样的火花？的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。