mirror of https://github.com/istio/istio.io.git
[zh] Sync /reference/config/metrics/ (#14426)
* [zh] Sync /reference/config/metrics/ * apply suggestions from wilsonwu
This commit is contained in:
Michael
GitHub
parent
e68e243e24
commit
dd5050931f
|
|
@ -2,84 +2,104 @@
|
|||
title: Istio 标准指标
|
||||
description: 通过 Istio 遥测导出的 Istio 标准指标。
|
||||
weight: 50
|
||||
keywords: [telemetry,metrics]
|
||||
owner: istio/wg-user-experience-maintainers
|
||||
test: n/a
|
||||
aliases:
|
||||
- /zh/docs/reference/config/telemetry/metrics/
|
||||
---
|
||||
|
||||
以下是 Istio 导出的标准服务级别指标。
|
||||
|
||||
遥测组件作为一个 [Proxy 扩展](https://github.com/istio/proxy/tree/master/source/extensions/filters/http/istio_stats) 被实现。
|
||||
遥测组件作为一个
|
||||
[Proxy 扩展](https://github.com/istio/proxy/tree/master/source/extensions/filters/http/istio_stats)被实现。
|
||||
`COUNTER` 是一个严格递增的整数。
|
||||
`DISTRIBUTION` 将数值的范围映射到频率。
|
||||
`COUNTER` 和 `DISTRIBUTION` 在 [Envoy 文档](https://github.com/envoyproxy/envoy/blob/main/source/docs/stats.md)中对应于指标计数器和直方图。
|
||||
`DISTRIBUTION` 将数值的范围映射到频率。`COUNTER` 和 `DISTRIBUTION` 在
|
||||
[Envoy 文档](https://github.com/envoyproxy/envoy/blob/main/source/docs/stats.md)中对应于指标计数器和直方图。
|
||||
|
||||
## 指标 {#metrics}
|
||||
|
||||
对于 HTTP，HTTP/2 和 GRPC 通信，Istio 生成以下指标：
|
||||
对于 HTTP、HTTP/2 和 gRPC 通信，Istio 生成以下指标：
|
||||
|
||||
指标类型可参考：[Prometheus 指标类型](https://prometheus.io/docs/concepts/metric_types/)
|
||||
* **请求数** (`istio_requests_total`)：这是一个 `COUNTER` 类型的指标，
|
||||
用于记录 Istio 代理处理的总请求数。
|
||||
|
||||
* **请求数** (`istio_requests_total`)： 这都是一个 `COUNTER` 类型的指标，用于记录 Istio 代理处理的总请求数。
|
||||
* **请求时长** (`istio_request_duration_milliseconds`)：这是一个 `DISTRIBUTION`
|
||||
类型的指标，用于测量请求的持续时间。
|
||||
|
||||
* **请求时长** (`istio_request_duration_milliseconds`)： 这是一个 `DISTRIBUTION` 类型的指标，用于测量请求的持续时间。
|
||||
* **请求体大小** (`istio_request_bytes`)：这是一个 `DISTRIBUTION` 类型的指标，
|
||||
用来测量 HTTP 请求主体大小。
|
||||
|
||||
* **请求体大小** (`istio_request_bytes`)： 这是一个 `DISTRIBUTION` 类型的指标，用来测量 HTTP 请求主体大小。
|
||||
* **响应体大小** (`istio_response_bytes`)：这是一个 `DISTRIBUTION` 类型的指标，
|
||||
用来测量 HTTP 响应主体大小。
|
||||
|
||||
* **响应体大小** (`istio_response_bytes`)： 这是一个 `DISTRIBUTION` 类型的指标，用来测量 HTTP 响应主体大小。
|
||||
* **gRPC 请求消息数** (`istio_request_messages_total`)：这是一个 `COUNTER`
|
||||
类型的指标，用于记录从客户端发送的 gRPC 消息总数。
|
||||
|
||||
* **gRPC 请求消息数** (`istio_request_messages_total`)： 这是一个 `COUNTER` 类型的指标，用于记录从客户端发送的 gRPC 消息总数。
|
||||
|
||||
* **gRPC 响应消息数** (`istio_response_messages_total`)： 这是一个 `COUNTER` 类型的指标，用于记录从服务端发送的 gRPC 消息总数。
|
||||
* **gRPC 响应消息数** (`istio_response_messages_total`)：这是一个 `COUNTER`
|
||||
类型的指标，用于记录从服务端发送的 gRPC 消息总数。
|
||||
|
||||
对于 TCP 流量，Istio 生成以下指标：
|
||||
|
||||
* **TCP 发送字节大小** (`istio_tcp_sent_bytes_total`)： 这是一个 `COUNTER` 类型的指标，用于测量在 TCP 连接情况下响应期间发送的总字节数。
|
||||
* **TCP 发送字节数** (`istio_tcp_sent_bytes_total`)：这是一个 `COUNTER`
|
||||
类型的指标，用于测量在 TCP 连接情况下响应期间发送的总字节数。
|
||||
|
||||
* **TCP 接收字节大小** (`istio_tcp_received_bytes_total`)： 这是一个 `COUNTER` 类型的指标，用于测量在 TCP 连接情况下请求期间接收到的总字节数。
|
||||
* **TCP 接收字节数** (`istio_tcp_received_bytes_total`)：这是一个 `COUNTER`
|
||||
类型的指标，用于测量在 TCP 连接情况下请求期间接收到的总字节数。
|
||||
|
||||
* **TCP 已打开连接数** (`istio_tcp_connections_opened_total`)： 这是一个 `COUNTER` 类型的指标，用于记录 TCP 已打开的连接总数。
|
||||
* **TCP 已打开连接数** (`istio_tcp_connections_opened_total`)：这是一个 `COUNTER`
|
||||
类型的指标，用于记录 TCP 已打开的连接总数。
|
||||
|
||||
* **TCP 已关闭连接数** (`istio_tcp_connections_closed_total`)： 这是一个 `COUNTER` 类型的指标，用于记录 TCP 已关闭的连接总数。
|
||||
* **TCP 已关闭连接数** (`istio_tcp_connections_closed_total`)：这是一个 `COUNTER`
|
||||
类型的指标，用于记录 TCP 已关闭的连接总数。
|
||||
|
||||
## 标签{#label}
|
||||
## 标签 {#label}
|
||||
|
||||
* **Reporter**： 标识请求指标的上报端。如果指标由服务端 Istio 代理上报，则设置为 `destination`，如果指标由客户端 Istio 代理或网关上报，则设置为 `source`。
|
||||
* **Reporter**：标识请求指标的上报端。如果指标由服务端 Istio 代理上报，则设置为
|
||||
`destination`，如果指标由客户端 Istio 代理或网关上报，则设置为 `source`。
|
||||
|
||||
* **Source Workload**：标识源工作负载的名称，如果缺少源信息，则标识为 `unknown`。
|
||||
* **Source Workload**：标识源工作负载的名称，如果缺少源信息，则标识为 `unknown`。
|
||||
|
||||
* **Source Workload Namespace**：标识源工作负载的命名空间，如果缺少源信息，则标识为 `unknown`。
|
||||
* **Source Workload Namespace**：标识源工作负载的命名空间，如果缺少源信息，则标识为 `unknown`。
|
||||
|
||||
* **Source Principal**：标识流量源的对等主体。当使用对等身份验证时设置。
|
||||
* **Source Principal**：标识流量源的对等主体。当使用对等身份验证时设置。
|
||||
|
||||
* **Source App**：根据源工作负载的 `app` 标签标识源应用程序，如果源信息丢失，则标识为 `unknown`。
|
||||
* **Source App**：根据源工作负载的 `app` 标签标识源应用程序，如果源信息丢失，则标识为 `unknown`。
|
||||
|
||||
* **Source Version**：标识源工作负载的版本，如果源信息丢失，则标识为 `unknown`。
|
||||
* **Source Version**：标识源工作负载的版本，如果源信息丢失，则标识为 `unknown`。
|
||||
|
||||
* **Destination Workload**：标识目标工作负载的名称，如果目标信息丢失，则标识为 `unknown`。
|
||||
* **Destination Workload**：标识目标工作负载的名称，如果目标信息丢失，则标识为 `unknown`。
|
||||
|
||||
* **Destination Workload Namespace**：标识目标工作负载的命名空间，如果目标信息丢失，则标识为 `unknown`。
|
||||
* **Destination Workload Namespace**：标识目标工作负载的命名空间，
|
||||
如果目标信息丢失，则标识为 `unknown`。
|
||||
|
||||
* **Destination Principal**：标识流量目标的对等主体。使用对等身份验证时设置。
|
||||
* **Destination Principal**：标识流量目标的对等主体。使用对等身份验证时设置。
|
||||
|
||||
* **Destination App**：它根据目标工作负载的 `app` 标签标识目标应用程序，如果目标信息丢失，则标识为 `unknown`。
|
||||
* **Destination App**：它根据目标工作负载的 `app` 标签标识目标应用程序，
|
||||
如果目标信息丢失，则标识为 `unknown`。
|
||||
|
||||
* **Destination Version**：标识目标工作负载的版本，如果目标信息丢失，则标识为 `unknown`。
|
||||
* **Destination Version**：标识目标工作负载的版本，如果目标信息丢失，则标识为 `unknown`。
|
||||
|
||||
* **Destination Service**：标识负责传入请求的目标服务主机。 例如：`details.default.svc.cluster.local`。
|
||||
* **Destination Service**：标识负责传入请求的目标服务主机。例如 `details.default.svc.cluster.local`。
|
||||
|
||||
* **Destination Service Name**：标识目标服务名称。例如：`details`。
|
||||
* **Destination Service Name**：标识目标服务名称。例如：`details`。
|
||||
|
||||
* **Destination Service Namespace**：标识目标服务的命名空间。
|
||||
* **Destination Service Namespace**：标识目标服务的命名空间。
|
||||
|
||||
* **Request Protocol**：标识请求的协议。设置为请求或连接协议。
|
||||
* **Request Protocol**：标识请求的协议。设置为请求或连接协议。
|
||||
|
||||
* **Response Code**：标识请求的响应代码。此标签仅出现在 HTTP 指标上。
|
||||
* **Response Code**：标识请求的响应代码。此标签仅出现在 HTTP 指标上。
|
||||
|
||||
* **Connection Security Policy**：标识请求的服务认证策略。当 Istio 使用安全策略来保证通信安全时，如果指标由服务端 Istio 代理上报，则将其设置为 `mutual_tls`。如果指标由客户端 Istio 代理上报，由于无法正确填充安全策略，因此将其设置为 `unknown`。
|
||||
* **Connection Security Policy**：标识请求的服务认证策略。当 Istio
|
||||
使用安全策略来保证通信安全时，如果指标由服务端 Istio 代理上报，则将其设置为
|
||||
`mutual_tls`。如果指标由客户端 Istio 代理上报，由于无法正确填充安全策略，因此将其设置为 `unknown`。
|
||||
|
||||
* **Response Flags**：有关来自代理的响应或连接的其他详细信息。如果是 Envoy，请参阅 [Envoy 访问日志](https://www.envoyproxy.io/docs/envoy/latest/configuration/observability/access_log/usage#config-access-log-format-response-flags)中的 `％RESPONSE_FLAGS％` 获取更多信息。
|
||||
* **Response Flags**：有关来自代理的响应或连接的其他详细信息。如果是 Envoy，请参阅
|
||||
[Envoy 访问日志](https://www.envoyproxy.io/docs/envoy/latest/configuration/observability/access_log/usage#config-access-log-format-response-flags)中的
|
||||
`％RESPONSE_FLAGS％` 获取更多信息。
|
||||
|
||||
* **Canonical Service**：工作负载属于一个 Canonical 服务，而 Canonical 服务却可以属于多个服务。Canonical 服务具有名称和修订版本，因此会产生以下标签：
|
||||
* **Canonical Service**：工作负载属于一个 Canonical 服务，而 Canonical 服务却可以属于多个服务。
|
||||
Canonical 服务具有名称和修订版本，因此会产生以下标签：
|
||||
|
||||
{{< text yaml >}}
|
||||
source_canonical_service
|
||||
|
|
@ -88,8 +108,10 @@ aliases:
|
|||
destination_canonical_revision
|
||||
{{< /text >}}
|
||||
|
||||
* **Destination Cluster**：目标工作负载的集群名称。这是由集群安装时的 `global.multiCluster.clusterName` 设置的。
|
||||
* **Destination Cluster**：目标工作负载的集群名称。这是由集群安装时的
|
||||
`global.multiCluster.clusterName` 设置的。
|
||||
|
||||
* **Source Cluster**：源工作负载的集群名称。这是由集群安装时的 `global.multiCluster.clusterName` 设置的。
|
||||
* **Source Cluster**：源工作负载的集群名称。这是由集群安装时的
|
||||
`global.multiCluster.clusterName` 设置的。
|
||||
|
||||
* **gRPC Response Status**: 这标识了 gRPC 的响应状态。 这个标签仅出现在 gRPC 指标上。
|
||||
* **gRPC Response Status**：这标识了 gRPC 的响应状态。这个标签仅出现在 gRPC 指标上。
|
||||
|
|
|
|||
Loading…
Reference in New Issue