Compressor

• v3 API reference

• This filter should be configured with the name envoy.filters.http.compressor.

When compressor filter is enabled, request and response headers are inspected to determine whether or not the content should be compressed. The content is compressed and then sent to the client with the appropriate headers, if response and request allow.

Currently the filter supports and brotli compression only. Other compression libraries can be supported as extensions.

An example configuration of the filter may look like the following:

By default request compression is disabled, but when enabled it will be skipped if:

• A request does not contain a content-type value that matches one of the selected mime-types, which default to application/javascript, application/json, application/xhtml+xml, image/svg+xml, text/css, text/html, text/plain, text/xml.

• content-length header is not present in the request.

• A request contains a content-encoding header.

• A request contains a transfer-encoding header whose value includes a known compression name.

By default response compression is enabled, but it will be skipped when:

• A request does NOT contain accept-encoding header.

• A request includes accept-encoding header, but it does not contain “gzip” or “*”.

• A request includes accept-encoding with “gzip” or “*” with the weight “q=0”. Note that the “gzip” will have a higher weight then “*”. For example, if accept-encoding is “gzip;q=0,*;q=1”, the filter will not compress. But if the header is set to “*;q=0,gzip;q=1”, the filter will compress.

• A request whose accept-encoding header includes any encoding type with a higher weight than “gzip“‘s given the corresponding compression filter is present in the chain.

• A response contains a content-encoding header.

• A response contains a cache-control header whose value includes “no-transform”.

• A response contains a transfer-encoding header whose value includes a known compression name.

• A response does not contain a content-type value that matches one of the selected mime-types, which default to application/javascript, application/json, application/xhtml+xml, image/svg+xml, text/css, text/html, text/plain, text/xml.

• Neither content-length nor transfer-encoding headers are present in the response.

• Response size is smaller than 30 bytes (only applicable when transfer-encoding is not chunked).

Please note that in case the filter is configured to use a compression library extension other than gzip it looks for content encoding in the accept-encoding header provided by the extension.

When response compression is applied:

• The content-length is removed from response headers.

• The “vary: accept-encoding” header is inserted on every response.

Also the “vary: accept-encoding” header may be inserted even if compression is not applied due to incompatible “accept-encoding” header in a request. This happens when the requested resource still can be compressed given compatible “accept-encoding”. Otherwise, if an uncompressed response is cached by a caching proxy in front of Envoy, the proxy won’t know to fetch a new incoming request with compatible “accept-encoding” from upstream.

When request compression is applied:

• content-length is removed from request headers.

• content-encoding with the compression scheme used (e.g., gzip) is added to request headers.

If different compression libraries are desired for requests and responses, it is possible to install multiple compressor filters enabled only for requests or responses. For instance:

http_filters:
# This filter is only enabled for responses.
- name: envoy.filters.http.compressor
  typed_config:
    "@type": type.googleapis.com/envoy.extensions.filters.http.compressor.v3.Compressor
    request_direction_config:
      common_config:
        enabled:
          default_value: false
          runtime_key: request_compressor_enabled
    compressor_library:
      name: for_response
        "@type": type.googleapis.com/envoy.extensions.compression.gzip.compressor.v3.Gzip
        memory_level: 3
        window_bits: 10
        compression_level: best_compression
        compression_strategy: default_strategy
- name: envoy.filters.http.compressor
  typed_config:
    "@type": type.googleapis.com/envoy.extensions.filters.http.compressor.v3.Compressor
    response_direction_config:
      common_config:
        enabled:
          default_value: false
    request_direction_config:
      common_config:
        enabled:
          default_value: true
          runtime_key: request_compressor_enabled
    compressor_library:
      name: for_request
      typed_config:
        "@type": type.googleapis.com/envoy.extensions.compression.gzip.compressor.v3.Gzip
        memory_level: 9
        window_bits: 15
        compression_level: best_speed
        compression_strategy: default_strategy

Every configured Compressor filter has statistics rooted at <stat_prefix>.compressor.<compressor_library.name>.<compressor_library_stat_prefix>.<direction_prefix>.* with the following:

In addition to the statics common for requests and responses there are statistics specific to responses only: