Version history¶
1.7.0¶
- access log: added ability to log response trailers.
- access log: added ability to format START_TIME.
- access log: added DYNAMIC_METADATA access log formatter.
- access log: added HeaderFilter to filter logs based on request headers.
- access log: added %([1-9])?f as one of START_TIME specifiers to render subseconds.
- access log: gRPC Access Log Service (ALS) support added for HTTP access logs.
- access log: improved WebSocket logging.
- admin: added
GET /config_dump
for dumping the current configuration and associated xDS version information (if applicable). - admin: added
GET /stats/prometheus
as an alternative endpoint for getting stats in prometheus format. - admin: added /runtime_modify endpoint to add or change runtime values.
- admin: mutations must be sent as POSTs, rather than GETs. Mutations include:
POST /cpuprofiler
,POST /healthcheck/fail
,POST /healthcheck/ok
,POST /logging
,POST /quitquitquit
,POST /reset_counters
,POST /runtime_modify?key1=value1&key2=value2&keyN=valueN
. - admin: removed /routes endpoint; route configs can now be found at the /config_dump endpoint.
- buffer filter: the buffer filter can be optionally disabled or overridden with route-local configuration.
- cli: added –config-yaml flag to the Envoy binary. When set its value is interpreted as a yaml representation of the bootstrap config and overrides –config-path.
- cluster: added option to close tcp_proxy upstream connections when health checks fail.
- cluster: added option to drain connections from hosts after they are removed from service discovery, regardless of health status.
- cluster: fixed bug preventing the deletion of all endpoints in a priority.
- debug: added symbolized stack traces (where supported).
- grpc: support added for the full set of Google gRPC call credentials.
- gzip filter: added stats to the filter.
- gzip filter: sending accept-encoding header as identity no longer compresses the payload.
- health check: added ability to set additional HTTP headers for HTTP health check.
- health check: added support for EDS delivered endpoint health status.
- health check: added interval overrides for health state transitions from healthy to unhealthy, unhealthy to healthy and for subsequent checks on unhealthy hosts.
- health check: added support for custom health check.
- health check: health check connections can now be configured to use http/2.
- health check http filter: added generic header matching to trigger health check response. Deprecated the endpoint option.
- http: filters can now optionally support virtual host, route, and weighted cluster local configuration.
- http: added the ability to pass DNS type Subject Alternative Names of the client certificate in the x-forwarded-client-cert header.
- http: local responses to gRPC requests are now sent as trailers-only gRPC responses instead of plain HTTP responses. Notably the HTTP response code is always “200” in this case, and the gRPC error code is carried in “grpc-status” header, optionally accompanied with a text message in “grpc-message” header.
- http: added support for via header append.
- http: added a configuration option to elide x-forwarded-for header modifications.
- http: fixed a bug in inline headers where addCopy and addViaMove didn’t add header values when encountering inline headers with multiple instances.
- listeners: added tcp_fast_open_queue_length option.
- listeners: added the ability to match FilterChain using application_protocols (e.g. ALPN for TLS protocol).
- listeners: sni_domains has been deprecated/renamed to server_names.
- listeners: removed restriction on all filter chains having identical filters.
- load balancer: added weighted round robin support. The round robin scheduler now respects endpoint weights and also has improved fidelity across picks.
- load balancer: locality weighted load balancing is now supported.
- load balancer: ability to configure zone aware load balancer settings through the API.
- load balancer: the weighted least request load balancing algorithm has been improved to have better balance when operating in weighted mode.
- logger: added the ability to optionally set the log format via the
--log-format
option. - logger: all logging levels can be configured at run-time: trace debug info warning error critical.
- rbac http filter: a role-based access control http filter has been added.
- router: the behavior of per-try timeouts have changed in the case where a portion of the response has already been proxied downstream when the timeout occurs. Previously, the response would be reset leading to either an HTTP/2 reset or an HTTP/1 closed connection and a partial response. Now, the timeout will be ignored and the response will continue to proxy up to the global request timeout.
- router: changed the behavior of source IP routing to ignore the source port.
- router: added an prefix_match match type to explicitly match based on the prefix of a header value.
- router: added an suffix_match match type to explicitly match based on the suffix of a header value.
- router: added an present_match match type to explicitly match based on a header’s presence.
- router: added an invert_match config option which supports inverting all other match types to match based on headers which are not a desired value.
- router: allow cookie routing to generate session cookies.
- router: added START_TIME as one of supported variables in header formatters.
- router: added a max_grpc_timeout config option to specify the maximum allowable value for timeouts decoded from gRPC header field grpc-timeout.
- router: added a configuration option to disable x-envoy- header generation.
- router: added ‘unavailable’ to the retriable gRPC status codes that can be specified through x-envoy-retry-grpc-on.
- sockets: added capture transport socket extension to support recording plain text traffic and PCAP generation.
- sockets: added IP_FREEBIND socket option support for listeners and upstream connections via cluster manager wide and cluster specific options.
- sockets: added IP_TRANSPARENT socket option support for listeners.
- sockets: added SO_KEEPALIVE socket option for upstream connections per cluster.
- stats: added support for histograms.
- stats: added option to configure the statsd prefix.
- stats: updated stats sink interface to flush through a single call.
- tls: added support for verify_certificate_spki.
- tls: added support for multiple verify_certificate_hash values.
- tls: added support for using verify_certificate_spki and verify_certificate_hash without trusted_ca.
- tls: added support for allowing expired certificates with allow_expired_certificate.
- tls: added support for renegotiation when acting as a client.
- tls: removed support for legacy SHA-2 CBC cipher suites.
- tracing: the sampling decision is now delegated to the tracers, allowing the tracer to decide when and if to use it. For example, if the x-b3-sampled header is supplied with the client request, its value will override any sampling decision made by the Envoy proxy.
- websocket: support configuring idle_timeout and max_connect_attempts.
- upstream: added support for host override for a request in Original destination host request header.
- header to metadata: added HTTP Header to Metadata filter.
1.6.0 (March 20, 2018)¶
- access log: added DOWNSTREAM_REMOTE_ADDRESS, DOWNSTREAM_REMOTE_ADDRESS_WITHOUT_PORT, and DOWNSTREAM_LOCAL_ADDRESS access log formatters. DOWNSTREAM_ADDRESS access log formatter has been deprecated.
- access log: added less than or equal (LE) comparison filter.
- access log: added configuration to runtime filter to set default sampling rate, divisor, and whether to use independent randomness or not.
- admin: added /runtime admin endpoint to read the current runtime values.
- build: added support for 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 DiscoveryRequest.
- config: added support for inline delivery of TLS certificates and private keys.
- config: added restrictions for the backing 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 gRPC services overview and GrpcService.
- grpc-json: added support for inline descriptors.
- health check: added gRPC health check based on grpc.health.v1.Health service.
- health check: added ability to set 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 percentage of healthy servers in upstream clusters.
- health check: added setting for no-traffic interval.
- http: added idle timeout for upstream http connections.
- http: added support for proxying 100-Continue responses.
- http: added the ability to pass a URL encoded PEM encoded peer certificate in the x-forwarded-client-cert header.
- http: added support for trusting additional hops in the x-forwarded-for request header.
- http: added support for incoming HTTP/1.0.
- hot restart: added SIGTERM propagation to children to hot-restarter.py, which enables using it as a parent of containers.
- ip tagging: added HTTP IP Tagging filter.
- listeners: added support for listening for both IPv4 and IPv6 when binding to ::.
- listeners: added support for listening on UNIX domain sockets.
- listeners: added support for abstract unix domain sockets on Linux. The abstract namespace can be used by prepending ‘@’ to a socket path.
- load balancer: added cluster configuration for healthy panic threshold percentage.
- load balancer: added Maglev consistent hash load balancer.
- load balancer: added support for LocalityLbEndpoints priorities.
- lua: added headers replace() API.
- lua: extended to support metadata object API.
- redis: added local PING support to the Redis filter.
- redis: added GEORADIUS_RO and GEORADIUSBYMEMBER_RO to the Redis command splitter whitelist.
- router: added DOWNSTREAM_REMOTE_ADDRESS_WITHOUT_PORT, DOWNSTREAM_LOCAL_ADDRESS, DOWNSTREAM_LOCAL_ADDRESS_WITHOUT_PORT, PROTOCOL, and UPSTREAM_METADATA header formatters. The CLIENT_IP header formatter has been deprecated.
- router: added gateway-error retry-on policy.
- router: added support for route matching based on URL query string parameters.
- router: added support for more granular weighted cluster routing by allowing the total_weight to be specified in configuration.
- router: added support for custom request/response headers with mixed static and dynamic values.
- router: added support for direct responses. I.e., sending a preconfigured HTTP response without proxying anywhere.
- router: added support for HTTPS redirects on specific routes.
- router: added support for prefix_rewrite for redirects.
- router: added support for stripping the query string for redirects.
- router: added support for downstream request/upstream response header manipulation in weighted cluster.
- router: added support for range based header matching for request routing.
- squash: added support for the Squash microservices debugger. Allows debugging an incoming request to a microservice in the mesh.
- stats: added metrics service API implementation.
- stats: added native DogStatsd support.
- stats: added support for fixed stats tag values which will be added to all metrics.
- tcp proxy: added support for specifying a metadata matcher for upstream clusters in the tcp filter.
- tcp proxy: improved TCP proxy to correctly proxy TCP half-close.
- tcp proxy: added idle timeout.
- tcp proxy: access logs now bring an IP address without a port when using DOWNSTREAM_ADDRESS. Use DOWNSTREAM_REMOTE_ADDRESS instead.
- tracing: added support for dynamically loading an OpenTracing tracer.
- tracing: when using the Zipkin tracer, it is now possible for clients to specify the sampling decision (using the 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 x-ot-span-context header. See more on trace context propagation 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 alternate stats name while emitting stats for clusters.
- Many small bug fixes and performance improvements not listed.
1.5.0 (December 4, 2017)¶
- access log: added fields for UPSTREAM_LOCAL_ADDRESS and DOWNSTREAM_ADDRESS.
- admin: added JSON output for stats admin endpoint.
- admin: added basic Prometheus output for stats admin endpoint. Histograms are not currently output.
- admin: added
version_info
to the /clusters admin endpoint. - config: the v2 API is now considered production ready.
- config: added
--v2-config-only
CLI flag. - cors: added CORS filter.
- health check: added x-envoy-immediate-health-check-fail header support.
- health check: added reuse_connection option.
- http: added per-listener stats.
- http: end-to-end HTTP flow control is now complete across both connections, streams, and filters.
- load balancer: added subset load balancer.
- load balancer: added ring size and hash 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
--log-path
option. - listeners: added drain_type option.
- lua: added experimental Lua filter.
- mongo filter: added fault injection.
- mongo filter: added “drain close” support.
- outlier detection: added HTTP gateway failure type. See DEPRECATED.md for outlier detection stats deprecations in this release.
- redis: the redis proxy filter is now considered production ready.
- redis: added “drain close” functionality.
- router: added x-envoy-overloaded support.
- router: added regex route matching.
- router: added custom request headers for upstream requests.
- router: added downstream IP hashing for HTTP ketama routing.
- router: added cookie hashing.
- router: added start_child_span option to create child span for egress calls.
- router: added optional upstream logs.
- router: added complete custom append/override/remove support of request/response headers.
- router: added support to specify response code during redirect.
- router: added configuration to return either a 404 or 503 if the upstream cluster does not exist.
- runtime: added comment capability.
- server: change default log level (
-l
) to info. - stats: maximum stat/name sizes and maximum number of stats are now variable via the
--max-obj-name-len
and--max-stats
options. - tcp proxy: added access logging.
- tcp proxy: added configurable connect retries.
- tcp proxy: enable use of outlier detector.
- tls: added SNI support.
- tls: added support for specifying TLS session ticket keys.
- tls: allow configuration of the min and max TLS protocol versions.
- tracing: added custom trace span decorators.
- Many small bug fixes and performance improvements not listed.
1.4.0 (August 24, 2017)¶
- macOS is now supported. (A few features are missing such as hot restart and original destination routing).
- YAML is now directly supported for config files.
- Added /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 compile time flag added.
- Hot restart compile time flag added.
- Original destination cluster and load balancer added.
- 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 validate_clusters option added.
- x-envoy-downstream-service-node header added.
- x-forwarded-client-cert header added.
- Initial HTTP/1 forward proxy support for absolute URLs has been added.
- HTTP/2 codec settings are now configurable.
- gRPC/JSON transcoder filter added.
- gRPC web filter added.
- Configurable timeout for the rate limit service call in the network and HTTP rate limit filters.
- x-envoy-retry-grpc-on header added.
- LDS API added.
- TLS require_client_certificate option added.
- Configuration check tool added.
- JSON schema check tool added.
- Config validation mode added via the
--mode
option. --local-address-ip-version
option added.- IPv6 support is now complete.
- UDP statsd_ip_address option added.
- Per-cluster DNS resolvers added.
- Fault filter enhancements and fixes.
- Several features are 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 (May 17, 2017)¶
- As of this release, we now have an official 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 /bazel/README.md and /ci/README.md for more information.
- 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 listener and 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.
- Redis health checking has been added as an active health check type. Full Redis support will be documented/supported in 1.4.0.
- 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 listener and cluster connections.
- The header value match 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 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 request_headers_to_add option.
- The example configurations have been refreshed to demonstrate the latest features.
- per_try_timeout_ms can now be configured in a route’s retry policy in addition to via the x-envoy-upstream-rq-per-try-timeout-ms HTTP header.
- 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 runtime.
- HTTP tracing configuration has been extended to allow tags to be populated from arbitrary HTTP headers.
- The HTTP rate limit filter can now be applied to internal, external, or all requests via the request_type option.
- 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 MongoDB filter now emits a stat for queries that do not have $maxTimeMS set.
- The MongoDB filter now emits logs that are fully valid JSON.
- The CPU profiler output path is now configurable.
- A watchdog system has been added that can kill the server if a deadlock is detected.
- A route table checking tool has been added that can be used to test route tables before use.
- We have added an example repo that shows how to compile/link a custom filter.
- Added additional cluster wide information related to outlier detection to the /clusters admin endpoint.
- Multiple SANs can now be verified via the verify_subject_alt_name setting. Additionally, URI type SANs can be verified.
- HTTP filters can now be passed 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 tracing provider.
- Numerous small changes and fixes not listed here.
1.2.0 (March 7, 2017)¶
- Cluster discovery service (CDS) API.
- Outlier detection (passive health checking).
- Envoy configuration is now checked against a JSON schema.
- Ring hash consistent load balancer, as well as HTTP consistent hash routing based on a policy.
- Vastly enhanced global rate limit configuration via the HTTP rate limiting filter.
- HTTP routing to a cluster retrieved from a header.
- Weighted cluster HTTP routing.
- Auto host rewrite during HTTP routing.
- Regex header matching during HTTP routing.
- HTTP access log runtime filter.
- LightStep tracer parent/child span association.
- Route discovery service (RDS) API.
- HTTP router x-envoy-upstream-rq-timeout-alt-response header support.
- use_original_dst and bind_to_port listener options (useful for iptables based transparent proxy support).
- TCP proxy filter route table support.
- Configurable stats flush interval.
- Various 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 (November 30, 2016)¶
- Switch from Jannson to RapidJSON for our JSON library (allowing for a configuration schema in 1.2.0).
- Upgrade recommended version of various other libraries.
- Configurable DNS refresh rate for DNS service discovery types.
- Upstream circuit breaker configuration can be overridden via runtime.
- Zone aware routing support.
- Generic header matching routing rule.
- HTTP/2 graceful connection draining (double GOAWAY).
- DynamoDB filter per shard statistics (pre-release AWS feature).
- Initial release of the fault injection HTTP filter.
- HTTP rate limit filter enhancements (note that the configuration for HTTP rate limiting is going to be overhauled in 1.2.0).
- Added refused-stream retry policy.
- Multiple 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 TCP proxy filter.
- Added 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 Mongo sniffing filter.
- Lots of other small fixes and enhancements not listed.
1.0.0 (September 12, 2016)¶
Initial open source release.