V1 API 概述 · ENVOY 智能代理中文參考文檔

## V1 API概述 **注意：當前V1配置被認為是歷史遺留的。它將在未來Envoy的版本中被棄用，并最終完全刪除。如果您是Envoy的新手，強烈建議從[V2配置API](Overviewv2API.md)開始。** Envoy配置格式以JSON編寫，并針對JSON配置進行校驗。配置模式可以在[source/common/json/config_schemas.cc](https://github.com/envoyproxy/envoy/blob/master/source/common/json/config_schemas.cc)中找到。服務器的主要配置包含在監聽器和集群管理器部分。其他配置項指定其他配置。支持YAML提供便利的手寫配置。如果配置文件路徑以.yaml結尾，Envoy在內部將YAML轉換為JSON。在剩下的配置文檔中，我們只提供JSON的配置描述。Envoy期望明確一下YAML標量，如一個集群名稱（應該是一個字符串）被置為真，它應該在YAML配置中被寫為“true”。同樣也適用于整數值和浮點值（例如1、1.0和“1.0”）。 ``` { "listeners": [], "lds": "{...}", "admin": "{...}", "cluster_manager": "{...}", "flags_path": "...", "statsd_udp_ip_address": "...", "statsd_tcp_cluster_name": "...", "stats_flush_interval_ms": "...", "watchdog_miss_timeout_ms": "...", "watchdog_megamiss_timeout_ms": "...", "watchdog_kill_timeout_ms": "...", "watchdog_multikill_timeout_ms": "...", "tracing": "{...}", "rate_limit_service": "{...}", "runtime": "{...}", } ``` **listeners（必選，數組）** 需要由服務實例化的監聽器數組。一個Envoy進程可以包含任意數量的監聽器。 **lds（可選，對象）** 監聽發現服務（LDS）的配置。如果未指定，則只加載靜態監聽器。 **admin（必選，對象）** 本地管理HTTP服務器的配置。 **cluster_manager（必選，對象）** 服務內所擁有的所有上游群集的群集管理器配置。 **flags_path（可選，字符串）** 啟動在文件系統路徑下搜索文件的標志。 **statsd_udp_ip_address（可選，字符串）** 符合`statsd`正在運行的UDP監聽地址。如果指定了，則統計數據將會刷新到這個地址上。IPv4地址格式`host:port`（例如：`127.0.0.1:855`）。IPv6地址的格式`[host]:port`（例如`[::1]:855`）。 **statsd_tcp_cluster_name（可選，字符串）** 符合TCP的`statsd`集群管理集群的名稱。如果指定，Envoy將連接到此群集以刷新統計信息。 **stats_flush_interval_ms（可選，整數）** 配置刷新統計信息時間（以毫秒為單位）。出于性能方面的原因，Envoy鎖定計數器，并且只是周期性地刷新計數器和計量器。如果未指定，則默認值為5000毫秒（5秒）。 **watchdog_miss_timeout_ms（可選，整數）** Envoy統計“server.watchdog_miss”統計信息中的線程無響應的時間（以毫秒為單位）。如果沒有指定，默認是200ms。 **watchdog_megamiss_timeout_ms（可選，整數）** Envoy統計“server.watchdog_mega_miss”統計信息中的線程無響應的時間（以毫秒為單位）。如果未指定，則默認值為1000毫秒。 **watchdog_kill_timeout_ms（可選，整數）** 監視一個線程在這個毫秒內沒有響應，假定因BUG導致導致kill整個Envoy進程。設置為0表示禁用kill行為。如果未指定，則默認值為0（禁用）。 **watchdog_multikill_timeout_ms（可選，整數）** 如果至少有兩個監視的線程至少在這個毫秒內沒有響應，假定因一個真正的死鎖導致kill整個Envoy進程。設置為0表示禁用kill行為。如果未指定，則默認值為0（禁用）。 **tracing（可選，對象）** 外部跟蹤提供程序的配置。如果沒有指定，則不會執行跟蹤。 **rate_limit_service（可選，對象）** 配置外部限速服務提供商。如果沒有指定，任何調用速率限制服務將立即返回成功。 **runtime（可選，對象）** 運行時配置提供程序的配置。如果未指定，將使用“null”提供程序，這將導致使用所有默認值。 ## 返回 - [上一級](../Configurationreference.md) - [首頁目錄](../README.md)