Version history --------------- 1.6.0 ===== * access log: added DOWNSTREAM_REMOTE_ADDRESS, DOWNSTREAM_REMOTE_ADDRESS_WITHOUT_PORT, and DOWNSTREAM_LOCAL_ADDRESS :ref:`access log formatters `. DOWNSTREAM_ADDRESS access log formatter has been deprecated. * access log: added less than or equal (LE) :ref:`comparison filter `. * access log: added configuration to :ref:`runtime filter ` to set default sampling rate, divisor, and whether to use independent randomness or not. * admin: added :ref:`/runtime ` admin endpoint to read the current runtime values. * build: added support for :repo:`building Envoy with exported symbols `. This change allows scripts loaded with the Lua filter to load shared object libraries such as those installed via `LuaRocks `_. * config: added support for sending error details as `grpc.rpc.Status `_ in :ref:`DiscoveryRequest `. * config: added support for :ref:`inline delivery ` of TLS certificates and private keys. * config: added restrictions for the backing :ref:`config sources ` of xDS resources. For filesystem based xDS the file must exist at configuration time. For cluster based xDS the backing cluster must be statically defined and be of non-EDS type. * grpc: the Google gRPC C++ library client is now supported as specified in the :ref:`gRPC services overview ` and :ref:`GrpcService `. * grpc-json: Added support for :ref:`inline descriptors `. * health check: added :ref:`gRPC health check ` based on `grpc.health.v1.Health `_ service. * health check: added ability to set :ref:`host header value ` for http health check. * health check: extended the health check filter to support computation of the health check response based on the :ref:`percentage of healthy servers in upstream clusters `. * health check: added setting for :ref:`no-traffic interval`. * http : added idle timeout for :ref:`upstream http connections `. * http: added support for :ref:`proxying 100-Continue responses `. * http: added the ability to pass a URL encoded PEM encoded peer certificate in the :ref:`config_http_conn_man_headers_x-forwarded-client-cert` header. * http: added support for trusting additional hops in the :ref:`config_http_conn_man_headers_x-forwarded-for` request header. * http: added support for :ref:`incoming HTTP/1.0 `. * hot restart: added SIGTERM propagation to children to :ref:`hot-restarter.py `, which enables using it as a parent of containers. * ip tagging: added :ref:`HTTP IP Tagging filter`. * listeners: added support for :ref:`listening for both IPv4 and IPv6 ` when binding to ::. * listeners: added support for listening on :ref:`UNIX domain sockets `. * listeners: added support for :ref:`abstract unix domain sockets ` on Linux. The abstract namespace can be used by prepending '@' to a socket path. * load balancer: added cluster configuration for :ref:`healthy panic threshold ` percentage. * load balancer: added :ref:`Maglev ` consistent hash load balancer. * load balancer: added support for :ref:`LocalityLbEndpoints` priorities. * lua: added headers :ref:`replace() ` API. * lua: extended to support :ref:`metadata object ` API. * redis: added local `PING` support to the :ref:`Redis filter `. * redis: added `GEORADIUS_RO` and `GEORADIUSBYMEMBER_RO` to the :ref:`Redis command splitter ` whitelist. * router: added DOWNSTREAM_REMOTE_ADDRESS_WITHOUT_PORT, DOWNSTREAM_LOCAL_ADDRESS, DOWNSTREAM_LOCAL_ADDRESS_WITHOUT_PORT, PROTOCOL, and UPSTREAM_METADATA :ref:`header formatters `. The CLIENT_IP header formatter has been deprecated. * router: added gateway-error :ref:`retry-on ` policy. * router: added support for route matching based on :ref:`URL query string parameters `. * router: added support for more granular weighted cluster routing by allowing the :ref:`total_weight ` to be specified in configuration. * router: added support for :ref:`custom request/response headers ` with mixed static and dynamic values. * router: added support for :ref:`direct responses `. I.e., sending a preconfigured HTTP response without proxying anywhere. * router: added support for :ref:`HTTPS redirects ` on specific routes. * router: added support for :ref:`prefix_rewrite ` for redirects. * router: added support for :ref:`stripping the query string ` for redirects. * router: added support for downstream request/upstream response :ref:`header manipulation ` in :ref:`weighted cluster `. * router: added support for :ref:`range based header matching ` for request routing. * squash: added support for the :ref:`Squash microservices debugger `. Allows debugging an incoming request to a microservice in the mesh. * stats: added metrics service API implementation. * stats: added native :ref:`DogStatsd ` support. * stats: added support for :ref:`fixed stats tag values ` which will be added to all metrics. * tcp proxy: added support for specifying a :ref:`metadata matcher ` for upstream clusters in the tcp filter. * tcp proxy: improved TCP proxy to correctly proxy TCP half-close. * tcp proxy: added :ref:`idle timeout `. * tcp proxy: access logs now bring an IP address without a port when using DOWNSTREAM_ADDRESS. Use :ref:`DOWNSTREAM_REMOTE_ADDRESS ` instead. * tracing: added support for dynamically loading an :ref:`OpenTracing tracer `. * tracing: when using the Zipkin tracer, it is now possible for clients to specify the sampling decision (using the :ref:`x-b3-sampled ` header) and have the decision propagated through to subsequently invoked services. * tracing: when using the Zipkin tracer, it is no longer necessary to propagate the :ref:`x-ot-span-context ` header. See more on trace context propagation :ref:`here `. * transport sockets: added transport socket interface to allow custom implementations of transport sockets. A transport socket provides read and write logic with buffer encryption and decryption (if applicable). The existing TLS implementation has been refactored with the interface. * upstream: added support for specifying an :ref:`alternate stats name ` while emitting stats for clusters. * Many small bug fixes and performance improvements not listed. 1.5.0 ===== * access log: added fields for :ref:`UPSTREAM_LOCAL_ADDRESS and DOWNSTREAM_ADDRESS `. * admin: added :ref:`JSON output ` for stats admin endpoint. * admin: added basic :ref:`Prometheus output ` for stats admin endpoint. Histograms are not currently output. * admin: added ``version_info`` to the :ref:`/clusters admin endpoint`. * config: the :ref:`v2 API ` is now considered production ready. * config: added :option:`--v2-config-only` CLI flag. * cors: added :ref:`CORS filter `. * health check: added :ref:`x-envoy-immediate-health-check-fail ` header support. * health check: added :ref:`reuse_connection ` option. * http: added :ref:`per-listener stats `. * http: end-to-end HTTP flow control is now complete across both connections, streams, and filters. * load balancer: added :ref:`subset load balancer `. * load balancer: added ring size and hash :ref:`configuration options `. This used to be configurable via runtime. The runtime configuration was deleted without deprecation as we are fairly certain no one is using it. * log: added the ability to optionally log to a file instead of stderr via the :option:`--log-path` option. * listeners: added :ref:`drain_type ` option. * lua: added experimental :ref:`Lua filter `. * mongo filter: added :ref:`fault injection `. * mongo filter: added :ref:`"drain close" ` support. * outlier detection: added :ref:`HTTP gateway failure type `. See `DEPRECATED.md `_ for outlier detection stats deprecations in this release. * redis: the :ref:`redis proxy filter ` is now considered production ready. * redis: added :ref:`"drain close" ` functionality. * router: added :ref:`x-envoy-overloaded ` support. * router: added :ref:`regex ` route matching. * router: added :ref:`custom request headers ` for upstream requests. * router: added :ref:`downstream IP hashing ` for HTTP ketama routing. * router: added :ref:`cookie hashing `. * router: added :ref:`start_child_span ` option to create child span for egress calls. * router: added optional :ref:`upstream logs `. * router: added complete :ref:`custom append/override/remove support ` of request/response headers. * router: added support to :ref:`specify response code during redirect `. * router: added :ref:`configuration ` to return either a 404 or 503 if the upstream cluster does not exist. * runtime: added :ref:`comment capability `. * server: change default log level (:option:`-l`) to `info`. * stats: maximum stat/name sizes and maximum number of stats are now variable via the :option:`--max-obj-name-len` and :option:`--max-stats` options. * tcp proxy: added :ref:`access logging `. * tcp proxy: added :ref:`configurable connect retries `. * tcp proxy: enable use of :ref:`outlier detector `. * tls: added :ref:`SNI support `. * tls: added support for specifying :ref:`TLS session ticket keys `. * tls: allow configuration of the :ref:`min ` and :ref:`max ` TLS protocol versions. * tracing: added :ref:`custom trace span decorators `. * Many small bug fixes and performance improvements not listed. 1.4.0 ===== * macOS is :repo:`now supported `. (A few features are missing such as hot restart and original destination routing). * YAML is now directly supported for :ref:`config files `. * Added :ref:`/routes ` admin endpoint. * End-to-end flow control is now supported for TCP proxy, HTTP/1, and HTTP/2. HTTP flow control that includes filter buffering is incomplete and will be implemented in 1.5.0. * Log verbosity :repo:`compile time flag ` added. * Hot restart :repo:`compile time flag ` added. * Original destination :ref:`cluster ` and :ref:`load balancer ` added. * :ref:`WebSocket ` is now supported. * Virtual cluster priorities have been hard removed without deprecation as we are reasonably sure no one is using this feature. * Route :ref:`validate_clusters ` option added. * :ref:`x-envoy-downstream-service-node ` header added. * :ref:`x-forwarded-client-cert ` header added. * Initial HTTP/1 forward proxy support for :ref:`absolute URLs ` has been added. * HTTP/2 codec settings are now :ref:`configurable `. * gRPC/JSON transcoder :ref:`filter ` added. * gRPC web :ref:`filter ` added. * Configurable timeout for the rate limit service call in the :ref:`network ` and :ref:`HTTP ` rate limit filters. * :ref:`x-envoy-retry-grpc-on ` header added. * :ref:`LDS API ` added. * TLS :ref:`require_client_certificate ` option added. * :ref:`Configuration check tool ` added. * :ref:`JSON schema check tool ` added. * Config validation mode added via the :option:`--mode` option. * :option:`--local-address-ip-version` option added. * IPv6 support is now complete. * UDP :ref:`statsd_ip_address ` option added. * Per-cluster :ref:`DNS resolvers ` added. * :ref:`Fault filter ` enhancements and fixes. * Several features are :repo:`deprecated as of the 1.4.0 release `. They will be removed at the beginning of the 1.5.0 release cycle. We explicitly call out that the `HttpFilterConfigFactory` filter API has been deprecated in favor of `NamedHttpFilterConfigFactory`. * Many small bug fixes and performance improvements not listed. 1.3.0 ===== * As of this release, we now have an official :repo:`breaking change policy `. Note that there are numerous breaking configuration changes in this release. They are not listed here. Future releases will adhere to the policy and have clear documentation on deprecations and changes. * Bazel is now the canonical build system (replacing CMake). There have been a huge number of changes to the development/build/test flow. See :repo:`/bazel/README.md` and :repo:`/ci/README.md` for more information. * :ref:`Outlier detection ` has been expanded to include success rate variance, and all parameters are now configurable in both runtime and in the JSON configuration. * TCP level :ref:`listener ` and :ref:`cluster ` connections now have configurable receive buffer limits at which point connection level back pressure is applied. Full end to end flow control will be available in a future release. * :ref:`Redis health checking ` has been added as an active health check type. Full Redis support will be documented/supported in 1.4.0. * :ref:`TCP health checking ` now supports a "connect only" mode that only checks if the remote server can be connected to without writing/reading any data. * `BoringSSL `_ is now the only supported TLS provider. The default cipher suites and ECDH curves have been updated with more modern defaults for both :ref:`listener ` and :ref:`cluster ` connections. * The `header value match` :ref:`rate limit action ` has been expanded to include an *expect match* parameter. * Route level HTTP rate limit configurations now do not inherit the virtual host level configurations by default. The :ref:`include_vh_rate_limits ` to inherit the virtual host level options if desired. * HTTP routes can now add request headers on a per route and per virtual host basis via the :ref:`request_headers_to_add ` option. * The :ref:`example configurations ` have been refreshed to demonstrate the latest features. * :ref:`per_try_timeout_ms ` can now be configured in a route's retry policy in addition to via the :ref:`x-envoy-upstream-rq-per-try-timeout-ms ` HTTP header. * :ref:`HTTP virtual host matching ` now includes support for prefix wildcard domains (e.g., `*.lyft.com`). * The default for tracing random sampling has been changed to 100% and is still configurable in :ref:`runtime `. * :ref:`HTTP tracing configuration ` has been extended to allow tags to be populated from arbitrary HTTP headers. * The :ref:`HTTP rate limit filter ` can now be applied to internal, external, or all requests via the `request_type` option. * :ref:`Listener binding ` now requires specifying an `address` field. This can be used to bind a listener to both a specific address as well as a port. * The :ref:`MongoDB filter ` now emits a stat for queries that do not have `$maxTimeMS` set. * The :ref:`MongoDB filter ` now emits logs that are fully valid JSON. * The CPU profiler output path is now :ref:`configurable `. * A :ref:`watchdog system ` has been added that can kill the server if a deadlock is detected. * A :ref:`route table checking tool ` has been added that can be used to test route tables before use. * We have added an :ref:`example repo ` that shows how to compile/link a custom filter. * Added additional cluster wide information related to outlier detection to the :ref:`/clusters admin endpoint `. * Multiple SANs can now be verified via the :ref:`verify_subject_alt_name ` setting. Additionally, URI type SANs can be verified. * HTTP filters can now be passed :ref:`opaque configuration ` specified on a per route basis. * By default Envoy now has a built in crash handler that will print a back trace. This behavior can be disabled if desired via the ``--define=signal_trace=disabled`` Bazel option. * Zipkin has been added as a supported :ref:`tracing provider `. * Numerous small changes and fixes not listed here. 1.2.0 ===== * :ref:`Cluster discovery service (CDS) API `. * :ref:`Outlier detection ` (passive health checking). * Envoy configuration is now checked against a :ref:`JSON schema `. * :ref:`Ring hash ` consistent load balancer, as well as HTTP consistent hash routing :ref:`based on a policy `. * Vastly :ref:`enhanced global rate limit configuration ` via the HTTP rate limiting filter. * HTTP routing to a cluster :ref:`retrieved from a header `. * :ref:`Weighted cluster ` HTTP routing. * :ref:`Auto host rewrite ` during HTTP routing. * :ref:`Regex header matching ` during HTTP routing. * HTTP access log :ref:`runtime filter `. * LightStep tracer :ref:`parent/child span association `. * :ref:`Route discovery service (RDS) API `. * HTTP router :ref:`x-envoy-upstream-rq-timeout-alt-response header ` support. * *use_original_dst* and *bind_to_port* :ref:`listener options ` (useful for iptables based transparent proxy support). * TCP proxy filter :ref:`route table support `. * Configurable :ref:`stats flush interval `. * Various :ref:`third party library upgrades `, including using BoringSSL as the default SSL provider. * No longer maintain closed HTTP/2 streams for priority calculations. Leads to substantial memory savings for large meshes. * Numerous small changes and fixes not listed here. 1.1.0 ===== * Switch from Jannson to RapidJSON for our JSON library (allowing for a configuration schema in 1.2.0). * Upgrade :ref:`recommended version ` of various other libraries. * :ref:`Configurable DNS refresh rate ` for DNS service discovery types. * Upstream circuit breaker configuration can be :ref:`overridden via runtime `. * :ref:`Zone aware routing support `. * Generic :ref:`header matching routing rule `. * HTTP/2 :ref:`graceful connection draining ` (double GOAWAY). * DynamoDB filter :ref:`per shard statistics ` (pre-release AWS feature). * Initial release of the :ref:`fault injection HTTP filter `. * HTTP :ref:`rate limit filter ` enhancements (note that the configuration for HTTP rate limiting is going to be overhauled in 1.2.0). * Added :ref:`refused-stream retry policy `. * Multiple :ref:`priority queues ` for upstream clusters (configurable on a per route basis, with separate connection pools, circuit breakers, etc.). * Added max connection circuit breaking to the :ref:`TCP proxy filter `. * Added :ref:`CLI ` options for setting the logging file flush interval as well as the drain/shutdown time during hot restart. * A very large number of performance enhancements for core HTTP/TCP proxy flows as well as a few new configuration flags to allow disabling expensive features if they are not needed (specifically request ID generation and dynamic response code stats). * Support Mongo 3.2 in the :ref:`Mongo sniffing filter `. * Lots of other small fixes and enhancements not listed. 1.0.0 ===== Initial open source release.