The documentation you are viewing is for Dapr v1.7 which is an older version of Dapr. For up-to-date documentation, see the latest version.

Configure Dapr to send distributed tracing data

Configure Dapr to send distributed tracing data

It is recommended to run Dapr with tracing enabled for any production scenario. You can configure Dapr to send tracing and telemetry data to many backends based on your environment, whether it is running in the cloud or on-premises.

Tracing configuration

Configuration sepc下的 tracing 部分包含以下属性:

spec:
  tracing:
    samplingRate: "1"
    zipkin:
      endpointAddress: "https://..."

下面的表格给出了调用链追踪功能可配置的属性

属性 数据类型 说明
samplingRate string 设置采样率,可以用来控制追踪功能是否开启。
zipkin.endpointAddress string 设置 Zipkin 服务器地址。

Zipkin in self hosted mode

The following steps show you how to configure Dapr to send distributed tracing data to Zipkin running as a container on your local machine and view them.

For self hosted mode, create a Dapr configuration file locally and reference it with the Dapr CLI.

  1. Create the following config.yaml YAML file:

    apiVersion: dapr.io/v1alpha1
    kind: Configuration
    metadata:
      name: zipkin
      namespace: default
    spec:
      tracing:
        samplingRate: "1"
        zipkin:
          endpointAddress: "http://localhost:9411/api/v2/spans"
    
  2. Launch Zipkin using Docker:

    docker run -d -p 9411:9411 openzipkin/zipkin
    
  3. Launch Dapr with the --config param with the path for where the config.yaml is saved :

    dapr run --app-id mynode --app-port 3000 --config ./config.yaml node app.js
    

Zipkin in Kubernetes mode

The following steps show you how to configure Dapr to send distributed tracing data to Zipkin running as a container in your Kubernetes cluster, and how to view them.

设置

First, deploy Zipkin:

kubectl create deployment zipkin --image openzipkin/zipkin

Create a Kubernetes Service for the Zipkin pod:

kubectl expose deployment zipkin --type ClusterIP --port 9411

接下来,在本地创建以下YAML文件:

apiVersion: dapr.io/v1alpha1
kind: Configuration
metadata:
  name: zipkin
  namespace: default
spec:
  tracing:
    samplingRate: "1"
    zipkin:
      endpointAddress: "http://zipkin.default.svc.cluster.local:9411/api/v2/spans"

Finally, deploy the Dapr configuration:

kubectl apply -f config.yaml

为了启用您的 Dapr sidecar 的配置,请在您的pod spec模板中添加以下注释:

annotations:
  dapr.io/config: "zipkin"

就这么简单! Your sidecar is now configured for use with Zipkin.

查看追踪数据

To view traces, connect to the Zipkin service and open the UI:

kubectl port-forward svc/zipkin 9411:9411

On your browser, go to http://localhost:9411 and you should see the Zipkin UI.

zipkin

参考资料