叢集 (proto)

admin.v3.Clusters

管理端點使用此封裝器來顯示 /clusters 的叢集狀態資訊。請參閱 /clusters 以取得更多資訊。

{
  "cluster_statuses": []
}

cluster_statuses: (重複 admin.v3.ClusterStatus) 從叢集名稱到每個叢集狀態的對應。

admin.v3.ClusterStatus

[admin.v3.ClusterStatus proto]

詳細說明個別叢集的目前狀態。

{
  "name": ...,
  "added_via_api": ...,
  "success_rate_ejection_threshold": {...},
  "host_statuses": [],
  "local_origin_success_rate_ejection_threshold": {...},
  "circuit_breakers": {...},
  "observability_name": ...,
  "eds_service_name": ...
}

name: (字串) 叢集的名稱。

added_via_api: (布林值) 表示此叢集是透過 API 新增，還是靜態設定。

success_rate_ejection_threshold

(type.v3.Percent) 最後一個間隔中使用的成功率臨界值。如果 outlier_detection.split_external_local_origin_errors 為 false，則所有錯誤（外部和本機產生）都用於計算臨界值。如果 outlier_detection.split_external_local_origin_errors 為 true，則只有外部產生的錯誤會用於計算臨界值。臨界值用於根據主機的成功率來彈出主機。請參閱叢集離群值偵測文件以取得詳細資訊。

注意：在下列三種情況中的任何一種情況下，此欄位可能會省略

沒有足夠的請求量的主機來進行基於成功率的離群值彈出。
臨界值計算為 < 0，因為負值表示該間隔沒有臨界值。
此叢集未啟用離群值偵測。

host_statuses: (重複 admin.v3.HostStatus) 從主機位址到主機目前狀態的對應。

local_origin_success_rate_ejection_threshold

(type.v3.Percent) 當僅考慮本機產生的失敗，且將外部產生的錯誤視為成功時，最後一個間隔中使用的成功率臨界值。只有當 outlier_detection.split_external_local_origin_errors 為 true 時，才應解讀此欄位。臨界值用於根據主機的成功率來彈出主機。請參閱叢集離群值偵測文件以取得詳細資訊。

注意：在下列三種情況中的任何一種情況下，此欄位可能會省略

沒有足夠的請求量的主機來進行基於成功率的離群值彈出。
臨界值計算為 < 0，因為負值表示該間隔沒有臨界值。
此叢集未啟用離群值偵測。

circuit_breakers: (config.cluster.v3.CircuitBreakers) 叢集的斷路器設定。

observability_name: (字串) 叢集的可觀察性名稱。

eds_service_name: (字串) 如果叢集是 EDS 叢集，則為 EDS 服務名稱。

admin.v3.HostStatus

[admin.v3.HostStatus proto]

特定主機的目前狀態。

{
  "address": {...},
  "stats": [],
  "health_status": {...},
  "success_rate": {...},
  "weight": ...,
  "hostname": ...,
  "priority": ...,
  "local_origin_success_rate": {...},
  "locality": {...}
}

address: (config.core.v3.Address) 此主機的位址。

stats: (重複 admin.v3.SimpleMetric) 適用於此主機的統計清單。

health_status: (admin.v3.HostHealthStatus) 主機的目前健全狀態。

success_rate

(type.v3.Percent) 此主機在最後計算間隔的請求成功率。如果 outlier_detection.split_external_local_origin_errors 為 false，則所有錯誤（外部和本機產生）都用於計算成功率。如果 outlier_detection.split_external_local_origin_errors 為 true，則只有外部產生的錯誤會用於計算成功率。請參閱叢集離群值偵測文件以取得詳細資訊。

注意：如果主機沒有足夠的請求量來計算成功率，或叢集沒有足夠的主機來執行成功率離群值彈出，則不會顯示訊息。

weight: (uint32) 主機的權重。如果未設定，則預設值為 1。

hostname: (字串) 主機的主機名稱（如果適用）。

priority: (uint32) 主機的優先順序。如果未設定，則預設值為 0（最高優先順序）。

local_origin_success_rate

(type.v3.Percent) 當僅考慮本機產生的錯誤，且將外部產生的錯誤視為成功時，此主機在最後計算間隔的請求成功率。只有當 outlier_detection.split_external_local_origin_errors 為 true 時，才應解讀此欄位。請參閱叢集離群值偵測文件以取得詳細資訊。

注意：如果主機沒有足夠的請求量來計算成功率，或叢集沒有足夠的主機來執行成功率離群值彈出，則不會顯示訊息。

locality: (config.core.v3.Locality) 主機的區域性。

admin.v3.HostHealthStatus

[admin.v3.HostHealthStatus proto]

主機的健全狀態。

{
  "failed_active_health_check": ...,
  "failed_outlier_check": ...,
  "failed_active_degraded_check": ...,
  "pending_dynamic_removal": ...,
  "pending_active_hc": ...,
  "excluded_via_immediate_hc_fail": ...,
  "active_hc_timeout": ...,
  "eds_health_status": ...
}

failed_active_health_check: (布林值) 主機目前未通過主動健全狀態檢查。

failed_outlier_check: (布林值) 主機目前被視為離群值且已彈出。

failed_active_degraded_check: (布林值) 主機目前透過主動健全狀態檢查標記為已降級。

pending_dynamic_removal: (布林值) 主機已從服務探索中移除，但由於主動健全狀態檢查而正在穩定中。

pending_active_hc: (布林值) 尚未對主機進行健全狀態檢查。

excluded_via_immediate_hc_fail: (布林值) 由於透過協定訊號明確將其從輪換中移除，因此主機應從恐慌、溢流等計算中排除，且不應路由至該主機。

active_hc_timeout: (布林值) 主機由於逾時而無法通過主動 HC。

eds_health_status: (config.core.v3.HealthStatus) EDS 回報的健全狀態。注意：目前僅支援 HEALTHY 和 UNHEALTHY。