zh-translation:/docs/tasks/observability/metrics/using-istio-dashboard/index.md (#5401)

* zh-trans-1317

* update zh-trans-1317

* fix zh-trans-1317 anchor
This commit is contained in:
Gao Jiangmiao 2019-11-08 11:43:51 +08:00 committed by Istio Automation
parent 966d016b28
commit 2756add0ac
1 changed files with 46 additions and 68 deletions

View File

@ -1,30 +1,27 @@
---
title: Visualizing Metrics with Grafana
description: This task shows you how to setup and use the Istio Dashboard to monitor mesh traffic.
title: 使用 Grafana 可视化指标
description: 此任务展示了如何设置和使用 Istio Dashboard 监控网格流量。
weight: 40
keywords: [telemetry,visualization]
aliases:
- /docs/tasks/telemetry/using-istio-dashboard/
- /docs/tasks/telemetry/metrics/using-istio-dashboard/
- /zh/docs/tasks/telemetry/using-istio-dashboard/
- /zh/docs/tasks/telemetry/metrics/using-istio-dashboard/
---
This task shows you how to setup and use the Istio Dashboard to monitor mesh
traffic. As part of this task, you will use the Grafana Istio add-on and
the web-based interface for viewing service mesh traffic data.
此任务展示了如何设置和使用 Istio Dashboard 监控网格流量。作为此任务的一部分,您将使用 Grafana 的 Istio 附加组件和基于 Web 的界面来查看服务网格流量数据。
The [Bookinfo](/docs/examples/bookinfo/) sample application is used as
the example application throughout this task.
[Bookinfo](/zh/docs/examples/bookinfo/) 应用被用作贯穿此任务始终的示例应用程序。
## Before you begin
## 在开始之前{#before-you-begin}
* [Install Istio](/docs/setup) in your cluster. If not enabled in your chosen configuration profile, enable the Grafana add-on `--set values.grafana.enabled=true` [option](/docs/reference/config/installation-options/).
* Deploy [Bookinfo](/docs/examples/bookinfo/) application.
* 在集群中[安装 Istio](/zh/docs/setup)。如果在您选择的配置文件中未启用 Grafana 附加组件,您可以通过 `--set values.grafana.enabled=true` [选项](/zh/docs/reference/config/installation-options/) 启用。
* 部署 [Bookinfo](/zh/docs/examples/bookinfo/) 应用。
## Viewing the Istio Dashboard
## 查看 Istio Dashboard{#viewing-the-Istio-dashboard}
1. Verify that the `prometheus` service is running in your cluster.
1. 验证 `prometheus` 服务正在集群中运行。
In Kubernetes environments, execute the following command:
在 Kubernetes 环境中,执行以下命令:
{{< text bash >}}
$ kubectl -n istio-system get svc prometheus
@ -32,9 +29,9 @@ the example application throughout this task.
prometheus 10.59.241.54 <none> 9090/TCP 2m
{{< /text >}}
1. Verify that the Grafana service is running in your cluster.
1. 验证 Grafana 服务正在集群中运行。
In Kubernetes environments, execute the following command:
在 Kubernetes 环境中,执行以下命令:
{{< text bash >}}
$ kubectl -n istio-system get svc grafana
@ -42,102 +39,83 @@ the example application throughout this task.
grafana 10.59.247.103 <none> 3000/TCP 2m
{{< /text >}}
1. Open the Istio Dashboard via the Grafana UI.
1. 通过 Grafana UI 打开 Istio Dashboard。
In Kubernetes environments, execute the following command:
在 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 >}}
Visit [http://localhost:3000/dashboard/db/istio-mesh-dashboard](http://localhost:3000/dashboard/db/istio-mesh-dashboard) in your web browser.
在浏览器中访问 [http://localhost:3000/dashboard/db/istio-mesh-dashboard](http://localhost:3000/dashboard/db/istio-mesh-dashboard)
The Istio Dashboard will look similar to:
Istio Dashboard 看上去类似于:
{{< image link="./grafana-istio-dashboard.png" caption="Istio Dashboard" >}}
1. Send traffic to the mesh.
1. 发送流量到网格。
For the Bookinfo sample, visit `http://$GATEWAY_URL/productpage` in your web
browser or issue the following command:
对于 Bookinfo 示例,在浏览器中访问 `http://$GATEWAY_URL/productpage` 或者发出以下命令:
{{< text bash >}}
$ curl http://$GATEWAY_URL/productpage
{{< /text >}}
{{< tip >}}
`$GATEWAY_URL` is the value set in the [Bookinfo](/docs/examples/bookinfo/) example.
`$GATEWAY_URL` 是在 [Bookinfo](/zh/docs/examples/bookinfo/) 示例中设置的值。
{{< /tip >}}
Refresh the page a few times (or send the command a few times) to generate a
small amount of traffic.
刷新页面几次(或发送命令几次)以产生少量流量。
Look at the Istio Dashboard again. It should reflect the traffic that was
generated. It will look similar to:
再次查看 Istio Dashboard。它应该反映所产生的流量。看起来类似于
{{< image link="./dashboard-with-traffic.png" caption="Istio Dashboard With Traffic" >}}
{{< image link="./dashboard-with-traffic.png" caption="Istio 流量仪表盘" >}}
This gives the global view of the Mesh along with services and workloads in the mesh.
You can get more details about services and workloads by navigating to their specific dashboards as explained below.
这提供了网格以及网格中的服务和工作负载的全局视图。可以通过导航到特定的仪表盘来获取更多关于服务和工作负载的详细信息,如下所述。
1. Visualize Service Dashboards.
1. 可视化服务仪表盘。
From the Grafana dashboard's left hand corner navigation menu, you can navigate to Istio Service Dashboard or visit
[http://localhost:3000/dashboard/db/istio-service-dashboard](http://localhost:3000/dashboard/db/istio-service-dashboard) in your web browser.
从 Grafana 仪表盘左上角的导航菜单中,可以导航到 Istio Service Dashboard 或者在浏览器中访问
[http://localhost:3000/dashboard/db/istio-service-dashboard](http://localhost:3000/dashboard/db/istio-service-dashboard)
The Istio Service Dashboard will look similar to:
Istio Service Dashboard 看上去类似于:
{{< image link="./istio-service-dashboard.png" caption="Istio Service Dashboard" >}}
This gives details about metrics for the service and then client workloads (workloads that are calling this service)
and service workloads (workloads that are providing this service) for that service.
这里给出了服务,以及更进一步的服务的客户端工作负载(调用该服务的工作负载)和服务工作负载(提供该服务的工作负载)的详细指标。
1. Visualize Workload Dashboards.
1. 可视化工作负载仪表盘。
From the Grafana dashboard's left hand corner navigation menu, you can navigate to Istio Workload Dashboard or visit
[http://localhost:3000/dashboard/db/istio-workload-dashboard](http://localhost:3000/dashboard/db/istio-workload-dashboard) in your web browser.
从 Grafana 仪表盘左上角的导航菜单中,可以导航到 Istio Workload Dashboard 或者在浏览器中访问
[http://localhost:3000/dashboard/db/istio-workload-dashboard](http://localhost:3000/dashboard/db/istio-workload-dashboard)
The Istio Workload Dashboard will look similar to:
Istio Workload Dashboard 看上去类似于:
{{< image link="./istio-workload-dashboard.png" caption="Istio Workload Dashboard" >}}
This gives details about metrics for each workload and then inbound workloads (workloads that are sending request to
this workload) and outbound services (services to which this workload send requests) for that workload.
这里给出了每一个工作负载,以及更进一步的该工作负载的入站工作负载(将请求发送到该工作负载的工作负载)和出站服务(此工作负载向其发送请求的服务)的详细指标。
### About the Grafana add-on
### 关于 Grafana 插件{#about-the-Grafana-add-on}
The Grafana add-on is a preconfigured instance of Grafana. The base image
([`grafana/grafana:5.2.3`](https://hub.docker.com/r/grafana/grafana/)) has been
modified to start with both a Prometheus data source and the Istio Dashboard
installed. The base install files for Istio, and Mixer in particular, ship with
a default configuration of global (used for every service) metrics. The Istio
Dashboard is built to be used in conjunction with the default Istio metrics
configuration and a Prometheus backend.
Grafana 插件其实是一个 Grafana 的预配置实例。基础镜像 ([`grafana/grafana:5.2.3`](https://hub.docker.com/r/grafana/grafana/)) 已被修改为同时启动已安装的 Prometheus 数据源和 Istio Dashboard。Istio特别是 Mixer的基本安装文件附带了全局用于每个服务的指标的默认配置。Istio Dashboard 旨在与默认的 Istio 指标配置和 Prometheus 后端结合使用。
The Istio Dashboard consists of three main sections:
Istio Dashboard 包括三个主要部分:
1. A Mesh Summary View. This section provides Global Summary view of the Mesh and shows HTTP/gRPC and TCP
workloads in the Mesh.
1. 网格摘要视图这部分提供网格的全局摘要视图并显示网格中HTTP/gRPC 和 TCP的工作负载。
1. Individual Services View. This section provides metrics about requests and
responses for each individual service within the mesh (HTTP/gRPC and TCP).
This also provides metrics about client and service workloads for this service.
1. 单独的服务视图这部分提供关于网格中每个单独的HTTP/gRPC 和 TCP服务的请求和响应指标。这部分也提供关于该服务的客户端和服务工作负载的指标。
1. Individual Workloads View: This section provides metrics about requests and
responses for each individual workload within the mesh (HTTP/gRPC and TCP).
This also provides metrics about inbound workloads and outbound services for this workload.
1. 单独的工作负载视图这部分提供关于网格中每个单独的HTTP/gRPC 和 TCP工作负载的请求和响应指标。这部分也提供关于该工作负载的入站工作负载和出站服务的指标。
For more on how to create, configure, and edit dashboards, please see the
[Grafana documentation](https://docs.grafana.org/).
有关如何创建,配置和编辑仪表盘的更多信息,请参见
[Grafana 文档](https://docs.grafana.org/)。
## Cleanup
## 清除{#cleanup}
* Remove any `kubectl port-forward` processes that may be running:
* 移除任何可能正在运行的 `kubectl port-forward` 进程:
{{< text bash >}}
$ killall kubectl
{{< /text >}}
* If you are not planning to explore any follow-on tasks, refer to the
[Bookinfo cleanup](/docs/examples/bookinfo/#cleanup) instructions
to shutdown the application.
* 如果不打算探索任何后续任务,请参阅 [清除 Bookinfo](/zh/docs/examples/bookinfo/#cleanup) 的说明来关闭应用。