Zipkin 追踪器 (proto)

config.trace.v3.ZipkinConfig

[config.trace.v3.ZipkinConfig proto]

Zipkin 追踪器的配置。

此扩展的限定名称为 envoy.tracers.zipkin

注意

此扩展旨在针对不可信的下游流量具有鲁棒性。它假定上游是可信的。

提示

此扩展扩展了以下扩展类别，并可与之一起使用

envoy.tracers

此扩展必须使用以下类型 URL 之一进行配置

type.googleapis.com/envoy.config.trace.v3.ZipkinConfig

{
  "collector_cluster": ...,
  "collector_endpoint": ...,
  "trace_id_128bit": ...,
  "shared_span_context": {...},
  "collector_endpoint_version": ...,
  "collector_hostname": ...,
  "split_spans_for_request": ...
}

collector_cluster: (string, REQUIRED) 承载 Zipkin 收集器的集群管理器集群。

collector_endpoint: (string, REQUIRED) Zipkin 服务的 API 端点，跨度将发送到该端点。在使用标准 Zipkin 安装时。

trace_id_128bit: (bool) 确定在创建新的跟踪实例时是否将使用 128 位跟踪 ID。默认值为 false，这将导致使用 64 位跟踪 ID。

shared_span_context: (BoolValue) 确定客户端和服务器跨度是否共享相同的跨度上下文。默认值为 true。

collector_endpoint_version: (config.trace.v3.ZipkinConfig.CollectorEndpointVersion) 确定所选的收集器端点版本。

collector_hostname: (string) 将跨度发送到 collector_cluster 时使用的可选主机名。对于需要特定主机名的收集器很有用。默认为 collector_cluster 以上。

split_spans_for_request

(bool) 如果将其设置为 true，则 Envoy 将被视为跟踪链中的独立跃点。将为单个请求创建一对完整的跨度。服务器跨度将为下游请求创建，客户端跨度将为相关的上游请求创建。在以下情况下，应将其设置为 true

Envoy 代理用作网关或入口。
Envoy 代理用作 sidecar，但入站流量捕获或出站流量捕获已禁用。
任何情况下路由器的 start_child_span 设置为 true。

注意

如果将其设置为 true，则路由器的 start_child_span 也应设置为 true，以确保跟踪链的正确性。

此字段和 start_child_span 都已过时，取而代之的是 spawn_upstream_span。请使用该 spawn_upstream_span 字段来控制跨度创建。

枚举 config.trace.v3.ZipkinConfig.CollectorEndpointVersion

[config.trace.v3.ZipkinConfig.CollectorEndpointVersion proto]

可用的 Zipkin 收集器端点版本。

DEPRECATED_AND_UNAVAILABLE_DO_NOT_USE: (DEFAULT) ⁣Zipkin API v1，JSON over HTTP。

HTTP_JSON: ⁣Zipkin API v2，JSON over HTTP。

HTTP_PROTO: ⁣Zipkin API v2，protobuf over HTTP。