摘要：配置配置使用概率抽樣。采樣率定義了對跟蹤跨度進(jìn)行采樣的概率，其值可以介于和含之間。例如，以下配置對象將采樣率更改為即每個跨度都被采樣，并使用協(xié)議將跟蹤發(fā)送到位于的服務(wù)器文件路徑注將采樣率更改為會完全禁用跟蹤。

目錄

手把手教你學(xué)Dapr - 1. .Net開發(fā)者的大時代

手把手教你學(xué)Dapr - 2. 必須知道的概念

手把手教你學(xué)Dapr - 3. 使用Dapr運行第一個.Net程序

手把手教你學(xué)Dapr - 4. 服務(wù)調(diào)用

手把手教你學(xué)Dapr - 5. 狀態(tài)管理

手把手教你學(xué)Dapr - 6. 發(fā)布訂閱

手把手教你學(xué)Dapr - 7. Actors

手把手教你學(xué)Dapr - 8. 綁定

手把手教你學(xué)Dapr - 9. 可觀測性

介紹

通過Tracing(跟蹤)、Metrics(指標(biāo))、Logs(日志)和Health(運行狀況)監(jiān)控應(yīng)用程序。

分布式跟蹤

Dapr 使用 Zipkin 協(xié)議進(jìn)行分布式跟蹤 和 Metrics 收集。由于 Zipkin 協(xié)議的普遍性，許多后端都是開箱即用的，例如 Stackdriver、Zipkin、New Relic 等。結(jié)合 OpenTelemetry Collector，Dapr 可以將跟蹤導(dǎo)出到許多其他后端，包括但不限于 Azure Monitor、Datadog、Instana、Jaeger 和 SignalFX。

Tracing設(shè)計

Dapr 在 Dapr Sidecar 中添加了一個 HTTP/gRPC 中間件。中間件攔截所有 Dapr 和應(yīng)用程序流量，并自動注入關(guān)聯(lián) ID 以跟蹤分布式事務(wù)。這種設(shè)計有幾個好處：

• 無需代碼檢測。使用可配置的跟蹤級別自動跟蹤所有流量。
• 跨微服務(wù)的一致性跟蹤行為。跟蹤是在 Dapr Sidecar 上配置和管理的，因此它在由不同團(tuán)隊制作并可能用不同編程語言編寫的服務(wù)之間保持一致。
• 可配置和可擴(kuò)展。利用 Zipkin API 和 OpenTelemetry Collector，Dapr 跟蹤可以配置為與流行的跟蹤后端一起使用，包括客戶可能擁有的自定義后端。
• 您可以同時定義和啟用多個導(dǎo)出器。

W3C 關(guān)聯(lián) ID

Dapr 使用標(biāo)準(zhǔn)的 W3C 跟蹤上下文標(biāo)頭。對于 HTTP 請求，Dapr 使用 traceparent 標(biāo)頭。對于 gRPC 請求，Dapr 使用 grpc-trace-bin 標(biāo)頭。當(dāng)一個沒有跟蹤 ID 的請求到達(dá)時，Dapr 會創(chuàng)建一個新的。否則，它會沿著調(diào)用鏈傳遞跟蹤 ID。

配置

Dapr 使用概率抽樣。采樣率定義了對跟蹤跨度進(jìn)行采樣的概率，其值可以介于 0 和 1（含）之間。默認(rèn)采樣率為 0.0001（即采樣 10,000 個跨度中的 1 個）。

要更改默認(rèn)跟蹤行為，請使用配置文件。例如，以下配置對象將采樣率更改為 1（即每個跨度都被采樣），并使用 Zipkin 協(xié)議將跟蹤發(fā)送到位于 http://zipkin.default.svc.cluster.local 的 Zipkin 服務(wù)器

yaml文件路徑：%UserProfile%/.dapr/config.yaml

apiVersion: dapr.io/v1alpha1kind: Configurationmetadata:  name: tracing  namespace: defaultspec:  tracing:    samplingRate: "1"    zipkin:      endpointAddress: "http://zipkin.default.svc.cluster.local:9411/api/v2/spans"

注：將采樣率更改為 0 會完全禁用跟蹤。

W3C 跟蹤上下文

Dapr 使用 W3C 跟蹤上下文對服務(wù)調(diào)用和發(fā)布/訂閱消息進(jìn)行分布式跟蹤。Dapr 完成了生成和傳播跟蹤上下文信息的所有繁重工作，僅在極少數(shù)情況下，您需要傳播或創(chuàng)建跟蹤上下文。

W3C trace context有以下優(yōu)勢：

• 為單個跟蹤和請求提供唯一標(biāo)識符，允許將多個提供程序的跟蹤數(shù)據(jù)鏈接在一起。
• 提供轉(zhuǎn)發(fā)特定于供應(yīng)商的跟蹤數(shù)據(jù)的商定機(jī)制，并避免跟蹤在多個工具參與單個事務(wù)時中斷。
• 提供中間商、平臺和硬件提供商可以支持的行業(yè)標(biāo)準(zhǔn)。

有兩種情況需要了解如何使用跟蹤：

1. Dapr 在服務(wù)之間生成并傳播跟蹤上下文。
2. Dapr 生成跟蹤上下文，您需要將跟蹤上下文傳播到另一個服務(wù)，或者您生成跟蹤上下文，Dapr 將跟蹤上下文傳播到服務(wù)。

Dapr 在服務(wù)之間生成并傳播跟蹤上下文

在某些情況下，Dapr 會為您完成所有工作。您不需要創(chuàng)建和傳播任何跟蹤標(biāo)頭。 Dapr 負(fù)責(zé)創(chuàng)建所有跟蹤標(biāo)頭并傳播它們。讓我們通過示例來了解場景；

1. 單個服務(wù)調(diào)用（服務(wù) A -> 服務(wù) B）

   Dapr 在服務(wù) A 中生成跟蹤標(biāo)頭，這些跟蹤標(biāo)頭從服務(wù) A 傳播到服務(wù) B。

2. 多個順序服務(wù)調(diào)用（服務(wù) A -> 服務(wù) B -> 服務(wù) C）

   Dapr 在服務(wù) A 中的請求開始時生成跟蹤標(biāo)頭，這些跟蹤標(biāo)頭從服務(wù) A-> 服務(wù) B -> 服務(wù) C 等傳播到進(jìn)一步啟用 Dapr 的服務(wù)。

3. 請求是來自外部endpoint（例如從網(wǎng)關(guān)服務(wù)到啟用 Dapr 的服務(wù) A）

Dapr Sidecar 健康檢查

Dapr 提供了一種使用 HTTP /healthz endpoint來確定其健康狀況的方法。有了這個endpoint，可以探測 Dapr 進(jìn)程或邊車的健康狀況，從而確定其準(zhǔn)備情況和活躍度。

在將 Dapr 部署到托管平臺（例如 Kubernetes）時，會自動為您配置 Dapr health endpoint。您無需進(jìn)行任何配置。

Health endpoint: 與 Kubernetes 集成

Kubernetes 使用 readiness 和 liveness 探測來確定容器的健康狀況。

kubelet使用活動探針來知道何時重新啟動容器。 例如，活動探測可以捕獲死鎖，即應(yīng)用程序正在運行，但無法取得進(jìn)展。在這種狀態(tài)下重新啟動容器有助于使應(yīng)用程序更可用，盡管存在缺陷。

kubelet 使用就緒探針來了解容器何時準(zhǔn)備好開始接受流量。當(dāng) pod 的所有容器都準(zhǔn)備就緒時，它就被認(rèn)為是準(zhǔn)備好了的。這種準(zhǔn)備信號的一個用途是控制哪些Pods被用作Kubernetes服務(wù)的后端。 當(dāng) Pod 未準(zhǔn)備好時，它將從Kubernetes服務(wù)負(fù)載均衡器中刪除。

當(dāng)與 Kubernetes 集成時，Dapr Sidecar 被注入了一個 Kubernetes 探針配置，告訴它使用 Dapr healthz endpoint。這是由 Sidecar Injector 系統(tǒng)服務(wù)完成的。與 kubelet 的集成如下圖所示。

如何在 Kubernetes 中配置活性探針

在 pod 配置文件中，在容器規(guī)范部分添加了 liveness 探針，如下所示：

livenessProbe:     httpGet:       path: /healthz       port: 8080     initialDelaySeconds: 3     periodSeconds: 3

在上面的例子中， periodSeconds 字段指定 kubelet 應(yīng)該每 3 秒執(zhí)行一次活性探測。 initialDelaySeconds 字段告訴 kubelet 在執(zhí)行第一次探測之前應(yīng)該等待 3 秒。

注：任何大于或等于 200 且小于 400 的代碼都表示成功。其他代碼表示失敗。

如何在 Kubernetes 中配置就緒探針

就緒探針的配置類似于活性探針。唯一的區(qū)別是您使用 readinessProbe 字段而不是 livenessProbe 字段。

readinessProbe:      httpGet:        path: /healthz        port: 8080      initialDelaySeconds: 3      periodSeconds: 3

如何使用 Kubernetes 配置 Dapr Sidecar health endpoint

此配置由 Sidecar Injector 服務(wù)自動完成。Dapr 在端口 3500 上有它的 HTTP health endpint /v1.0/healthz，這可以與 Kubernetes 一起使用以進(jìn)行就緒和活躍度探測。當(dāng)注入 Dapr sidecar 時，readiness 和 liveness 探針在 pod 配置文件中配置為以下值。

livenessProbe:      httpGet:        path: v1.0/healthz        port: 3500      initialDelaySeconds: 5      periodSeconds: 10      timeoutSeconds : 5      failureThreshold : 3readinessProbe:      httpGet:        path: v1.0/healthz        port: 3500      initialDelaySeconds: 5      periodSeconds: 10      timeoutSeconds : 5      failureThreshold: 3

.Net中使用可觀測性

創(chuàng)建Assignment.Server

創(chuàng)建類庫項目，并添加Dapr.AspNetCore, OpenTelemetry, OpenTelemetry.Instrumentation.AspNetCore, OpenTelemetry.Instrumentation.Http,OpenTelemetry.Extensions.Hosting和OpenTelemetry.Exporter.ZipkinNuGet包引用，最后修改程序端口為5000。

!!!注：版本很重要，NuGet要打開包含預(yù)發(fā)行版，并且使用指定版本

OpenTelemetry-1.2.0-beta1

OpenTelemetry.Instrumentation.AspNetCore-1.0.0-rc8

OpenTelemetry.Instrumentation.Http-1.0.0-rc8

OpenTelemetry.Exporter.Zipkin-1.2.0-beta1

OpenTelemetry.Extensions.Hosting-1.0.0-rc8

修改program.cs

using OpenTelemetry.Resources;using OpenTelemetry.Trace;var builder = WebApplication.CreateBuilder(args);builder.Services.AddOpenTelemetryTracing((tracerProviderBuilder) =>    tracerProviderBuilder        .SetResourceBuilder(ResourceBuilder.CreateDefault().AddService("testobservability"))        .AddAspNetCoreInstrumentation()        .AddHttpClientInstrumentation()        .AddZipkinExporter(zipkinOptions =>        {            zipkinOptions.Endpoint = new Uri("http://localhost:9411/api/v2/spans");        }    ));var app = builder.Build();app.Map("/Amazing", async (HttpContext context) =>{    if (context.Request.Headers.TryGetValue("traceparent", out var traceparent))    {        Console.WriteLine($"TraceParent: {traceparent}");    }    if (context.Request.Headers.TryGetValue("tracestate", out var tracestate))    {        Console.WriteLine($"TraceState: {tracestate}");    }    System.Diagnostics.Activity.Current?.SetParentId(traceparent.ToString());    _ = await new HttpClient().GetStringAsync("https://www.baidu.com");    Console.WriteLine($"Invoke succeed: traceID:{traceparent}");});app.Run();

可以看到我們直接演示了一個好玩的用法，就是開啟.Net的OpenTelemetry，然后修改Diagnostics.Activity的ParentId，讓當(dāng)前的Tracing跟Dapr Sidecar傳來的TraceId一致。

運行Assignment.Server

使用Dapr CLI來啟動，先使用命令行工具跳轉(zhuǎn)到目錄 dapr-study-room/Assignment07/Assignment.Server，然后執(zhí)行下面命令

dapr run --app-id testobservability --app-port 5000 --dapr-http-port 3500 --dapr-grpc-port 50001 dotnet run

使用Dapr CLI發(fā)個命令看看

dapr invoke --app-id testobservability --method /Amazing

打開Zipkin，地址：http://localhost:9411/, 來看一下Zipkin的Tracing，不單有Dapr Sidecar的請求記錄進(jìn)來了，還跟HttpClient的捆綁在了起來，是的，有趣的就在這里。

除了可以跟蹤HttpClient以外，還有EF Core等都集成了。

至于Metrics和Logs集成也是非常簡單，需要搭配不同的后端如Prometheus, Fluentd等。甚至可以通過自定義Exporter自行對接一些云廠商的云服務(wù)。

本章源碼

Assignment09

https://github.com/doddgu/dapr-study-room

我們正在行動，新的框架、新的生態(tài)

我們的目標(biāo)是自由的、易用的、可塑性強的、功能豐富的、健壯的。

所以我們借鑒Building blocks的設(shè)計理念，正在做一個新的框架MASA Framework，它有哪些特點呢？

• 原生支持Dapr，且允許將Dapr替換成傳統(tǒng)通信方式
• 架構(gòu)不限，單體應(yīng)用、SOA、微服務(wù)都支持
• 支持.Net原生框架，降低學(xué)習(xí)負(fù)擔(dān)，除特定領(lǐng)域必須引入的概念，堅持不造新輪子
• 豐富的生態(tài)支持，除了框架以外還有組件庫、權(quán)限中心、配置中心、故障排查中心、報警中心等一系列產(chǎn)品
• 核心代碼庫的單元測試覆蓋率90%+
• 開源、免費、社區(qū)驅(qū)動
• 還有什么？我們在等你，一起來討論

經(jīng)過幾個月的生產(chǎn)項目實踐，已完成POC，目前正在把之前的積累重構(gòu)到新的開源項目中

目前源碼已開始同步到Github（文檔站點在規(guī)劃中，會慢慢完善起來）：

MASA.BuildingBlocks

MASA.Contrib

MASA.Utils

MASA.EShop

BlazorComponent

MASA.Blazor

QQ群：7424099

微信群：加技術(shù)運營微信（MasaStackTechOps），備注來意，邀請進(jìn)群