使用 Telemetry API 配置链路追踪
Istio 提供了配置高级链路追踪选项的功能,例如采样率和向已采集的 Span 中添加自定义标签。 本任务将向您展示如何使用 Telemetry API 自定义链路追踪选项。
开始之前
安装
在此示例中,我们将发送跟踪信息到链路追踪系统 zipkin
,请确保已安装它:
$ cat <<EOF > ./tracing.yaml
apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
spec:
meshConfig:
enableTracing: true
defaultConfig:
tracing: {} # disabled MeshConfig tracing options
extensionProviders:
# add zipkin provider
- name: zipkin
zipkin:
service: zipkin.istio-system.svc.cluster.local
port: 9411
EOF
$ istioctl install -f ./tracing.yaml --skip-confirmation
启用服务网格的链路追踪
通过以下配置启用链路追踪:
$ kubectl apply -f - <<EOF
apiVersion: telemetry.istio.io/v1alpha1
kind: Telemetry
metadata:
name: mesh-default
namespace: istio-system
spec:
tracing:
- providers:
- name: "zipkin"
EOF
自定义链路追踪采样率
采样率选项可用于控制哪些请求的百分比被采集到链路追踪系统中。 应根据服务网格中的流量和您想要收集的链路追踪数据量来配置此选项。 默认采样率为1%。
$ kubectl apply -f - <<EOF
apiVersion: telemetry.istio.io/v1alpha1
kind: Telemetry
metadata:
name: mesh-default
namespace: istio-system
spec:
tracing:
- providers:
- name: "zipkin"
randomSamplingPercentage: 100.00
EOF
自定义链路追踪标签
可以基于文本、环境变量和客户端请求标头向 spans 添加自定义标签,以在与环境相关的 spans 中提供额外的信息。
您可以使用以下三种支持的选项来自定义标签。
Literal 表示一个静态的值,会被添加到每个 span 中。
apiVersion: telemetry.istio.io/v1alpha1 kind: Telemetry metadata: name: mesh-default namespace: istio-system spec: tracing: - providers: - name: "zipkin" randomSamplingPercentage: 100.00 customTags: "provider": literal: value: "zipkin"
环境变量可以用于从工作负载代理环境中自定义标签。
apiVersion: telemetry.istio.io/v1alpha1 kind: Telemetry metadata: name: mesh-default namespace: istio-system spec: tracing: - providers: - name: "zipkin" randomSamplingPercentage: 100.00 customTags: "cluster_id": environment: name: ISTIO_META_CLUSTER_ID defaultValue: Kubernetes # optional
客户端请求头选项可用于从传入的客户端请求头中添加标签。
apiVersion: telemetry.istio.io/v1alpha1 kind: Telemetry metadata: name: mesh-default namespace: istio-system spec: tracing: - providers: - name: "zipkin" randomSamplingPercentage: 100.00 custom_tags: my_tag_header: header: name: <CLIENT-HEADER> defaultValue: <VALUE> # optional
自定义链路追踪标签长度
默认情况下,HttpUrl
的 span 标签的请求最大长度为256。要修改此最大长度,请将以下内容添加到您的 tracing.yaml
文件中。
apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
spec:
meshConfig:
enableTracing: true
defaultConfig:
tracing: {} # disabled tracing options via `MeshConfig`
extensionProviders:
# add zipkin provider
- name: zipkin
zipkin:
service: zipkin.istio-system.svc.cluster.local
port: 9411
maxTagLength: <VALUE>
验证结果
您可以使用Zipkin 界面来验证结果。