Zipkin 追蹤器 (proto)

config.trace.v3.ZipkinConfig

[config.trace.v3.ZipkinConfig proto]

Zipkin 追蹤器的組態。

此擴充功能的完整名稱為 envoy.tracers.zipkin

注意

此擴充功能旨在針對不受信任的下游流量具有穩健性。它假設上游是受信任的。

提示

此擴充功能會擴展下列擴充功能類別，並可與之搭配使用

envoy.tracers

此擴充功能必須使用下列類型網址之一進行組態

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: (字串, 必要) 託管 Zipkin 收集器的叢集管理員叢集。

collector_endpoint: (字串, 必要) 將傳送 span 的 Zipkin 服務的 API 端點。使用標準 Zipkin 安裝時。

trace_id_128bit: (布林值) 決定在建立新的追蹤執行個體時是否使用 128 位元追蹤 ID。預設值為 false，這將導致使用 64 位元追蹤 ID。

shared_span_context: (布林值) 決定用戶端和伺服器 span 是否共用相同的 span 內容。預設值為 true。

collector_endpoint_version: (config.trace.v3.ZipkinConfig.CollectorEndpointVersion) 決定選定的收集器端點版本。

collector_hostname: (字串) 將 span 傳送至 collector_cluster 時要使用的選用主機名稱。適用於需要特定主機名稱的收集器。預設為上方的 collector_cluster。

split_spans_for_request

(布林值) 如果設定為 true，則 Envoy 會被視為追蹤鏈中的獨立躍點。將為單一請求建立完整的 span 配對。將為下游請求建立伺服器 span，並為相關的上游請求建立用戶端 span。在下列情況下，應將其設定為 true

Envoy Proxy 用作閘道或入口。
Envoy Proxy 用作 Sidecar，但停用了輸入流量擷取或輸出流量擷取。
任何將路由器的 start_child_span 設定為 true 的情況。

注意

如果設定為 true，則路由器的 start_child_span 也應設定為 true，以確保追蹤鏈的正確性。

此欄位和 start_child_span 都已由 spawn_upstream_span 取代。請使用 spawn_upstream_span 欄位來控制 span 建立。

列舉 config.trace.v3.ZipkinConfig.CollectorEndpointVersion

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

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

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

HTTP_JSON: ⁣Zipkin API v2，JSON over HTTP。

HTTP_PROTO: ⁣Zipkin API v2，protobuf over HTTP。