.. _envoy_v3_api_file_envoy/extensions/filters/http/health_check/v3/health_check.proto: Health check ============ .. _extension_envoy.filters.http.health_check: This extension may be referenced by the qualified name *envoy.filters.http.health_check* .. note:: This extension is intended to be robust against untrusted downstream traffic. It assumes that the upstream is trusted. Health check :ref:`configuration overview `. .. _envoy_v3_api_msg_extensions.filters.http.health_check.v3.HealthCheck: extensions.filters.http.health_check.v3.HealthCheck --------------------------------------------------- `[extensions.filters.http.health_check.v3.HealthCheck proto] `_ .. code-block:: json { "pass_through_mode": "{...}", "cache_time": "{...}", "cluster_min_healthy_percentages": "{...}", "headers": [] } .. _envoy_v3_api_field_extensions.filters.http.health_check.v3.HealthCheck.pass_through_mode: pass_through_mode (`BoolValue `_, *REQUIRED*) Specifies whether the filter operates in pass through mode or not. .. _envoy_v3_api_field_extensions.filters.http.health_check.v3.HealthCheck.cache_time: cache_time (`Duration `_) If operating in pass through mode, the amount of time in milliseconds that the filter should cache the upstream response. .. _envoy_v3_api_field_extensions.filters.http.health_check.v3.HealthCheck.cluster_min_healthy_percentages: cluster_min_healthy_percentages (map<`string `_, :ref:`type.v3.Percent `>) If operating in non-pass-through mode, specifies a set of upstream cluster names and the minimum percentage of servers in each of those clusters that must be healthy or degraded in order for the filter to return a 200. .. _envoy_v3_api_field_extensions.filters.http.health_check.v3.HealthCheck.headers: headers (:ref:`config.route.v3.HeaderMatcher `) Specifies a set of health check request headers to match on. The health check filter will check a request’s headers against all the specified headers. To specify the health check endpoint, set the ``:path`` header to match on.