## 統計
- [概述](#概述)
- [健康檢查統計](#健康檢查統計)
- [離群檢測統計](#離群檢測統計)
- [動態HTTP統計](#動態http統計)
- [動態HTTP交叉樹統計](#動態http交叉樹統計)
- [按服務區動態HTTP統計](#按服務區動態http統計)
- [負載均衡統計](#負載均衡統計)
- [負載均衡子集統計](#負載均衡子集統計)
### 概述
集群管理器的統計樹根為`cluster_manager.`用下面的統計描述。任何`:`字符在統計名稱中的被替換為`_`。
| Name | Type | Description |
| ------------- | ------------- | ------------- |
| cluster_added | Counter | 總群集添加(通過靜態配置或CDS) |
| cluster_modified | Counter | 總群集修改(通過CDS) |
| cluster_removed | Counter | 總群集刪除(通過CDS) |
| total_clusters | Gauge | 當前加載的群集數量 |
每個群集都有一個以`cluster.<name>.`為根的統計樹。統計如下:
| Name | Type | Description |
| ------------- | ------------- | ------------- |
| upstream_cx_total | Counter | 總連接數 |
| upstream_cx_active | Gauge | 總活動連接數 |
| upstream_cx_http1_total | Counter | 總HTTP/1.1連接數 |
| upstream_cx_http2_total | Counter | 總HTTP/2連接數 |
| upstream_cx_connect_fail | Counter | 總連接失敗 |
| upstream_cx_connect_timeout | Counter | 總連接超時 |
| upstream_cx_connect_attempts_exceeded | Counter | 總連續的連接失敗超過配置的連接嘗試 |
| upstream_cx_overflow | Counter | 集群連接斷路器溢出的總次數 |
| upstream_cx_connect_ms | Histogram | 連接建立毫秒 |
| upstream_cx_length_ms | Histogram | 連接長度毫秒 |
| upstream_cx_destroy | Counter | 總毀壞的連接 |
| upstream_cx_destroy_local | Counter | 總連接在本地被銷毀 |
| upstream_cx_destroy_remote | Counter | 總連接被遠程銷毀 |
| upstream_cx_destroy_with_active_rq | Counter | 總共連接被1個活動請求銷毀 |
| upstream_cx_destroy_local_with_active_rq | Counter | 總共有1個活動請求在本地銷毀 |
| upstream_cx_destroy_remote_with_active_rq | Counter | 總共連接被1個活動請求遠程銷毀 |
| upstream_cx_close_notify | Counter | 總連接通過HTTP/1.1連接關閉標頭或HTTP/2 GOAWAY關閉 |
| upstream_cx_rx_bytes_total | Counter | 收到的連接字節總數 |
| upstream_cx_rx_bytes_buffered | Gauge | 接收到當前緩沖的連接字節 |
| upstream_cx_tx_bytes_total | Counter | 發送的連接字節總數 |
| upstream_cx_tx_bytes_buffered | Gauge | 發送當前緩沖的連接字節 |
| upstream_cx_protocol_error | Counter | 協議錯誤的總連接數 |
| upstream_cx_max_requests | Counter | 由于最大請求而關閉總連接數 |
| upstream_cx_none_healthy | Counter | 由于沒有健康的主機,沒有建立連接總數 |
| upstream_rq_total | Counter | 總請求 |
| upstream_rq_active | Gauge | 總活動請求 |
| upstream_rq_pending_total | Counter | 掛起連接池連接的請求總數 |
| upstream_rq_pending_overflow | Counter | 連接池斷路溢出并失敗的請求總數 |
| upstream_rq_pending_failure_eject | Counter | 由于連接池連接失敗而導致失敗的總請求數 |
| upstream_rq_pending_active | Gauge | 等待連接池連接的活動請求總數 |
| upstream_rq_cancelled | Counter | 獲取連接池連接之前被取消的總請求數 |
| upstream_rq_maintenance_mode | Counter | 由于維護模式而導致立即返回503錯誤的總請求 |
| upstream_rq_timeout | Counter | 超時等待響應的請求總數 |
| upstream_rq_per_try_timeout | Counter | 每次嘗試超時的總請求數 |
| upstream_rq_rx_reset | Counter | 在遠端重置的總請求數 |
| upstream_rq_tx_reset | Counter | 在本地重置的總請求數 |
| upstream_rq_retry | Counter | 請求重試次數 |
| upstream_rq_retry_success | Counter | 請求重試成功次數 |
| upstream_rq_retry_overflow | Counter | 由于熔斷,未重試的總請求數 |
| upstream_flow_control_paused_reading_total | Counter | 流量控制,從上游暫停讀取的總次數 |
| upstream_flow_control_resumed_reading_total | Counter | 流量控制,從上游恢復讀取的總次數 |
| upstream_flow_control_backed_up_total | Counter | 上游連接備份、暫停下游讀取的總次數 |
| upstream_flow_control_drained_total | Counter | 上游連接逐出、恢復下游讀取的總次數 |
| membership_change | Counter | 總集群成員變化 |
| membership_healthy | Gauge | 當前群集健康成員總數(包括健康檢查和異常值檢測) |
| membership_total | Gauge | 當前的集群成員總數 |
| retry_or_shadow_abandoned | Counter | 由于緩沖區限制,忽略或重試、被取消的總次數 |
| config_reload | Counter | 由于不同的配置,導致配置重新加載的API調用次數 |
| update_attempt | Counter | 總集群成員更新嘗試次數 |
| update_success | Counter | 總集群成員更新成功次數 |
| update_failure | Counter | 總集群成員更新失敗次數 |
| version | Gauge | 來自上次API調用加載成功的內容哈希 |
| max_host_weight | Gauge | 群集中所有主機的最大權重 |
| bind_errors | Counter | 將套接字綁定到配置的源地址錯誤總數 |
### 健康檢查統計
如果配置了健康檢查,那么集群會有一個以`cluster.<name>.health_check.`為根的統計樹,統計如下:
| Name | Type | Description |
| ------------- | ------------- | ------------- |
| attempt | Counter | 健康檢查的次數 |
| success | Counter | 健康檢查成功的次數 |
| failure | Counter | 執行健康檢查快速失敗的次數,(例如:HTTP 503,以及網絡故障) |
| passive_failure | Counter | 因被動事件導致的健康檢查失敗的次數(例如:`x-envoy-immediate-health-check-fail`) |
| network_failure | Counter | 由于網絡錯誤導致的健康檢查失敗次數 |
| verify_cluster | Counter | 嘗試集群名稱驗證的健康檢查的數量 |
| healthy | Gauge | 健康成員的數量 |
### 離群檢測統計
如果為群集配置了離群異常檢測,則統計信息將以`cluster.<name>.outlier_detection.`為根。并包含以下內容:
| Name | Type | Description |
| ------------- | ------------- | ------------- |
| ejections_enforced_total | Counter | 由于任何異常類型導致的強制逐出的數量 |
| ejections_active | Gauge | 當前被逐出主機的數量 |
| ejections_overflow | Counter | 因達到最大逐出而中止次數百分占比 |
| ejections_enforced_consecutive_5xx | Counter | 執行的連續5xx逐出次數 |
| ejections_detected_consecutive_5xx | Counter | 檢測到的連續5xx逐出次數(即使未被強制執行) |
| ejections_enforced_success_rate | Counter | 執行成功率異常值逐出的次數 |
| ejections_detected_success_rate | Counter | 檢測到的成功率異常值逐出次數(即使未執行) |
| ejections_enforced_consecutive_gateway_failure | Counter | 執行的連續網關故障逐出次數 |
| ejections_detected_consecutive_gateway_failure | Counter | 檢測到的連續網關故障逐出次數(即使未被強制執行) |
| ejections_total | Counter | **已過時**:由于任何異常值類型(即使未強制執行) |
| ejections_consecutive_5xx | Counter | **已過時**:連續的5xx被逐出次數(即使未被強制執行) |
### 動態HTTP統計
若啟用了HTTP,則動態HTTP響應統計信息也可用。這些由各種內部系統,以及各種路由、速率限制之類的過濾器構成的統計。以`cluster.<name>.`為根,并包含以下統計信息:
| Name | Type | Description |
| ------------- | ------------- | ------------- |
| upstream\_rq\_<*xx> | Counter | HTTP響應碼匯總統計(例如:2xx,3xx等) |
| upstream\_rq_<*> | Counter | 具體的HTTP響應碼統計(例如:201、302等) |
| upstream\_rq_time | Histogram | 請求時間,單位毫秒 |
| canary.upstream\_rq_<*xx> | Counter | 上游灰度發布期間的HTTP響應碼統計 |
| canary.upstream\_rq_<*> | Counter | 上游灰度發布期間具體的HTTP響應碼統計 |
| canary.upstream_rq_time | Histogram | 上游灰度發布期間請求時間毫秒 |
| internal.upstream\_rq_<*xx> | Counter | 來自內部的HTTP響應碼統計 |
| internal.upstream\_rq_<*> | Counter | 來自內部具體的HTTP響應碼統計 |
| internal.upstream_rq_time | Histogram | 來自內部請求時間,單位毫秒 |
| external.upstream\_rq_<*xx> | Counter | 來自外部HTTP響應碼匯總統計 |
| external.upstream\_rq_<*> | Counter | 來自外部具體的HTTP響應碼統計 |
| external.upstream_rq_time | Histogram | 來自外部請求時間,單位毫秒 |
### 動態HTTP交叉樹統計
如果配置了交叉樹統計信息,它們將以`cluster.<name>.<alt name>. `為命名空間。生成的統計信息與上面的動態HTTP統計信息相同。
### 按服務區動態HTTP統計
如果服務區可用于本地服務(通過`--service-zone`)和上游群集,則Envoy將以`cluster.<name>.zone.<from_zone>.<to_zone>`為命名空間。統計信息如下:
| Name | Type | Description |
| ------------- | ------------- | ------------- |
| upstream_rq_\<*xx> | Counter | HTTP響應碼匯總統計(例如:2xx,3xx等) |
| upstream_rq_\<*> | Counter | 具體的HTTP響應碼統計(例如:201、302等) |
| upstream_rq_time | Histogram | 請求時間,單位毫秒 |
### 負載均衡統計
監控負載均衡決策的統計信息。統計信息以`cluster.<name>.`為根,并包含以下統計信息:
| Name | Type | Description |
| ------------- | ------------- | ------------- |
| lb_healthy_panic | Counter | 恐慌模式下承載負載均衡請求的總數 |
| lb_zone_cluster_too_small | Counter | 由于上游群集過小,無區域感知路由決策次數 |
| lb_zone_routing_all_directly | Counter | 所有請求直接發送到同一個區域決策次數 |
| lb_zone_routing_sampled | Counter | 發送一些請求到同一個區域決策次數 |
| lb_zone_routing_cross_zone | Counter | 區域感知路由模式,但必須發送交叉區域的次數 |
| lb_local_cluster_not_ok | Counter | 本地主機集未設置,或者是本地群集處于混亂模式 |
| lb_zone_number_differs | Counter | 本地和上游群集中的區域數目不同的次數 |
### 負載均衡子集統計
監控以`<arch_overview_load_balancer_subsets>`描述符負載均衡器子集的統計信息,統計信息以`cluster.<name>.`根并包含以下統計信息:
| Name | Type | Description |
| ------------- | ------------- | ------------- |
| lb_subsets_active | Gauge | 當前可用子集的數量 |
| lb_subsets_created | Counter | 創建的子集數量 |
| lb_subsets_removed | Counter | 由于沒有主機而被刪除的子集數量 |
| lb_subsets_selected | Counter | 選擇任何子集進行負載平衡的次數 |
| lb_subsets_fallback | Counter | 回退策略被調用的次數 |
## 返回
- [上一級](../Clustermanager.md)
- [首頁目錄](../../README.md)
- 首頁
- 簡介
- Envoy是什么
- 架構介紹
- 術語
- 線程模型
- 監聽器
- L3/L4網絡過濾器
- HTTP連接管理
- HTTP過濾器
- HTTP路由
- gRPC
- WebSocket支持
- 集群管理
- 服務發現
- 健康檢查
- 連接池
- 負載均衡
- 異常檢測
- 熔斷
- 全局限速
- TLS
- 統計
- 運行時配置
- 跟蹤
- TCP代理
- 訪問日志
- MongoDB
- DynamoDB
- Redis
- 熱重啟
- 動態配置
- 初始化
- 逐出
- 腳本
- 部署
- 業界對比
- 獲得幫助
- 歷史版本
- 編譯安裝
- 編譯
- 參考配置
- 演示沙箱
- 前端代理
- Zipkin跟蹤
- Jaeger跟蹤
- gRPC橋接
- 構建Envoy Docker鏡像
- 工具
- 配置參考
- V1 API 概述
- V2 API 概述
- 監聽器
- 網絡過濾器
- TLS客戶端身份認證
- Echo
- Mongo代理
- 速率限制
- Redis代理
- TCP代理
- HTTP連接管理器
- 路由匹配
- 流量轉移/分流
- HTTP頭部操作
- HTTP頭部清理
- 統計
- 運行時設置
- 路由發現服務
- HTTP過濾器
- 緩存
- CORS過濾器
- 故障注入
- DynamoDB
- gRPC HTTP/1.1 橋接
- gRPC-JSON 轉碼過濾器
- gRPC-Web 過濾器
- 健康檢查
- 速率限制
- 路由
- Lua
- 集群管理
- 統計
- 運行時設置
- 集群發現服務
- 健康檢查
- 熔斷
- 訪問日志
- 限速服務
- 運行時配置
- 路由表檢查工具
- 運維管理
- 命令行選項
- 熱重啟
- 管理接口
- 統計概述
- 運行時配置
- 文件系統
- 自定義擴展示例
- V1 API參考
- 監聽器
- 網絡過濾器
- TLS客戶端身份認證
- Echo
- HTTP連接管理
- Mongo代理
- 速率限制
- Redis代理
- TCP代理
- HTTP路由配置
- 虛擬主機
- 路由
- 虛擬集群
- 速率限制配置
- 路由發現服務
- HTTP過濾器
- 緩存
- CORS過濾器
- DynamoDB
- 故障注入
- gRPC HTTP/1.1 橋接
- gRPC-JSON 轉碼過濾器
- gRPC-Web 過濾器
- 健康檢查
- Lua
- 速率限制
- 路由
- 集群管理
- 集群
- 健康檢查
- 熔斷
- TLS上下文
- 異常值檢測
- HASH環負載均衡配置
- 異常檢測
- 集群發現服務
- 服務發現服務
- 訪問日志
- 管理接口
- 限速服務
- 運行時配置
- 跟蹤
- V2 API參考
- 啟動引導
- 監聽&監聽發現
- 集群&集群發現
- 服務發現
- 健康檢查
- HTTP路由管理&發現
- TLS配置
- 通用的類型
- 網絡地址
- 協議選項
- 發現API
- 限速組件
- 過濾器
- 網絡過濾器
- TLS客戶端身份認證
- HTTP連接管理
- Mongo代理
- 速率限制
- Redis代理
- TCP代理
- HTTP過濾器
- 緩存
- 故障注入
- 健康檢查
- Lua
- 速率限制
- 路由
- gRPC-JSON轉碼器
- 常見訪問日志類型
- 常見故障注入類型
- FAQ
- Envoy有多快?
- 我在哪里獲得二進制文件?
- 我如何設置SNI?
- 如何設置區域感知路由?
- 我如何設置Zipkin跟蹤?