OpenTelemetry 介紹
我在之前的幾篇文章都介紹了 OpenTelemetry, 你可以在這里找到
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和監控相關的技術。
