談?wù)剆urging 微服務(wù)引擎 2.0的鏈路跟蹤和其它新增功能

一、前言

surging <https://github.com/dotnetcore/surging>是基于.NET CORE
服務(wù)引擎。初始版本誕生于2017年6月份，經(jīng)過NCC社區(qū)二年的孵化，2.0版本將在2019年08月28日進(jìn)行發(fā)布，經(jīng)歷二年的發(fā)展，已經(jīng)全部攘括了微服務(wù)架構(gòu)的技術(shù)棧，覆蓋了從服務(wù)注冊、服務(wù)發(fā)現(xiàn)、中間件、協(xié)議主機(jī)再到鏈路跟蹤，并且制定了一套微服務(wù)的規(guī)則，形成了一套統(tǒng)一的規(guī)范。以下是surging的服務(wù)引擎架構(gòu)圖



?

?

?

?

上圖Diagnostic能夠?qū)崿F(xiàn)把整個(gè)服務(wù)鏈路的各種信息采集到。

比如來源地址、遠(yuǎn)程地址、報(bào)錯、執(zhí)行時(shí)間、調(diào)用鏈路、協(xié)議類型以及參數(shù)全部采集到，采集完之后通過Skywaking Middleware 中間件的Grpc
推給Skywaking，再通過Skywaking WebUI進(jìn)行展示。

前面的協(xié)議是針對于移動端、Web端和物聯(lián)網(wǎng)的解決方案。

后面是服務(wù)引擎提供的功能。

二、服務(wù)調(diào)用鏈路跟蹤

?鏈路跟蹤集成了Skywalking, 參考了SkyAPM-dotnet <https://github.com/SkyAPM/SkyAPM-dotnet>
而擴(kuò)展的Surging.Apm.Skywalking引擎組件，而2.0版本只實(shí)現(xiàn)rpc 和rest 調(diào)用進(jìn)行鏈路跟蹤，具體配置如下


?1.首先創(chuàng)建文件skyapm.json，放在引擎根目錄下或者是指定的rootpath根目錄下，配置代碼如下
{ "SkyWalking": { "ServiceName": "Surging.Services.Server", "Namespace": "",
"HeaderVersions": [ "sw6" ], "Sampling": { "SamplePer3Secs": -1, "Percentage":
-1.0 }, "Logging": { "Level": "Information", "FilePath":
"logs/skyapm-{Date}.log" }, "Transport": { "Interval": 3000, "ProtocolVersion":
"v6", "QueueSize": 30000, "BatchSize": 3000, "gRPC": { "Servers":
"localhost:11800", "Timeout": 100000, "ConnectTimeout": 100000,
"ReportTimeout": 600000 } } } }
2.然后添加引用或者掃描引用Surging.Apm.Skywalking組件，就能把采集的數(shù)據(jù)提交到Skywalking

3.或者可以通過配置項(xiàng)DisableDiagnostic禁用數(shù)據(jù)采集，配置如下
{ "Surging": { "DisableDiagnostic": true, } }
?然后通過stage 組件GET
調(diào)用http://127.0.0.1:281/api/user/getusername/222?serviceKey=User
地址，就能通過Skywalking WebUI 看到以下界面





?









?三、Stage支持白黑名單、HttpMethod規(guī)則的設(shè)定

?1.白黑名單可以指定RoutePath，全局配置通過不指定RoutePath進(jìn)行配置，白名單的配置要高于黑名單的配置，也就說有重合的IP,
白名單會進(jìn)行覆蓋，代碼配置具體如下
"Stage": { "AccessSetting": [ { "BlackList": "${blacklist}|127.0.0.1",
"Enable": false }, { "WhiteList":
"${whitelist}|192.168.10.50,192.168.43.0/24,127.0.0.1", "BlackList":
"${blacklist}|192.168.2.50,192.168.1.0/16", "RoutePath": "api/user/exists",
"Enable": true } ] }
2.? 通過配置HttpPost ,HttpPut , HttpDelete 和 HttpGet就能配置rest的請求方式，如果不配置，所有請求都支持。而
設(shè)置isRegisterMetadata為True，就會把httpmethod注冊為服務(wù)元數(shù)據(jù)。如果是微服務(wù)可以設(shè)置為true
，如果是中轉(zhuǎn)服務(wù)或者聚合服務(wù)可以設(shè)置為false
[ServiceBundle("api/{Service}/{Method}")] //[ServiceBundle("api/{Service}")]
//[ServiceBundle("api/{Service}/{Method}/test")]
//[ServiceBundle("api/{Service}/{Method}/test",false)] public interface
IUserService: IServiceKey { /// <summary> /// 判斷是否存在 /// </summary> /// <param
name="id">用戶編號</param> /// <returns></returns> [ServiceRoute("{id}")]
[HttpPost(),HttpPut(), HttpDelete(), HttpGet()] //
[ServiceBundle("api/{Service}/{id}", false)] Task<bool> Exists(int id); ///
<summary> /// 報(bào)錯用戶 /// </summary> /// <param name="requestData">請求參數(shù)</param>
/// <returns></returns> [Authorization(AuthType = AuthorizationType.JWT)]
[HttpPost(true),HttpPut(true)] Task<IdentityUser> Save(IdentityUser
requestData); }
?

四、總結(jié)

2019年08月28日發(fā)布2.0版本，敬請期待

• ? 上一篇：.netcore持續(xù)集成測試篇之搭建內(nèi)存服務(wù)器進(jìn)行集成測試一
• ? 下一篇：[Hei.Captcha] Asp.Net Core 跨平臺圖形驗(yàn)證碼實(shí)現(xiàn)