當 .NET 5 趕上OpenTelemetry，會碰撞出怎樣的火花？

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和監控相關的技術。