分布式跟踪

使用 Dapr 跟踪获取分布式应用程序的可见性

Dapr uses the Zipkin protocol for distributed traces and metrics collection. Due to the ubiquity of the Zipkin protocol, many backends are supported out of the box, for examples Stackdriver, Zipkin, New Relic and others. Combining with the OpenTelemetry Collector, Dapr can export traces to many other backends including but not limted to Azure Monitor, Datadog, Instana, Jaeger, and SignalFX.

Distributed tracing - 图1

跟踪设计

Dapr 将 HTTP/GRPC Middleware 添加到 Dapr sidecar。 Middleware 拦截所有 Dapr 和应用程序流量，并自动注入关联ID以跟踪分布式事务。 此设计有如下优点：

  • 无需代码检测。 All traffic is automatically traced with configurable tracing levels.
  • 跨微服务的一致跟踪行为。 跟踪是在 Dapr sidecar 上进行配置和管理的，因此它可以在服务之间保持一致，这些服务由不同的团队提供，并可能以不同的编程语言编写。
  • 可配置和可扩展。 By leveraging the Zipkin API and the OpenTelemetry Collector, Dapr tracing can be configured to work with popular tracing backends, including custom backends a customer may have.
  • You can define and enable multiple exporters at the same time.

W3C Correlation ID

Dapr 使用标准的 W3C 跟踪上下文标头。 对于 HTTP 请求，Dapr 使用 traceparent 标头。 对于 gRPC 请求，Dapr 使用 grpc-trace-bin 标头。 当请求到达时，如果没有跟踪 ID ，Dapr 将创建一个新的跟踪 ID。 否则，它将沿调用链传递跟踪 ID。

阅读 W3C 分布式跟踪 ，了解更多关于 W3C Trace Context 的背景.

配置

Dapr uses probabilistic sampling. 采样率定义跟踪 Span 采样的概率，其值可以在0和1之间（包括）。 The default sample rate is 0.0001 (i.e. 1 in 10,000 spans is sampled).

若要更改默认的跟踪行为，请使用配置文件（在自托管模式下）或 Kubernetes 配置对象（在 Kubernetes 模式下）。 例如，以下配置对象将采样率更改为 1（即每个Span都采样），并使用 Zipkin 协议将跟踪发送到位于 http://zipkin.default.svc.cluster.local 的 Zipkin 服务器：

  1. apiVersion: dapr.io/v1alpha1
  2. kind: Configuration
  3. metadata:
  4.   name: tracing
  5.   namespace: default
  6. spec:
  7.   tracing:
  8.     samplingRate: "1"
  9.     zipkin:
  10.       endpointAddress: "http://zipkin.default.svc.cluster.local:9411/api/v2/spans"

Note: Changing samplingRate to 0 disables tracing altogether.

关于如何在本地环境和 Kubernetes 环境中配置追踪的更多细节，请参阅 参考文档 部分。

参考文档

Last modified January 1, 0001