ASP.NET Core整合Zipkin链路跟踪
前言
????在日常使用ASP.NET Core的開發(fā)或?qū)W習(xí)中，如果有需要使用鏈路跟蹤系統(tǒng)，大多數(shù)情況下會優(yōu)先選擇SkyAPM。我們之前也說過SkyAPM設(shè)計確實比較優(yōu)秀，巧妙的利用DiagnosticSource診斷跟蹤日志，可以做到對項目無入侵方式的集成。其實還有一款比較優(yōu)秀的鏈路跟蹤系統(tǒng)，也可以支持ASP.NET Core，叫Zipkin。它相對于SkyWalking來說相對輕量級，使用相對來說比較偏原生的方式，而且支持Http的形式查詢和提交鏈路數(shù)據(jù)。因為我們總是希望能擁有多一種的解決方案方便對比和參考，所以接下來我們就來學(xué)習(xí)一下關(guān)于Zipkin的使用方式。
Zipkin簡介
??? Zipkin是由Twitter開源的一款基于Java語言開發(fā)的分布式實時數(shù)據(jù)追蹤系統(tǒng)(Distributed Tracking System),其主要功能是采集來自各個系統(tǒng)的實時監(jiān)控數(shù)據(jù)。該系統(tǒng)讓開發(fā)者可通過一個 Web 前端輕松的收集和分析數(shù)據(jù)，例如用戶每次請求服務(wù)的處理時間等，可方便的監(jiān)測系統(tǒng)中存在的瓶頸。它大致可以分為三個核心概念
首先是上報端，它主要通過代碼的形式集成到程序中，用于上報Trace數(shù)據(jù)到Collector端。
Collector負(fù)責(zé)接收客戶端發(fā)送過來的數(shù)據(jù)，保存到內(nèi)存或外部存儲系統(tǒng)中，供UI展示。
存儲端可以是基于zipkin內(nèi)存完全不依賴外部存儲的In-Memory形式或依賴外部存儲系統(tǒng)的形式，一般采用外部存儲系統(tǒng)存儲鏈路數(shù)據(jù)，畢竟內(nèi)存有限。它可支持的存儲數(shù)據(jù)庫有MySQL、Cassandra、Elasticsearch。
UI負(fù)責(zé)展示采集的鏈路數(shù)據(jù)，及系統(tǒng)之間的依賴關(guān)系。
相對來說還是比較清晰的，如果用一張圖表示整體架構(gòu)的話，大致如下圖所示(圖片來源于網(wǎng)絡(luò))在學(xué)習(xí)鏈路跟蹤的過程中會設(shè)計到相關(guān)概念，我們接下來介紹鏈路跟蹤幾個相關(guān)的概念TranceId,一般一次全局的請求會有一個唯一的TraceId，用于代表一次唯一的請求。比如我請求了訂單管理系統(tǒng)，而訂單管理系統(tǒng)內(nèi)部還調(diào)用了商品管理系統(tǒng)，而商品管理系統(tǒng)還調(diào)用了緩存系統(tǒng)或數(shù)據(jù)庫系統(tǒng)。但是對全局或外部來說這是一次請求，所以會有唯一的一個TraceId。
SpanId,雖然全局的來說是一次大的請求，但是在這個鏈路中內(nèi)部間還會發(fā)起別的請求，這種內(nèi)部間的每次請求會生成一個SpanId。
如果將整條鏈路串聯(lián)起來的話，我們需要記錄全局的TraceId，代表當(dāng)前節(jié)點的SpanId和發(fā)起對當(dāng)前節(jié)點調(diào)用的的父級ParentId。
然后基于鏈路跟蹤的核心概念，然后介紹一下Zipkin衍生出來了幾個相關(guān)概念cs:Clent Sent 客戶端發(fā)起請求的時間，比如 dubbo 調(diào)用端開始執(zhí)行遠程調(diào)用之前。
cr:Client Receive 客戶端收到處理完請求的時間。
ss:Server Receive 服務(wù)端處理完邏輯的時間。
sr:Server Receive 服務(wù)端收到調(diào)用端請求的時間。
關(guān)于zipkin概念相關(guān)的就介紹這么多，接下來我們介紹如何部署Zipkin。
部署ZipKin
????關(guān)于Zipkin常用的部署方式大概有兩種，一種是通過下載安裝JDK，然后運行zipkin.jar的方式，另一種是基于Docker的方式。為了方便我采用的是基于Docker的方式部署，因為采用原生的方式去部署還需要安裝JDK，而且操作相對比較麻煩。咱們上面說過，雖然Zipkin可以將鏈路數(shù)據(jù)存放到內(nèi)存中，但是這種操作方式并不實用，實際使用過程中多采用ElasticSearch存儲鏈路數(shù)據(jù)。所以部署的時候需要依賴Zipkin和ElasticSearch，對于這種部署形式采用docker-compose的方式就再合適不過了，大家可以在Zipkin官方Github中找到docker的部署方式，地址是https://github.com/openzipkin/zipkin/tree/master/docker,官方使用的方式相對比較復(fù)雜，下載下來docker-compose相關(guān)文件之后我簡化了它的使用方式，最終修改如下
version: "3.6" services:elasticsearch:# 我使用的是7.5.0版本image: elasticsearch:7.5.0container_name: elasticsearchrestart: always#暴露es端口ports:- 9200:9200environment:- discovery.type=single-node- bootstrap.memory_lock=true#es有內(nèi)存要求- "ES_JAVA_OPTS=-Xms512m -Xmx512m"ulimits:memlock:soft: -1hard: -1networks:default:aliases:- elasticsearchzipkin:image: openzipkin/zipkincontainer_name: zipkinrestart: alwaysnetworks:default:aliases:- zipkinenvironment:#存儲類型為es- STORAGE_TYPE=elasticsearch#es地址- ES_HOSTS=elasticsearch:9200ports:- 9411:9411#依賴es所以在es啟動完成后在啟動zipkindepends_on:- elasticsearch通過docker-compose運行編輯后的yaml文件,一條指令就可以運行起來
docker-compose -f docker-compose-elasticsearch7.yml up其中-f是指定文件名稱，如果是docker-compose.yml則可以直接忽略文件名稱，當(dāng)shell中出現(xiàn)如下界面并且在瀏覽器中輸入http://localhost:9411/zipkin/出現(xiàn)如圖所示，則說明Zikpin啟動成功
整合ASP.NET Core
ZipKin啟動成功之后，我們就可以將程序中的數(shù)據(jù)采集到Zipkin中去了，我新建了兩個ASP.NET Core的程序，一個是OrderApi,另一個是ProductApi方便能體現(xiàn)出調(diào)用鏈路，其中OrderApi調(diào)用ProductApi接口，在兩個項目中分別引入Zipkin依賴包
<PackageReference Include="zipkin4net" Version="1.5.0" /> <PackageReference Include="zipkin4net.middleware.aspnetcore" Version="1.5.0" />其中zipkin4net為核心包，zipkin4net.middleware.aspnetcore是集成ASP.NET Core的程序包。然后我們在Startup文件中添加如下方法
public void RegisterZipkinTrace(IApplicationBuilder app, ILoggerFactory loggerFactory, IHostApplicationLifetime lifetime) {lifetime.ApplicationStarted.Register(() =>{//記錄數(shù)據(jù)密度，1.0代表全部記錄TraceManager.SamplingRate = 1.0f;//鏈路日志var logger = new TracingLogger(loggerFactory, "zipkin4net");//zipkin服務(wù)地址和內(nèi)容類型var httpSender = new HttpZipkinSender("http://localhost:9411/", "application/json");var tracer = new ZipkinTracer(httpSender, new JSONSpanSerializer(), new Statistics());var consoleTracer = new zipkin4net.Tracers.ConsoleTracer();TraceManager.RegisterTracer(tracer);TraceManager.RegisterTracer(consoleTracer);TraceManager.Start(logger);});//程序停止時停止鏈路跟蹤lifetime.ApplicationStopped.Register(() => TraceManager.Stop());//引入zipkin中間件，用于跟蹤服務(wù)請求,這邊的名字可自定義代表當(dāng)前服務(wù)名稱app.UseTracing(Configuration["nacos:ServiceName"]); }然后我們在Configure方法中調(diào)用RegisterZipkinTrace方法即可。由于我們要在OrderApi項目中采用HttpClient的方式調(diào)用ProductAPI,默認(rèn)zipkin4net是支持采集HttpClient發(fā)出請求的鏈路數(shù)據(jù)(由于在ProductApi中我們并不發(fā)送Http請求，所以可以不用集成一下操作)，具體集成形式如下，如果使用的是HttpClientFactory的方式，在ConfigureServices中配置如下
public void ConfigureServices(IServiceCollection services) {//由于我使用了Nacos作為服務(wù)注冊中心services.AddNacosAspNetCore(Configuration);services.AddScoped<NacosDiscoveryDelegatingHandler>();services.AddHttpClient(ServiceName.ProductService,client=> {client.BaseAddress = new Uri($"http://{ServiceName.ProductService}");}).AddHttpMessageHandler<NacosDiscoveryDelegatingHandler>()//引入zipkin trace跟蹤httpclient請求，名稱配置當(dāng)前服務(wù)名稱即可.AddHttpMessageHandler(provider =>TracingHandler.WithoutInnerHandler(Configuration["nacos:ServiceName"]));services.AddControllers(); }如果是直接是使用HttpClient的形式調(diào)用則可以采用以下方式
using (HttpClient client = new HttpClient(new TracingHandler("OrderApi"))) { }然后我們在OrderApi中寫一段調(diào)用ProductApi的代碼
[Route("orderapi/[controller]")] public class OrderController : ControllerBase {private List<OrderDto> orderDtos = new List<OrderDto>();private readonly IHttpClientFactory _clientFactory;public OrderController(IHttpClientFactory clientFactory){orderDtos.Add(new OrderDto { Id = 1, TotalMoney=222,Address="北京市",Addressee="me",From="淘寶",SendAddress="武漢" });_clientFactory = clientFactory;}/// <summary>/// 獲取訂單詳情接口/// </summary>/// <param name="id">訂單id</param>/// <returns></returns>[HttpGet("getdetails/{id}")]public async Task<OrderDto> GetOrderDetailsAsync(long id){OrderDto orderDto = orderDtos.FirstOrDefault(i => i.Id == id);if (orderDto != null){OrderDetailDto orderDetailDto = new OrderDetailDto{Id = orderDto.Id,TotalMoney = orderDto.TotalMoney,Address = orderDto.Address,Addressee = orderDto.Addressee,From = orderDto.From,SendAddress = orderDto.SendAddress};//調(diào)用ProductApi服務(wù)接口var client = _clientFactory.CreateClient(ServiceName.ProductService);var response = await client.GetAsync($"/productapi/product/getall");var result = await response.Content.ReadAsStringAsync();orderDetailDto.Products = JsonConvert.DeserializeObject<List<OrderProductDto>>(result);return orderDetailDto;}return orderDto;} }在ProductApi中我們只需要編寫調(diào)用RegisterZipkinTrace方法即可，和OrderApi一樣，我們就不重復(fù)粘貼了。因為ProductApi不需要調(diào)用別的服務(wù)，所以可以不必使用集成HttpClient,只需要提供簡單的接口即可
[Route("productapi/[controller]")] public class ProductController : ControllerBase {private List<ProductDto> productDtos = new List<ProductDto>();public ProductController(){productDtos.Add(new ProductDto { Id = 1,Name="酒精",Price=22.5m });productDtos.Add(new ProductDto { Id = 2, Name = "84消毒液", Price = 19.9m });}/// <summary>/// 獲取所有商品信息/// </summary>/// <returns></returns>[HttpGet("getall")]public IEnumerable<ProductDto> GetAll(){return productDtos;} }啟動這兩個項目，調(diào)用OrderApi的getdetails接口，完成后打開zipkin界面點擊進去可查看鏈路詳情
總結(jié)起來核心操作其實就兩個，一個是在發(fā)送請求的地方，使用TracingHandler記錄發(fā)起端的鏈路情況，然后在接收請求的服務(wù)端使用UseTracing記錄來自于客戶端請求的鏈路情況。
改進集成方式
????其實在上面的演示中，我們可以明顯的看到明顯的不足，就是很多時候其實我們沒辦法去設(shè)置HttpClient相關(guān)的參數(shù)的，很多框架雖然也是使用的HttpClient或HttpClientFactory相關(guān)，但是在外部我們沒辦法通過自定義的方式去設(shè)置他們的相關(guān)操作，比如Ocelot其實也是使用HttpClient相關(guān)發(fā)起的轉(zhuǎn)發(fā)請求，但是對外我們沒辦法通過我們的程序去設(shè)置HttpClient的參數(shù)。還有就是在.Net Core中WebRequest其實也是對HttpClient的封裝，但是我們同樣沒辦法在我們的程序中給他們傳遞類似TracingHandler的操作。現(xiàn)在我們從TracingHandler源碼開始解讀看看它的內(nèi)部到底是如何工作的，zipkin官方提供的.net core插件zipkin4net的源碼位于
https://github.com/openzipkin/zipkin4net,我們找到TracingHandler類所在的位置[點擊查看源碼????]，由于TracingHandler本身就是DelegatingHandler的子類，所以我們主要看SendAsync方法，大致抽離出來如下
實現(xiàn)方式比較簡單，就是借助ClientTrace記錄一些標(biāo)簽，其他的相關(guān)操作都是由zipkin4net提供的。我們在之前的文章.Net Core中的診斷日志DiagnosticSource講解中層說道HttpClient底層會有發(fā)出診斷日志，我們可以借助這個思路，來對HttpClient進行鏈路跟蹤埋點。
我們結(jié)合Microsoft.Extensions.DiagnosticAdapter擴展包定義如下類
ITraceDiagnosticListener是我們方便操作DiagnosticListener定義的接口，接口僅包含DiagnosticName用來表示DiagnosticListener監(jiān)聽的名稱，有了這個接口接下來的操作我們會方便許多，接下來我們來看訂閱操作的實現(xiàn)。
public class TraceObserver :IObserver<DiagnosticListener> {private IEnumerable<ITraceDiagnosticListener> _traceDiagnostics;public TraceObserver(IEnumerable<ITraceDiagnosticListener> traceDiagnostics) {_traceDiagnostics = traceDiagnostics;}public void OnCompleted() {}public void OnError(Exception error) {}public void OnNext(DiagnosticListener listener) {//這樣的話我們可以更輕松的擴展其他DiagnosticListener的操作var traceDiagnostic = _traceDiagnostics.FirstOrDefault(i=>i.DiagnosticName==listener.Name);if (traceDiagnostic!=null){//適配訂閱listener.SubscribeWithAdapter(traceDiagnostic);}} }通過這種操作我們就無需關(guān)心如何將自定義的DiagnosticListener訂閱類適配到DiagnosticAdapter中去，方便我們自定義其他DiagnosticListener的訂閱類，這樣的話我們只需注冊自定義的訂閱類即可。
services.AddSingleton<TraceObserver>(); services.AddSingleton<ITraceDiagnosticListener, HttpDiagnosticListener>();通過這種改進方式，我們可以解決類似HttpClient封裝到框架中，并且我們我們無法通過外部程序去修改設(shè)置的時候。比如我們在架構(gòu)中引入了Ocelot網(wǎng)關(guān)，我們就可以采用類似這種方式，在網(wǎng)關(guān)層集成zipkin4net。
自定義埋點
????通過上面我們查看TracingHandler的源碼我們得知埋點主要是通過ClientTrace進行的，它是在發(fā)起請求的客戶端進行埋點。在服務(wù)端埋點的方式我們可以通過TracingMiddleware中間件中的源碼查看到[點擊查看源碼????]叫ServerTrace。有了ClientTrace和ServerTrace我們可以非常輕松的實現(xiàn)一次完整的客戶端和服務(wù)端埋點，只需要通過它們打上一些標(biāo)簽即可。其實它們都是對Trace類的封裝，我們找到它們的源碼進行查看
public class ClientTrace : BaseStandardTrace, IDisposable {public ClientTrace(string serviceName, string rpc){if (Trace.Current != null){Trace = Trace.Current.Child();}Trace.Record(Annotations.ClientSend());Trace.Record(Annotations.ServiceName(serviceName));Trace.Record(Annotations.Rpc(rpc));}public void Dispose(){Trace.Record(Annotations.ClientRecv());} }public class ServerTrace : BaseStandardTrace, IDisposable {public override Trace Trace{get{return Trace.Current;}}public ServerTrace(string serviceName, string rpc){Trace.Record(Annotations.ServerRecv());Trace.Record(Annotations.ServiceName(serviceName));Trace.Record(Annotations.Rpc(rpc));}public void Dispose(){Trace.Record(Annotations.ServerSend());} }因此，如果你想通過更原始的方式去記錄跟蹤日志可以采用如下方式
var trace = Trace.Create(); trace.Record(Annotations.ServerRecv()); trace.Record(Annotations.ServiceName(serviceName)); trace.Record(Annotations.Rpc("GET")); trace.Record(Annotations.ServerSend()); trace.Record(Annotations.Tag("http.url", "<url>"));示例Demo
由于上面說的比較多，而且有一部分關(guān)于源碼的解讀，為了防止由本人文筆有限，給大家?guī)砝斫庹`區(qū)，另一方面也為了更清晰的展示Zipkin的集成方式，我自己做了一套Demo，目錄結(jié)構(gòu)如下
ApiGateway為網(wǎng)關(guān)項目可以轉(zhuǎn)發(fā)針對OrderApi的請求，OrderApi和ProductApi用于模擬業(yè)務(wù)系統(tǒng)，這三個項目都集成了zipkin4net鏈路跟蹤，他們之間是通過Nacos實現(xiàn)服務(wù)的注冊和發(fā)現(xiàn)。這個演示Demo我本地是可以直接運行成功的，如果有下載下來運行不成功的，可以評論區(qū)給我留言。由于博客園有文件上傳大小的限制，所以我將Demo上傳到了百度網(wǎng)盤中
下載鏈接:?https://pan.baidu.com/s/1jPHyXKV9DAK_oEYQz3xtzA?提取碼: a7u5
總結(jié)
????以上就是關(guān)于Zipkin以及ASP.NET Core整合Zipkin的全部內(nèi)容，希望能給大家?guī)硪欢ǖ膸椭Ｈ绻阌袑嶋H需要也可以繼續(xù)自行研究。Zipkin相對于我們常用的Skywalking而且，它的使用方式比較原生，許多操作都需要自行通過代碼操作，而SkyAPM可以做到對代碼無入侵的方式集成。Skywalking是一款A(yù)PM(應(yīng)用性能管理)，鏈路跟蹤只是它功能的一部分。而Zipkin是一款專注于鏈路跟蹤的系統(tǒng)，個人感覺就鏈路跟蹤這一塊而言，Zipkin更輕量級(如果都使用ES作為存儲的數(shù)據(jù)庫的話，Skywalking會生成一堆索引，Zipkin默認(rèn)是每天創(chuàng)建一個索引)，而且鏈路信息檢索、詳情展示、鏈路數(shù)據(jù)上報形式等相對于Skywalking形式也更豐富一些。但是整體而言Skywalking更強大，比如應(yīng)用監(jiān)控、調(diào)用分析、集成方式等。技術(shù)并無好壞之分，適合自己的才是更好的，多一個解決方案，就多一個解決問題的思路，我覺得這是對于我們程序開發(fā)人員來說都應(yīng)該具備的認(rèn)知。
????歡迎掃碼關(guān)注我的公眾號????
總結(jié)
以上是生活随笔為你收集整理的ASP.NET Core整合Zipkin链路跟踪的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： .NET Core 下使用 gRPC
- 下一篇： ASP.NET Core 性能优化最佳实