mirror of https://github.com/istio/istio.io.git
[zh] Sync faq and boilerplates tracing related updates into Chinese (#15992)
* Sync faq tracing related updates into Chinese * sync start otel
This commit is contained in:
Wilson Wu
GitHub
parent
1949b91206
commit
8191992bc3
|
|
@ -1,18 +0,0 @@
|
|||
---
|
||||
title: 如何禁用追踪？
|
||||
weight: 50
|
||||
---
|
||||
|
||||
如果您已经安装了启用追踪功能的 Istio，可以通过执行如下步骤禁用它：
|
||||
|
||||
{{< text plain >}}
|
||||
# 用您的 Istio mesh 命名空间名填充下述命令中的 <istio namespace>。例如：istio-system
|
||||
TRACING_POD=`kubectl get po -n <istio namespace> | grep istio-tracing | awk '{print $1}'`
|
||||
$ kubectl delete pod $TRACING_POD -n <istio namespace>
|
||||
$ kubectl delete services tracing zipkin -n <istio namespace>
|
||||
# 现在，手动从文件中移除 trace_zipkin_url 的实例，保存文件
|
||||
{{< /text >}}
|
||||
|
||||
然后遵循[分布式追踪任务的清理部分](/zh/docs/tasks/observability/distributed-tracing/zipkin/#cleanup)的步骤进行后续操作。
|
||||
|
||||
如果您不想要追踪功能，那么就在安装 Istio 时[禁用追踪](/zh/docs/tasks/observability/distributed-tracing/zipkin/#before-you-begin)。
|
||||
|
|
@ -1,6 +0,0 @@
|
|||
---
|
||||
title: Istio 是否能发送追踪信息到外部与 Zipkin 兼容的后端？
|
||||
weight: 70
|
||||
---
|
||||
|
||||
可以这么做，但是必须用 Zipkin 兼容实例的完全合格的域名。比如：`zipkin.mynamespace.svc.cluster.local`。
|
||||
|
|
@ -6,7 +6,5 @@ weight: 0
|
|||
Istio 使用 [Envoy](#how-envoy-based-tracing-works)的分布式追踪系统集成。
|
||||
由[应用程序负责为后续传出请求转发追踪的 header 信息](#istio-copy-headers)。
|
||||
|
||||
您可以在 Istio 分布式追踪（[Jaeger](/zh/docs/tasks/observability/distributed-tracing/jaeger/)，
|
||||
[LightStep](/zh/docs/tasks/observability/distributed-tracing/lightstep/)，
|
||||
[Zipkin](/zh/docs/tasks/observability/distributed-tracing/zipkin/)）
|
||||
任务以及 [Envoy 追踪文档](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/observability/tracing)中找到更多信息。
|
||||
您可以在[分布式链路追踪概述](/zh/docs/tasks/observability/distributed-tracing/overview/)和
|
||||
[Envoy 链路追踪文档](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/observability/tracing)中找到更多信息。
|
||||
|
|
|
|||
|
|
@ -12,4 +12,7 @@ Envoy：
|
|||
- 将生成的跟踪范围发送到跟踪后端
|
||||
- 将跟踪头转发到代理的应用程序
|
||||
|
||||
Istio 支持基于 Envoy 的 [LightStep](/zh/docs/tasks/observability/distributed-tracing/lightstep/) 和 [Zipkin](/zh/docs/tasks/observability/distributed-tracing/zipkin/) 的集成，以及所有与 Zipkin API 兼容的后端，包括 [Jaeger](/zh/docs/tasks/observability/distributed-tracing/jaeger/)。
|
||||
Istio 支持 [OpenTelemetry](/zh/docs/tasks/observability/distributed-tracing/opentelemetry/)
|
||||
和兼容的后端，包括 [Jaeger](/zh/docs/tasks/observability/distributed-tracing/jaeger/)。
|
||||
其他支持的平台包括 [Zipkin](/zh/docs/tasks/observability/distributed-tracing/zipkin/)
|
||||
和 [Apache SkyWalking](/zh/docs/tasks/observability/distributed-tracing/skywalking/)。
|
||||
|
|
|
|||
|
|
@ -6,10 +6,14 @@ weight: 10
|
|||
Istio 允许报告服务网格中工作负载到工作负载间通信的追踪 Span。
|
||||
然而，为了将各种追踪 Span 整合在一起以获得完整的流量图，应用程序必须在传入和传出请求之间传播追踪上下文信息。
|
||||
|
||||
特别是，Istio 依赖于应用程序传播 [B3 追踪 Headers](https://github.com/openzipkin/b3-propagation)
|
||||
以及由 Envoy 生成的请求 ID。这些 Header 包括:
|
||||
具体来说，Istio 依靠应用程序来转发 Envoy 生成的请求 ID 和标准标头。这些标头包括：
|
||||
|
||||
- `x-request-id`
|
||||
- `traceparent`
|
||||
- `tracestate`
|
||||
|
||||
Zipkin 用户必须确保他们[传播 B3 链路追踪标头](https://github.com/openzipkin/b3-propagation)。
|
||||
|
||||
- `x-b3-traceid`
|
||||
- `x-b3-spanId`
|
||||
- `x-b3-parentspanid`
|
||||
|
|
@ -17,15 +21,5 @@ Istio 允许报告服务网格中工作负载到工作负载间通信的追踪 S
|
|||
- `x-b3-flags`
|
||||
- `b3`
|
||||
|
||||
如果使用 LightStep，您还需要转发以下 Header：
|
||||
|
||||
- `x-ot-span-context`
|
||||
|
||||
如果使用 OpenTelemetry 或者 Stackdriver，您还需要转发以下 Header：
|
||||
|
||||
- `traceparent`
|
||||
- `tracestate`
|
||||
|
||||
Header 传播可以通过客户端库完成，例如 [Zipkin](https://zipkin.io/pages/tracers_instrumentation.html)
|
||||
或 [Jaeger](https://github.com/jaegertracing/jaeger-client-java/tree/master/jaeger-core#b3-propagation)。
|
||||
当然，这也可以手动完成，正如[分布式追踪任务](/zh/docs/tasks/observability/distributed-tracing/overview#trace-context-propagation)中所描述的那样。
|
||||
标头传播可通过客户端库完成，例如 [OpenTelemetry](https://opentelemetry.io/docs/concepts/context-propagation/)。
|
||||
它也可手动完成，如[分布式链路追踪任务](/zh/docs/tasks/observability/distributed-tracing/overview/#trace-context-propagation)中所述。
|
||||
|
|
|
|||
|
|
@ -0,0 +1,7 @@
|
|||
---
|
||||
title: 什么生成了初始链路头？
|
||||
weight: 15
|
||||
---
|
||||
|
||||
如果请求中未提供初始[标头](https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_conn_man/headers#x-request-id)，
|
||||
则 Istio 网关或 Sidecar 代理 (Envoy) 会生成初始[标头](https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_conn_man/headers#x-request-id)。
|
||||
|
|
@ -1,7 +0,0 @@
|
|||
---
|
||||
title: 为什么要初始化生成 Zipkin (B3) HTTP header?
|
||||
weight: 15
|
||||
---
|
||||
|
||||
如果请求中没有 Zipkin (B3) HTTP header，Istio sidecar 代理(Envoy) 会自动生成初始化的
|
||||
[headers](https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_conn_man/headers#x-request-id)。
|
||||
|
|
@ -1,7 +0,0 @@
|
|||
---
|
||||
title: 分布式追踪所需的 Istio 最低配置是什么？
|
||||
weight: 13
|
||||
---
|
||||
|
||||
启用了追踪功能的 Istio [最低配置文件](/zh/docs/setup/install/helm/)是
|
||||
Istio 与 Zipkin 兼容后端集成所需的全部内容。
|
||||
|
|
@ -3,14 +3,13 @@ title: 为什么我的请求没有被追踪？
|
|||
weight: 30
|
||||
---
|
||||
|
||||
从 Istio 1.0.3 开始，其 `default` 追踪采样率已经降低到 1%。
|
||||
[配置文件](/zh/docs/setup/additional-setup/config-profiles/)。
|
||||
这意味着 Istio 捕获的 100 个追踪实例中只有 1 个将被报告给追踪后端。
|
||||
`demo` 文件中的采样率仍设为 100%。
|
||||
有关如何设置采样率的更多信息，可参见[本节](/zh/docs/tasks/observability/distributed-tracing/overview/#trace-sampling)。
|
||||
在 `default` [配置文件](/zh/docs/setup/additional-setup/config-profiles/)中，
|
||||
链路追踪的采样率被设置为 1%。这意味着 Istio 捕获的 100 个链路实例中只有 1 个会报告给跟踪后端。
|
||||
`demo` 配置文件中的采样率设置为 100%。有关如何设置采样率的信息，
|
||||
请参阅[本节](/zh/docs/tasks/observability/distributed-tracing/telemetry-api/#customizing-trace-sampling)。
|
||||
|
||||
如果您仍然没有看到任何追踪数据，请确认您的端口是否符合 Istio [端口命名规范](/zh/faq/traffic-management/#naming-port-convention)，
|
||||
并公开适当的容器端口（例如，通过 pod spec）来启用 sidecar 代理（Envoy）能够对流量进行捕获。
|
||||
|
||||
如果您仅看到与出口代理相关联的跟踪数据，但没有看到与入口代理相关联的，那么它可能仍与 Istio [端口命名规范](/zh/faq/traffic-management/#naming-port-convention)相关。
|
||||
请先了解 [Istio 1.3](/zh/news/releases/1.3.x/announcing-1.3/#intelligent-protocol-detection-experimental) 中自动检测**出口**流量的协议相关部分。
|
||||
如果您只看到与出口代理相关的链路数据，而没有看到入口代理，
|
||||
则可能仍与 Istio [端口命名约定](/zh/about/faq/#naming-port-convention)有关。
|
||||
|
|
|
|||
|
|
@ -1,15 +1,15 @@
|
|||
---
|
||||
---
|
||||
* 为 OpenTelemetry Collector 创建命名空间：
|
||||
为 OpenTelemetry Collector 创建命名空间：
|
||||
|
||||
{{< text bash >}}
|
||||
$ kubectl apply -f @samples/open-telemetry/otel.yaml@ -n istio-system
|
||||
$ kubectl create namespace observability
|
||||
{{< /text >}}
|
||||
{{< text bash >}}
|
||||
$ kubectl apply -f @samples/open-telemetry/otel.yaml@ -n istio-system
|
||||
$ kubectl create namespace observability
|
||||
{{< /text >}}
|
||||
|
||||
* 部署 OpenTelemetry Collector。您可以使用此示例配置作为起点：
|
||||
[`otel.yaml`]({{< github_blob >}}/samples/open-telemetry/otel.yaml)
|
||||
部署 OpenTelemetry Collector。
|
||||
您可以使用[此示例配置]({{< github_blob >}}/samples/open-telemetry/otel.yaml)作为起点。
|
||||
|
||||
{{< text bash >}}
|
||||
$ kubectl apply -f @samples/open-telemetry/otel.yaml@ -n observability
|
||||
{{< /text >}}
|
||||
{{< text bash >}}
|
||||
$ kubectl apply -f @samples/open-telemetry/otel.yaml@ -n observability
|
||||
{{< /text >}}
|
||||
|
|
|
|||
Loading…
Reference in New Issue