---
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 指标上。