mirror of https://github.com/istio/istio.io.git
trans distributed-tracing/lightstep (#6091)
* trans distributed-tracing/lightstep * fix lint err and review issues in trans distributed-tracing/lightstep
This commit is contained in:
helight
Istio Automation
parent
dc03d58f14
commit
3ec84ea4da
|
|
@ -1,37 +1,34 @@
|
|||
---
|
||||
title: LightStep
|
||||
description: How to configure the proxies to send tracing requests to LightStep.
|
||||
description: 怎样配置代理才能把追踪请求发送到 LightStep。
|
||||
weight: 11
|
||||
keywords: [telemetry,tracing,lightstep]
|
||||
aliases:
|
||||
- /zh/docs/tasks/telemetry/distributed-tracing/lightstep/
|
||||
---
|
||||
|
||||
This task shows you how to configure Istio to collect trace spans and send them to [LightStep Tracing](https://lightstep.com/products/) or [LightStep [𝑥]PM](https://lightstep.com/products/).
|
||||
LightStep lets you analyze 100% of unsampled transaction data from large-scale production software to produce meaningful
|
||||
distributed traces and metrics that help explain performance behaviors and accelerate root cause analysis.
|
||||
At the end of this task, Istio sends trace spans from the proxies to a LightStep Satellite pool making them
|
||||
available to the web UI.
|
||||
此任务介绍如何配置 Istio 才能收集追踪 span ， 并且把收集到的 span 发送到 [LightStep Tracing](https://lightstep.com/products/) 或 [LightStep [𝑥]PM](https://lightstep.com/products/)。
|
||||
LightStep 可以分析来自大规模生产级软件的 100% 未采样的事务数据，并做出容易理解的的分布式追踪和指标信息，这有助于解释性能行为和并加速根因分析。
|
||||
在此任务的结尾，Istio 将追踪 span 从代理发送到 LightStep Satellite 池，以让它们在 web UI 上展示。
|
||||
|
||||
This task uses the [Bookinfo](/zh/docs/examples/bookinfo/) sample application as an example.
|
||||
此任务使用 [Bookinfo](/zh/docs/examples/bookinfo/) 的样例代码作为示例。
|
||||
|
||||
## Before you begin
|
||||
## 开始之前{#before-you-begin}
|
||||
|
||||
1. Ensure you have a LightStep account. [Sign up](https://lightstep.com/products/tracing/) for a free trial of LightStep Tracing, or [Contact LightStep](https://lightstep.com/contact/) to create an enterprise-level LightStep [𝑥]PM account.
|
||||
1. 确保你有一个 LightStep 账户。这里可以免费[注册](https://lightstep.com/products/tracing/)试用 LightStep Tracing，或者[联系 LightStep](https://lightstep.com/contact/) 创建企业级的 LightStep [𝑥]PM 账户。
|
||||
|
||||
1. For [𝑥]PM users, ensure you have a satellite pool configured with TLS certs and a secure GRPC port exposed. See
|
||||
[LightStep Satellite Setup](https://docs.lightstep.com/docs/satellite-setup) for details about setting up satellites.
|
||||
1. 对于 [𝑥]PM 用户，确保你已有 satellite 池并且配置了 TLS 证书和一个暴露出来的安全 GRPC 端口。这里[配置 LightStep Satellite](https://docs.lightstep.com/docs/satellite-setup) 有配置 satellite 的详细说明。
|
||||
|
||||
For LightStep Tracing users, your satellites are already configured.
|
||||
对于 LightStep Tracing 的用户，你的 satellites 是已经配置好的。
|
||||
|
||||
1. Ensure sure you have a LightStep [access token](https://docs.lightstep.com/docs/project-access-tokens).
|
||||
1. 确保你有 LightStep 的[访问令牌](https://docs.lightstep.com/docs/project-access-tokens)。
|
||||
|
||||
1. You'll need to deploy Istio with your satellite address.
|
||||
For [𝑥]PM users, ensure you can reach the satellite pool at an address in the format `<Host>:<Port>`, for example `lightstep-satellite.lightstep:9292`.
|
||||
1. 需要使用你的 satellite 地址来部署 Istio。
|
||||
对于 [𝑥]PM 用户，确保你可以使用 `<Host>:<Port>` 格式的地址访问 satellite 池，例如 `lightstep-satellite.lightstep:9292`。
|
||||
|
||||
For LightStep Tracing users, use the address `collector-grpc.lightstep.com:443`.
|
||||
对于 LightStep Tracing 的用户，使用这个地址 `collector-grpc.lightstep.com:443`。
|
||||
|
||||
1. Deploy Istio with the following configuration parameters specified:
|
||||
1. 使用以下指定的配置参数部署 Istio：
|
||||
- `pilot.traceSampling=100`
|
||||
- `global.proxy.tracer="lightstep"`
|
||||
- `global.tracer.lightstep.address="<satellite-address>"`
|
||||
|
|
@ -39,8 +36,7 @@ This task uses the [Bookinfo](/zh/docs/examples/bookinfo/) sample application as
|
|||
- `global.tracer.lightstep.secure=true`
|
||||
- `global.tracer.lightstep.cacertPath="/etc/lightstep/cacert.pem"`
|
||||
|
||||
You can set these parameters using the `--set key=value` syntax
|
||||
when you run the install command. For example:
|
||||
当执行安装命令时，可以使用 `--set key=value` 语法来配置这些参数，例如：
|
||||
|
||||
{{< text bash >}}
|
||||
$ istioctl manifest apply \
|
||||
|
|
@ -52,9 +48,9 @@ This task uses the [Bookinfo](/zh/docs/examples/bookinfo/) sample application as
|
|||
--set values.global.tracer.lightstep.cacertPath="/etc/lightstep/cacert.pem"
|
||||
{{< /text >}}
|
||||
|
||||
1. Store your satellite pool's certificate authority certificate as a secret in the default namespace.
|
||||
For LightStep Tracing users, download and use [this certificate](https://docs.lightstep.com/docs/use-istio-as-your-service-mesh-with-lightstep).
|
||||
If you deploy the Bookinfo application in a different namespace, create the secret in that namespace instead.
|
||||
1. 把 satellite 池证书颁发机构发的证书作为一个密钥存储在默认的命名空间下。
|
||||
对于 LightStep Tracing 用户，要在这里下载并使用[这个证书](https://docs.lightstep.com/docs/use-istio-as-your-service-mesh-with-lightstep)。
|
||||
如果你把 Bookinfo 应用程序部署在了其它的命名空间下，就要在对的应命名空间下创建相应的密钥证书。
|
||||
|
||||
{{< text bash >}}
|
||||
$ CACERT=$(cat Cert_Auth.crt | base64) # Cert_Auth.crt contains the necessary CACert
|
||||
|
|
@ -76,66 +72,56 @@ This task uses the [Bookinfo](/zh/docs/examples/bookinfo/) sample application as
|
|||
EOF
|
||||
{{< /text >}}
|
||||
|
||||
1. Follow the [instructions to deploy the Bookinfo sample application](/zh/docs/examples/bookinfo/#deploying-the-application).
|
||||
1. 按照[部署 Bookinfo 示例应用程序说明](/zh/docs/examples/bookinfo/#deploying-the-application)操作。
|
||||
|
||||
## Visualize trace data
|
||||
## 可视化追踪数据{#visualize-trace-data}
|
||||
|
||||
1. Follow the [instructions to create an ingress gateway for the Bookinfo application](/zh/docs/examples/bookinfo/#determine-the-ingress-IP-and-port).
|
||||
1. 按照[为 Bookinfo 应用程序创建 ingress 网关说明](/zh/docs/examples/bookinfo/#determine-the-ingress-IP-and-port)操作。
|
||||
|
||||
1. To verify the previous step's success, confirm that you set `GATEWAY_URL` environment variable in your shell.
|
||||
1. 为了验证上一步是否成功，请确认你在 shell 的环境变量中中设置了 `GATEWAY_URL` 。
|
||||
|
||||
1. Send traffic to the sample application.
|
||||
1. 发送流量到示例应用程序。
|
||||
|
||||
{{< text bash >}}
|
||||
$ curl http://$GATEWAY_URL/productpage
|
||||
{{< /text >}}
|
||||
|
||||
1. Load the LightStep [web UI](https://app.lightstep.com/).
|
||||
1. 打开 LightStep [web UI](https://app.lightstep.com/)。
|
||||
|
||||
1. Navigate to Explorer.
|
||||
1. 导航到 Explorer 。
|
||||
|
||||
1. Find the query bar at the top. The query bar allows you to interactively filter results by a **Service**, **Operation**, and **Tag** values.
|
||||
1. 在顶部找到查询栏，在这里你可以用 **Service** 、**Operation** 和 **Tag** 的值进行过滤查询。
|
||||
|
||||
1. Select `productpage.default` from the **Service** drop-down list.
|
||||
1. 从 **Service** 下拉列表中选择 `productpage.default`。
|
||||
|
||||
1. Click **Run**. You see something similar to the following:
|
||||
1. 点击 **Run** 。可以看到如下类似的内容：
|
||||
|
||||
{{< image link="./istio-tracing-list-lightstep.png" caption="Explorer" >}}
|
||||
|
||||
1. Click on the first row in the table of example traces below the latency histogram to see the details
|
||||
corresponding to your refresh of the `/productpage`. The page then looks similar to:
|
||||
1. 在延迟直方图下面点击示例追踪表格的第一行，就可以查看 `/productpage` 刷新后的详细信息。该页面类似下面：
|
||||
|
||||
{{< image link="./istio-tracing-details-lightstep.png" caption="Detailed Trace View" >}}
|
||||
|
||||
The screenshot shows that the trace is comprised of a set of spans. Each span corresponds to a Bookinfo service invoked
|
||||
during the execution of a `/productpage` request.
|
||||
这个截图显示了该追踪是由一组 span 组成。每一个 span 对应着在执行 `/productpage` 请求期间调用的一个 Bookinfo 服务。
|
||||
|
||||
Two spans in the trace represent every RPC. For example, the call from `productpage` to `reviews` starts
|
||||
with the span labeled with the `reviews.default.svc.cluster.local:9080/*` operation and the
|
||||
`productpage.default: proxy client` service. This service represents the client-side span of the call. The screenshot shows
|
||||
that the call took 15.30 ms. The second span is labeled with the `reviews.default.svc.cluster.local:9080/*` operation
|
||||
and the `reviews.default: proxy server` service. The second span is a child of the first span and represents the
|
||||
server-side span of the call. The screenshot shows that the call took 14.60 ms.
|
||||
追踪中的两个 spans 表示一个 RPC请求。例如，从 `productpage` 到 `reviews` 的请求调用，以操作标签 `reviews.default.svc.cluster.local:9080/*` 和服务标签 `productpage.default: proxy client` 的 span 开始。该服务表示是这个调用的客户端 span。截图显示此次调用耗时 15.30 毫秒。第二个 span 标记有操作标签 `reviews.default.svc.cluster.local:9080/*` 操作和服务标签 `reviews.default: proxy server` 。第二个 span 是第一个 span 的下一级，表示调用的服务端 span。截图显示此次调用耗时 14.60 毫秒。
|
||||
|
||||
{{< warning >}}
|
||||
The LightStep integration does not currently capture spans generated by Istio's internal operation components such as Mixer.
|
||||
集成后的 LightStep 当前无法捕获由 Istio 的内部操作组件（如 Mixer）生成的 span。
|
||||
{{< /warning >}}
|
||||
|
||||
## Trace sampling
|
||||
## 追踪采样{#trace-sampling}
|
||||
|
||||
Istio captures traces at a configurable trace sampling percentage. To learn how to modify the trace sampling percentage,
|
||||
visit the [Distributed Tracing trace sampling section](../overview/#trace-sampling).
|
||||
When using LightStep, we do not recommend reducing the trace sampling percentage below 100%. To handle a high traffic mesh,
|
||||
consider scaling up the size of your satellite pool.
|
||||
Istio 通过配置追踪采样百分比来捕获追踪信息。想了解如何修改追踪采样百分比，请访问[分布式追踪追踪采样部分](../overview/#trace-sampling)。
|
||||
使用 LightStep 时，我们不建议将追踪采样的百分比降低到 100% 以下。要处理高流量的网格，请考虑扩大您的 satellite 池的大小。
|
||||
|
||||
## Cleanup
|
||||
## 清除{#cleanup}
|
||||
|
||||
If you are not planning any follow-up tasks, remove the Bookinfo sample application and any LightStep secrets
|
||||
from your cluster.
|
||||
如果你不想继续执测试操作任务，可以从集群中删除 Bookinfo 示例应用程序和所有的 LightStep 密钥。
|
||||
|
||||
1. To remove the Bookinfo application, refer to the [Bookinfo cleanup](/zh/docs/examples/bookinfo/#cleanup) instructions.
|
||||
1. 删除 Bookinfo 应用程序，请参阅[清除 Bookinfo](/zh/docs/examples/bookinfo/#cleanup)说明。
|
||||
|
||||
1. Remove the secret generated for LightStep:
|
||||
1. 删除给 LightStep 生成的密钥：
|
||||
|
||||
{{< text bash >}}
|
||||
$ kubectl delete secret lightstep.cacert
|
||||
|
|
|
|||
Loading…
Reference in New Issue