com.yahoo.search.dispatch.searchcluster

Class SearchCluster

java.lang.Object

com.yahoo.search.dispatch.searchcluster.SearchCluster

All Implemented Interfaces:

NodeManager<Node>

public class SearchCluster
extends Object
implements NodeManager<Node>

A model of a search cluster we might want to dispatch queries to.

Author:

bratseth

Constructor Summary

Constructors

Constructor and Description
SearchCluster(com.yahoo.vespa.config.search.DispatchConfig dispatchConfig, FS4ResourcePool fs4ResourcePool, int containerClusterSize, com.yahoo.container.handler.VipStatus vipStatus)
SearchCluster(double minActivedocsCoverage, double minGroupCoverage, int maxNodesDownPerGroup, List<Node> nodes, FS4ResourcePool fs4ResourcePool, int containerClusterSize, com.yahoo.container.handler.VipStatus vipStatus)

Method Summary

Modifier and Type	Method and Description
Optional<Node>	directDispatchTarget() Returns the recipient we should dispatch queries directly to (bypassing fdispatch), or empty if we should not dispatch directly.
void	failed(Node node) Used by the cluster monitor to manage node status
Optional<Group>	group(int n) Returns the n'th (zero-indexed) group in the cluster if possible
com.google.common.collect.ImmutableMap<Integer,Group>	groups() Returns the groups of this cluster as an immutable map indexed by group id
int	groupSize() Returns the number of nodes per group - size()/groups.size()
boolean	isPartialGroupCoverageSufficient(int groupId, List<Node> nodes) Calculate whether a subset of nodes in a group has enough coverage
com.google.common.collect.ImmutableMultimap<String,Node>	nodesByHost() Returns the nodes of this cluster as an immutable map indexed by host.
com.google.common.collect.ImmutableList<Group>	orderedGroups() Returns the groups of this cluster as an immutable list in introduction order
void	ping(Node node, Executor executor) Used by the cluster monitor to manage node status
void	pingIterationCompleted() Update statistics after a round of issuing pings.
int	size() Returns the number of nodes in this cluster (across all groups)
void	working(Node node) Used by the cluster monitor to manage node status

Methods inherited from class java.lang.Object

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

Constructor Detail

SearchCluster

public SearchCluster(com.yahoo.vespa.config.search.DispatchConfig dispatchConfig,
                     FS4ResourcePool fs4ResourcePool,
                     int containerClusterSize,
                     com.yahoo.container.handler.VipStatus vipStatus)

SearchCluster

public SearchCluster(double minActivedocsCoverage,
                     double minGroupCoverage,
                     int maxNodesDownPerGroup,
                     List<Node> nodes,
                     FS4ResourcePool fs4ResourcePool,
                     int containerClusterSize,
                     com.yahoo.container.handler.VipStatus vipStatus)

Method Detail

size

public int size()

Returns the number of nodes in this cluster (across all groups)

groups

public com.google.common.collect.ImmutableMap<Integer,Group> groups()

Returns the groups of this cluster as an immutable map indexed by group id

orderedGroups

public com.google.common.collect.ImmutableList<Group> orderedGroups()

Returns the groups of this cluster as an immutable list in introduction order

group

public Optional<Group> group(int n)

Returns the n'th (zero-indexed) group in the cluster if possible

groupSize

public int groupSize()

Returns the number of nodes per group - size()/groups.size()

nodesByHost

public com.google.common.collect.ImmutableMultimap<String,Node> nodesByHost()

Returns the nodes of this cluster as an immutable map indexed by host. One host may contain multiple nodes (on different ports), so this is a multi-map.

directDispatchTarget

public Optional<Node> directDispatchTarget()

Returns the recipient we should dispatch queries directly to (bypassing fdispatch), or empty if we should not dispatch directly.

working

public void working(Node node)

Used by the cluster monitor to manage node status

Specified by:

working in interface NodeManager<Node>

failed

public void failed(Node node)

Used by the cluster monitor to manage node status

Specified by:

failed in interface NodeManager<Node>

ping

public void ping(Node node,
                 Executor executor)

Used by the cluster monitor to manage node status

Specified by:

ping in interface NodeManager<Node>

pingIterationCompleted

public void pingIterationCompleted()

Update statistics after a round of issuing pings. Note that this doesn't wait for pings to return, so it will typically accumulate data from last rounds pinging, or potentially (although unlikely) some combination of new and old data.

Specified by:

pingIterationCompleted in interface NodeManager<Node>

isPartialGroupCoverageSufficient

public boolean isPartialGroupCoverageSufficient(int groupId,
                                                List<Node> nodes)

Calculate whether a subset of nodes in a group has enough coverage