io.envoyproxy.envoy.service.discovery.v2

Class HealthDiscoveryService

java.lang.Object

io.envoyproxy.envoy.service.discovery.v2.HealthDiscoveryService

All Implemented Interfaces:

com.google.protobuf.Service

Direct Known Subclasses:

HealthDiscoveryService.Stub

public abstract class HealthDiscoveryService
extends Object
implements com.google.protobuf.Service

 HDS is Health Discovery Service. It compliments Envoy’s health checking
 service by designating this Envoy to be a healthchecker for a subset of hosts
 in the cluster. The status of these health checks will be reported to the
 management server, where it can be aggregated etc and redistributed back to
 Envoy through EDS.
 

Protobuf service envoy.service.discovery.v2.HealthDiscoveryService

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	HealthDiscoveryService.BlockingInterface
static interface	HealthDiscoveryService.Interface
static class	HealthDiscoveryService.Stub

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	HealthDiscoveryService()

Method Summary

Modifier and Type	Method and Description
void	callMethod(com.google.protobuf.Descriptors.MethodDescriptor method, com.google.protobuf.RpcController controller, com.google.protobuf.Message request, com.google.protobuf.RpcCallback<com.google.protobuf.Message> done)
abstract void	fetchHealthCheck(com.google.protobuf.RpcController controller, HealthCheckRequestOrEndpointHealthResponse request, com.google.protobuf.RpcCallback<HealthCheckSpecifier> done) TODO(htuch): Unlike the gRPC version, there is no stream-based binding of request/response.
static com.google.protobuf.Descriptors.ServiceDescriptor	getDescriptor()
com.google.protobuf.Descriptors.ServiceDescriptor	getDescriptorForType()
com.google.protobuf.Message	getRequestPrototype(com.google.protobuf.Descriptors.MethodDescriptor method)
com.google.protobuf.Message	getResponsePrototype(com.google.protobuf.Descriptors.MethodDescriptor method)
static HealthDiscoveryService.BlockingInterface	newBlockingStub(com.google.protobuf.BlockingRpcChannel channel)
static com.google.protobuf.BlockingService	newReflectiveBlockingService(HealthDiscoveryService.BlockingInterface impl)
static com.google.protobuf.Service	newReflectiveService(HealthDiscoveryService.Interface impl)
static HealthDiscoveryService.Stub	newStub(com.google.protobuf.RpcChannel channel)
abstract void	streamHealthCheck(com.google.protobuf.RpcController controller, HealthCheckRequestOrEndpointHealthResponse request, com.google.protobuf.RpcCallback<HealthCheckSpecifier> done) 1.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

HealthDiscoveryService

protected HealthDiscoveryService()

Method Detail

newReflectiveService

public static com.google.protobuf.Service newReflectiveService(HealthDiscoveryService.Interface impl)

newReflectiveBlockingService

public static com.google.protobuf.BlockingService newReflectiveBlockingService(HealthDiscoveryService.BlockingInterface impl)

streamHealthCheck

public abstract void streamHealthCheck(com.google.protobuf.RpcController controller,
                                       HealthCheckRequestOrEndpointHealthResponse request,
                                       com.google.protobuf.RpcCallback<HealthCheckSpecifier> done)

 1. Envoy starts up and if its can_healthcheck option in the static
    bootstrap config is enabled, sends HealthCheckRequest to the management
    server. It supplies its capabilities (which protocol it can health check
    with, what zone it resides in, etc.).
 2. In response to (1), the management server designates this Envoy as a
    healthchecker to health check a subset of all upstream hosts for a given
    cluster (for example upstream Host 1 and Host 2). It streams
    HealthCheckSpecifier messages with cluster related configuration for all
    clusters this Envoy is designated to health check. Subsequent
    HealthCheckSpecifier message will be sent on changes to:
    a. Endpoints to health checks
    b. Per cluster configuration change
 3. Envoy creates a health probe based on the HealthCheck config and sends
    it to endpoint(ip:port) of Host 1 and 2. Based on the HealthCheck
    configuration Envoy waits upon the arrival of the probe response and
    looks at the content of the response to decide whether the endpoint is
    healthy or not. If a response hasn't been received within the timeout
    interval, the endpoint health status is considered TIMEOUT.
 4. Envoy reports results back in an EndpointHealthResponse message.
    Envoy streams responses as often as the interval configured by the
    management server in HealthCheckSpecifier.
 5. The management Server collects health statuses for all endpoints in the
    cluster (for all clusters) and uses this information to construct
    EndpointDiscoveryResponse messages.
 6. Once Envoy has a list of upstream endpoints to send traffic to, it load
    balances traffic to them without additional health checking. It may
    use inline healthcheck (i.e. consider endpoint UNHEALTHY if connection
    failed to a particular endpoint to account for health status propagation
    delay between HDS and EDS).
 By default, can_healthcheck is true. If can_healthcheck is false, Cluster
 configuration may not contain HealthCheck message.
 TODO(htuch): How is can_healthcheck communicated to CDS to ensure the above
 invariant?
 TODO(htuch): Add @amb67's diagram.
 

rpc StreamHealthCheck(stream .envoy.service.discovery.v2.HealthCheckRequestOrEndpointHealthResponse) returns (stream .envoy.service.discovery.v2.HealthCheckSpecifier);

fetchHealthCheck

public abstract void fetchHealthCheck(com.google.protobuf.RpcController controller,
                                      HealthCheckRequestOrEndpointHealthResponse request,
                                      com.google.protobuf.RpcCallback<HealthCheckSpecifier> done)

 TODO(htuch): Unlike the gRPC version, there is no stream-based binding of
 request/response. Should we add an identifier to the HealthCheckSpecifier
 to bind with the response?
 

rpc FetchHealthCheck(.envoy.service.discovery.v2.HealthCheckRequestOrEndpointHealthResponse) returns (.envoy.service.discovery.v2.HealthCheckSpecifier) { ... }

getDescriptor

public static final com.google.protobuf.Descriptors.ServiceDescriptor getDescriptor()

getDescriptorForType

public final com.google.protobuf.Descriptors.ServiceDescriptor getDescriptorForType()

Specified by:

getDescriptorForType in interface com.google.protobuf.Service

callMethod

public final void callMethod(com.google.protobuf.Descriptors.MethodDescriptor method,
                             com.google.protobuf.RpcController controller,
                             com.google.protobuf.Message request,
                             com.google.protobuf.RpcCallback<com.google.protobuf.Message> done)

Specified by:

callMethod in interface com.google.protobuf.Service

getRequestPrototype

public final com.google.protobuf.Message getRequestPrototype(com.google.protobuf.Descriptors.MethodDescriptor method)

Specified by:

getRequestPrototype in interface com.google.protobuf.Service

getResponsePrototype

public final com.google.protobuf.Message getResponsePrototype(com.google.protobuf.Descriptors.MethodDescriptor method)

Specified by:

getResponsePrototype in interface com.google.protobuf.Service

newStub

public static HealthDiscoveryService.Stub newStub(com.google.protobuf.RpcChannel channel)

newBlockingStub

public static HealthDiscoveryService.BlockingInterface newBlockingStub(com.google.protobuf.BlockingRpcChannel channel)