mirror of https://github.com/istio/istio.io.git
118 lines
5.6 KiB
Markdown
118 lines
5.6 KiB
Markdown
---
|
||
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)被实现。
|
||
`COUNTER` 是一个严格递增的整数。
|
||
`DISTRIBUTION` 将数值的范围映射到频率。`COUNTER` 和 `DISTRIBUTION` 在
|
||
[Envoy 文档](https://github.com/envoyproxy/envoy/blob/main/source/docs/stats.md)中对应于指标计数器和直方图。
|
||
|
||
## 指标 {#metrics}
|
||
|
||
对于 HTTP、HTTP/2 和 gRPC 通信，Istio 生成以下指标：
|
||
|
||
* **请求数** (`istio_requests_total`)：这是一个 `COUNTER` 类型的指标，
|
||
用于记录 Istio 代理处理的总请求数。
|
||
|
||
* **请求时长** (`istio_request_duration_milliseconds`)：这是一个 `DISTRIBUTION`
|
||
类型的指标，用于测量请求的持续时间。
|
||
|
||
* **请求体大小** (`istio_request_bytes`)：这是一个 `DISTRIBUTION` 类型的指标，
|
||
用来测量 HTTP 请求主体大小。
|
||
|
||
* **响应体大小** (`istio_response_bytes`)：这是一个 `DISTRIBUTION` 类型的指标，
|
||
用来测量 HTTP 响应主体大小。
|
||
|
||
* **gRPC 请求消息数** (`istio_request_messages_total`)：这是一个 `COUNTER`
|
||
类型的指标，用于记录从客户端发送的 gRPC 消息总数。
|
||
|
||
* **gRPC 响应消息数** (`istio_response_messages_total`)：这是一个 `COUNTER`
|
||
类型的指标，用于记录从服务端发送的 gRPC 消息总数。
|
||
|
||
对于 TCP 流量，Istio 生成以下指标：
|
||
|
||
* **TCP 发送字节数** (`istio_tcp_sent_bytes_total`)：这是一个 `COUNTER`
|
||
类型的指标，用于测量在 TCP 连接情况下响应期间发送的总字节数。
|
||
|
||
* **TCP 接收字节数** (`istio_tcp_received_bytes_total`)：这是一个 `COUNTER`
|
||
类型的指标，用于测量在 TCP 连接情况下请求期间接收到的总字节数。
|
||
|
||
* **TCP 已打开连接数** (`istio_tcp_connections_opened_total`)：这是一个 `COUNTER`
|
||
类型的指标，用于记录 TCP 已打开的连接总数。
|
||
|
||
* **TCP 已关闭连接数** (`istio_tcp_connections_closed_total`)：这是一个 `COUNTER`
|
||
类型的指标，用于记录 TCP 已关闭的连接总数。
|
||
|
||
## 标签 {#label}
|
||
|
||
* **Reporter**：标识请求指标的上报端。如果指标由服务端 Istio 代理上报，则设置为
|
||
`destination`，如果指标由客户端 Istio 代理或网关上报，则设置为 `source`。
|
||
|
||
* **Source Workload**：标识源工作负载的名称，如果缺少源信息，则标识为 `unknown`。
|
||
|
||
* **Source Workload Namespace**：标识源工作负载的命名空间，如果缺少源信息，则标识为 `unknown`。
|
||
|
||
* **Source Principal**：标识流量源的对等主体。当使用对等身份验证时设置。
|
||
|
||
* **Source App**：根据源工作负载的 `app` 标签标识源应用程序，如果源信息丢失，则标识为 `unknown`。
|
||
|
||
* **Source Version**：标识源工作负载的版本，如果源信息丢失，则标识为 `unknown`。
|
||
|
||
* **Destination Workload**：标识目标工作负载的名称，如果目标信息丢失，则标识为 `unknown`。
|
||
|
||
* **Destination Workload Namespace**：标识目标工作负载的命名空间，
|
||
如果目标信息丢失，则标识为 `unknown`。
|
||
|
||
* **Destination Principal**：标识流量目标的对等主体。使用对等身份验证时设置。
|
||
|
||
* **Destination App**：它根据目标工作负载的 `app` 标签标识目标应用程序，
|
||
如果目标信息丢失，则标识为 `unknown`。
|
||
|
||
* **Destination Version**：标识目标工作负载的版本，如果目标信息丢失，则标识为 `unknown`。
|
||
|
||
* **Destination Service**：标识负责传入请求的目标服务主机。例如 `details.default.svc.cluster.local`。
|
||
|
||
* **Destination Service Name**：标识目标服务名称。例如：`details`。
|
||
|
||
* **Destination Service Namespace**：标识目标服务的命名空间。
|
||
|
||
* **Request Protocol**：标识请求的协议。设置为请求或连接协议。
|
||
|
||
* **Response Code**：标识请求的响应代码。此标签仅出现在 HTTP 指标上。
|
||
|
||
* **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％` 获取更多信息。
|
||
|
||
* **Canonical Service**：工作负载属于一个 Canonical 服务，而 Canonical 服务却可以属于多个服务。
|
||
Canonical 服务具有名称和修订版本，因此会产生以下标签：
|
||
|
||
{{< text yaml >}}
|
||
source_canonical_service
|
||
source_canonical_revision
|
||
destination_canonical_service
|
||
destination_canonical_revision
|
||
{{< /text >}}
|
||
|
||
* **Destination Cluster**：目标工作负载的集群名称。这是由集群安装时的
|
||
`global.multiCluster.clusterName` 设置的。
|
||
|
||
* **Source Cluster**：源工作负载的集群名称。这是由集群安装时的
|
||
`global.multiCluster.clusterName` 设置的。
|
||
|
||
* **gRPC Response Status**：这标识了 gRPC 的响应状态。这个标签仅出现在 gRPC 指标上。
|