OpenTelemetry 介紹

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

??OpenTelemetry - 云原生下可觀測性的新標準

? 深入研究.NET 5的開放式遙測

OpenTelemetry是谷歌和微軟共同推進的云原生監控的新規范， 兼容OpenTracing和OpenCensus

OpenTelemetry的終極目標是：實現Metrics、Tracing、Logging的融合及大一統，作為APM的數據采集終極解決方案。

因為現在正式版本還沒有發布，我們現在只能使用rc版本，所以在Nuget開啟 包括預發行版,你可以在這里看到里程碑，https://github.com/open-telemetry/opentelemetry-dotnet/milestones

在webapi中接入OpenTelemetry服務

創建一個webapi項目，.NET 版本選5.0, 創建完成后，需要安裝下邊幾個包，選最新版本就好?

OpenTelemetry.Extensions.Hosting?提供服務擴展?

OpenTelemetry.Instrumentation.AspNetCore?采集AspNetCore診斷數據?

OpenTelemetry.Instrumentation.Http?采集Http診斷數據?

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

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

接下來，修改 WeatherForecastController, 來模擬簡單的接口調用

[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();}

上面的工作完成以后，我們還需要一個導出 Exporter 的組件，把數據導出到外部平臺，比如Jaeger, Zipkin, Prometheus 等，然后這些平臺會處理數據，然后展示出來。

ConsoleExporter

ConsoleExporter 是最簡單的導出數據的實現，它會把診斷數據輸出到控制臺

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

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

然后啟動我們的項目，訪問 http://localhost:5000/WeatherForecast 接口，控制臺會輸出下面的信息：

這些是診斷數據的基礎格式，如果你了解OpenTracing，你會發現，為什么這里是 Activity，而不是 Span，這不符合規范。確實是這樣，因為.NET 中已經有了 Activity 類型，所以.NET 團隊決定重用它，并且在 .NET 5增強為 ActivitySource, 所以在.NET 中，你可以把 Span 和 Activity 概念互換。

JaegerExporter

Jaeger 是Uber推出的一款開源分布式追蹤系統。

安裝包?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中，執行下邊的命令，安裝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的頁面

然后啟動我們的項目，訪問幾次 http://localhost:5000/WeatherForecast 接口，然后再訪問Jaeger的頁面，選擇我們的服務查詢，可以看到下邊的請求信息：

ZipkinExporter

Zipkin 是Twitter推出的一款開源分布式追蹤系統。

安裝包?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中，執行下邊的命令，安裝Zipkin

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

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

然后啟動我們的項目，訪問幾次 http://localhost:5000/WeatherForecast 接口，然后再回到Zipkin的頁面， 可以看到下面的請求信息：

Trace的頁面：

總結

本文嘗試在.NET 5 中引入了 OpenTelemetry，可以看到使用起來非常的方便，對接第三方的分布式追蹤平臺，我們只需要改動極少的代碼，這就是OpenTelemetry大一統的標準。?

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

歡迎掃碼關注我們的公眾號 【全球技術精選】，可以加入到.NET APM Group 微信群, 一起來交流APM和監控相關的技術。

總結

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

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。