zh: sync /docs/tasks/telemetry/using-istio-dashboard/index.md (#3507)

* zh: sync /docs/tasks/telemetry/using-istio-dashboard/index.md

* Dashboards->Dashboard
This commit is contained in:
Vincent 2019-03-05 22:33:33 +08:00 committed by istio-bot
parent 2f69b2191e
commit aae54735d9
1 changed files with 52 additions and 33 deletions

View File

@ -9,24 +9,27 @@ keywords: [telemetry,visualization]
[Bookinfo](/zh/docs/examples/bookinfo/) 示例应用程序在整个任务中用作示例应用程序。
## 前提条件
## 开始之
* 在集群中[安装 Istio](/zh/docs/setup/) 并部署应用程序。
* [安装 Prometheus 附加组件](/zh/docs/tasks/telemetry/querying-metrics/)。
* 在集群中[安装 Istio](/zh/docs/setup/)。如果使用 Helm 方式进行安装,可以使用 `--set grafana.enabled=true` [开关](/zh/docs/reference/config/installation-options/)来启用 Grafana 插件。
* 部署 [Bookinfo](/zh/docs/examples/bookinfo/) 应用。
## 查看 Istio 仪表板
1. 要在图形仪表板中查看 Istio 指标,请安装 Grafana 插件
1. 验证 `prometheus` 服务是否在集群中正常运行
在 Kubernetes 环境中,执行以下命令:
如果是 Kubernetes 环境中,可以使用如下命令:
{{< text bash >}}
$ kubectl apply -f install/kubernetes/addons/grafana.yaml
$ kubectl -n istio-system get svc prometheus
NAME CLUSTER-IP EXTERNAL-IP PORT(S) AGE
prometheus 10.59.241.54 <none> 9090/TCP 2m
{{< /text >}}
1. 验证服务是否在集群中运行。
1. 验证 `grafana` 服务是否在集群中正常运行。
在 Kubernetes 环境中,执行以下命令:
如果是 Kubernetes 环境中,可以使用如下命令:
{{< text bash >}}
$ kubectl -n istio-system get svc grafana
@ -34,64 +37,80 @@ keywords: [telemetry,visualization]
grafana 10.59.247.103 <none> 3000/TCP 2m
{{< /text >}}
1. 通过 Grafana UI 打开 Istio Dashboard。
1. 打开 Grafana 界面中的 Istio Dashboard
在 Kubernetes 环境中,执行以下命令:
如果是在 Kubernetes 环境中,请执行如下命令:
{{< text bash >}}
$ kubectl -n istio-system port-forward $(kubectl -n istio-system get pod -l app=grafana -o jsonpath='{.items[0].metadata.name}') 3000:3000 &
{{< /text >}}
在 Web 浏览器中访问 [http://localhost:3000/dashboard/db/istio-dashboard](http://localhost:3000/dashboard/db/istio-dashboard)。
用浏览器浏览 [http://localhost:3000/dashboard/db/istio-mesh-dashboard](http://localhost:3000/dashboard/db/istio-mesh-dashboard)。
Istio 仪表板看起来类似于
Istio Dashboard 大致会显示如下内容
{{< image link="/docs/tasks/telemetry/using-istio-dashboard/grafana-istio-dashboard.png" caption="Istio Dashboard" >}}
{{< image link="./grafana-istio-dashboard.png" caption="Istio Dashboard" >}}
1. 将流量发送到服务网格
1. 向网格中发送流量
对于 Bookinfo 示例请在Web浏览器中访问 `http://$GATEWAY_URL/productpage` 或发出以下命令:
对于 Bookinfo 实例来说,有两种方式产生流量:用浏览器打开网址 `http://$GATEWAY_URL/productpage`;或者执行下面的命令:
{{< text bash >}}
$ curl http://$GATEWAY_URL/productpage
{{< /text >}}
{{< tip >}}
`$GATEWAY_URL` 是[Bookinfo](/zh/docs/examples/bookinfo/) 示例中设置的值
`$GATEWAY_URL` 变量的定义来自于 [Bookinfo](/zh/docs/examples/bookinfo/) 示例
{{< /tip >}}
刷新页面几次(或发送命令几次)以产生少量流量
刷新页面几次(或者执行几次命令),就会生成一些流量了
看一下 Istio Dashboard, 它应该反映生成的流量, 它看起来类似于下图所示的内容
次打开 Istio Dashboard会看到其中显示了刚刚生成的流量大致如图所示
{{< image link="/docs/tasks/telemetry/using-istio-dashboard/dashboard-with-traffic.png" caption="Istio 的流量仪表板" >}}
{{< image link="./dashboard-with-traffic.png" caption="Istio Dashboard" >}}
这里给出的是全网格范围内服务和工作负载的概况。可以浏览每个服务或工作负载,来获取特定目标的 Dashboard。下面会进行简单的介绍。
1. 可视化的服务 Dashboard。
从 Grafana Dashboard 左侧的导航菜单中打开 Istio Service Dashboard也可以直接使用浏览器打开 [http://localhost:3000/dashboard/db/istio-service-dashboard](http://localhost:3000/dashboard/db/istio-service-dashboard)。
Istio 的服务 Dashboard 大致如图所示:
{{< image link="./istio-service-dashboard.png" caption="Istio 服务 Dashboard" >}}
这里给出了指定服务的详细指标,还有该服务的客户端工作负载(正在调用这一服务的工作负载)以及服务端工作负载(提供服务的工作负载)。
1. 可视化的工作负载 Dashboard。
从 Grafana Dashboard 左侧的导航菜单中打开 Istio 工作负载 Dashboard或者用浏览器打开 [http://localhost:3000/dashboard/db/istio-workload-dashboard](http://localhost:3000/dashboard/db/istio-workload-dashboard)。
Istio 工作负载 Dashboard 大致如图所示:
{{< image link="./istio-workload-dashboard.png" caption="Istio 工作负载 Dashboard" >}}
这里展示了每个工作负载的指标数据,还有相关的入站工作负载(向本工作负载发送请求的工作负载)以及该工作负载请求的服务。
### 关于 Grafana 插件
Grafana 插件是 Grafana 的预配置实例, 基本映像([`grafana/grafana:5.2.3`](https://hub.docker.com/r/grafana/grafana/))已经修改为从安装了 Prometheus 数据源和 Istio Dashboard 开始, Istio 的基本安装文件,特别是 Mixer带有全局用于每个服务指标的默认配置, Istio Dashboard 可与默认的 Istio 指标配置和 Prometheus 后端结合使用。
Grafana 插件是一个预配置的 Grafana 实例。基于基础镜像([`grafana/grafana:5.2.3`](https://hub.docker.com/r/grafana/grafana/))进行了修改,加入了 Prometheus 数据源以及 Istio Dashboard。Istio 和 Mixer 初始化了缺省的全局用于每个服务指标。Istio Dashboard 连接了 Prometheus 后端以及缺省的 Istio 指标配置
Istio 仪表板由三个主要部分组成:
Istio Dashboard 包含三个主要部分
1. 全局摘要视图,本节提供流经服务网格的 HTTP 请求的高级摘要。
1. Mesh Summary View提供了网格范围内的全局概要视图其中还包含了网格中的 HTTP/gRPC 以及 TCP 工作负载
1. 网格摘要视图,本节提供了比全局摘要视图更多的详细信息,允许按服务过滤和选择。
1. 独立的服务视图其中包含了网格之中各个服务的请求和响应HTTP/gRPC 以及 TCP的指标数据。其中还有当前服务的上下游工作负载的指标
1. 单个服务视图本节提供有关网格中每个服务HTTP和TCP的请求和响应的度量标准。
1. 独立的工作负载视图这里包含了网格中每个工作负载的请求和响应HTTP/gRPC 以及 TCP的指标数据另外还包含了入站工作负载以及出站服务的相关指标
有关如何创建,配置和编辑仪表板的更多信息,请参阅 [Grafana文档](https://docs.grafana.org/)。
要了解如何创建、配置和编辑 Dashboard可移步浏览 [Grafana 文档](https://docs.grafana.org/)。
## 清理
* 在 Kubernetes 环境中,执行以下命令以删除 Grafana 附加组件:
{{< text bash >}}
$ kubectl delete -f install/kubernetes/addons/grafana.yaml
{{< /text >}}
* 删除可能正在运行的任何 `kubectl port-forward` 进程:
* 停止运行中的 `kubectl port-forward` 进程:
{{< text bash >}}
$ killall kubectl
{{< /text >}}
* 如果您不打算探索任何后续任务,请参阅 [Bookinfo 清理](/zh/docs/examples/bookinfo/#清理)说明以关闭应用程序
* 如果不想继续进行后续任务,参照[清理 Bookinfo](/zh/docs/examples/bookinfo/#清理)的步骤关闭示例应用。