概述

    Istio 利用 Envoy 的分布式追踪功能提供了开箱即用的追踪集成。确切地说，Istio 提供了安装各种追踪后端服务的选项，并且通过配置代理来自动发送追踪 Span 到分布式追踪系统服务。 请参阅 、Jaeger、 和 OpenCensus Agent 的任务文档来了解 Istio 如何与这些分布式追踪系统一起工作。

    尽管 Istio 代理能够自动发送 Span，但需要一些附加信息才能将这些 Span 加到同一个调用链。 所以当代理发送 Span 信息的时候，应用程序需要附加适当的 HTTP 请求头信息，这样才能够把多个 Span 加到同一个调用链。

    要做到这一点，每个应用程序必须从每个传入的请求中收集请求头，并将这些请求头转发到传入请求所触发的所有传出请求。 具体选择转发哪些请求头取决于所配置的跟踪后端。要转发到请求头的设置在每个追踪系统特定的任务页面进行说明。 以下是一个汇总：

    • ：这是 Envoy 专用的请求头，用于对日志和追踪进行一致的采样。

    对于 Zipkin、Jaeger、Stackdriver 和 OpenCensus Agent，应转发 B3 多请求头格式：

    • x-b3-traceid
    • x-b3-spanid
    • x-b3-parentspanid
    • x-b3-sampled

    这些是 Zipkin、Jaeger、OpenCensus 和许多其他工具支持的请求头。

    对于 Datadog，应转发以下请求头。对于许多语言和框架而言，这些转发由 Datadog 客户端库自动处理。

    • x-datadog-trace-id
    • x-datadog-sampling-priority
    • x-ot-span-context

    对于 Stackdriver 和 OpenCensus Agent，您可以使用以下任一请求头来替代 B3 多请求头格式。

    • grpc-trace-bin：标准的 grpc 追踪头。
    • traceparent：追踪所用的 W3C 追踪上下文标准。受所有 OpenCensus、OpenTelemetry 和日益增加的 Jaeger 客户端库所支持。

    例如，如果您看 Python 的 productpage 服务这个例子，可以看到这个应用程序使用了 OpenTracing 库从 HTTP 请求中提取所需的头信息：

    在 Review 这个应用中（Java）使用 做了类似的事情：

    1. @GET
    2. @Path("/reviews/{productId}")
    3. public Response bookReviewsById(@PathParam("productId") int productId, @Context HttpHeaders requestHeaders) {
    5.   // ...
    7.     JsonObject ratingsResponse = getRatings(Integer.toString(productId), requestHeaders);

    当您在应用程序中进行下游调用时，请确保包含这些请求头。