io.grpc.util

Class OutlierDetectionLoadBalancer

java.lang.Object

io.grpc.LoadBalancer

io.grpc.util.OutlierDetectionLoadBalancer

@Internal
public final class OutlierDetectionLoadBalancer
extends LoadBalancer

Wraps a child LoadBalancer while monitoring for outlier backends and removing them from the use of the child LB.

This implements the outlier detection gRFC: https://github.com/grpc/proposal/blob/master/A50-xds-outlier-detection.md

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	OutlierDetectionLoadBalancer.OutlierDetectionLoadBalancerConfig The configuration for OutlierDetectionLoadBalancer.

Nested classes/interfaces inherited from class io.grpc.LoadBalancer

LoadBalancer.CreateSubchannelArgs, LoadBalancer.Factory, LoadBalancer.Helper, LoadBalancer.PickResult, LoadBalancer.PickSubchannelArgs, LoadBalancer.ResolvedAddresses, LoadBalancer.Subchannel, LoadBalancer.SubchannelPicker, LoadBalancer.SubchannelStateListener

Field Summary

Fields inherited from class io.grpc.LoadBalancer

ATTR_HEALTH_CHECKING_CONFIG

Constructor Summary

Constructors

Constructor and Description
OutlierDetectionLoadBalancer(LoadBalancer.Helper helper, io.grpc.internal.TimeProvider timeProvider) Creates a new instance of OutlierDetectionLoadBalancer.

Method Summary

Modifier and Type	Method and Description
void	handleNameResolutionError(Status error) Handles an error from the name resolution system.
void	handleResolvedAddresses(LoadBalancer.ResolvedAddresses resolvedAddresses) Handles newly resolved server groups and metadata attributes from name resolution system.
void	shutdown() The channel asks the load-balancer to shutdown.

Methods inherited from class io.grpc.LoadBalancer

canHandleEmptyAddressListFromNameResolution, handleResolvedAddressGroups, handleSubchannelState, requestConnection

Methods inherited from class java.lang.Object

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

Constructor Detail

OutlierDetectionLoadBalancer

public OutlierDetectionLoadBalancer(LoadBalancer.Helper helper,
                                    io.grpc.internal.TimeProvider timeProvider)

Creates a new instance of OutlierDetectionLoadBalancer.

Method Detail

handleResolvedAddresses

public void handleResolvedAddresses(LoadBalancer.ResolvedAddresses resolvedAddresses)

Description copied from class: LoadBalancer

Handles newly resolved server groups and metadata attributes from name resolution system. servers contained in EquivalentAddressGroup should be considered equivalent but may be flattened into a single list if needed.

Implementations should not modify the given servers.

Overrides:

handleResolvedAddresses in class LoadBalancer

Parameters:

resolvedAddresses - the resolved server addresses, attributes, and config.

handleNameResolutionError

public void handleNameResolutionError(Status error)

Description copied from class: LoadBalancer

Handles an error from the name resolution system.

Specified by:

handleNameResolutionError in class LoadBalancer

Parameters:

error - a non-OK status

shutdown

public void shutdown()

Description copied from class: LoadBalancer

The channel asks the load-balancer to shutdown. No more methods on this class will be called after this method. The implementation should shutdown all Subchannels and OOB channels, and do any other cleanup as necessary.

Specified by:

shutdown in class LoadBalancer