org.apache.hadoop.hbase

Class ClusterStatus

java.lang.Object

org.apache.hadoop.hbase.ClusterStatus

@InterfaceAudience.Public
public class ClusterStatus
extends Object

Status information on the HBase cluster.

ClusterStatus provides clients with information such as:

• The count and names of region servers in the cluster.
• The count and names of dead region servers in the cluster.
• The name of the active master for the cluster.
• The name(s) of the backup master(s) for the cluster, if they exist.
• The average cluster load.
• The number of regions deployed on the cluster.
• The number of requests since last report.
• Detailed region server loading and resource usage information, per server and per region.
• Regions in transition at master
• The unique cluster ID

ClusterStatus.Option provides a way to get desired ClusterStatus information. The following codes will get all the cluster information.

 
 // Original version still works
 Admin admin = connection.getAdmin();
 ClusterStatus status = admin.getClusterStatus();
 // or below, a new version which has the same effects
 ClusterStatus status = admin.getClusterStatus(EnumSet.allOf(Option.class));
 
 

If information about live servers is the only wanted. then codes in the following way:

 
 Admin admin = connection.getAdmin();
 ClusterStatus status = admin.getClusterStatus(EnumSet.of(Option.LIVE_SERVERS));
 
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ClusterStatus.Builder Builder for construct a ClusterStatus.
static class	ClusterStatus.Option Kinds of ClusterStatus

Constructor Summary

Constructors

Constructor and Description
ClusterStatus(String hbaseVersion, String clusterid, Map<ServerName,ServerLoad> servers, Collection<ServerName> deadServers, ServerName master, Collection<ServerName> backupMasters, List<RegionState> rit, String[] masterCoprocessors, Boolean balancerOn, int masterInfoPort) Deprecated. As of release 2.0.0, this will be removed in HBase 3.0.0 (HBASE-15511).

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object o)
double	getAverageLoad()
Collection<ServerName>	getBackupMasters()
int	getBackupMastersSize()
Boolean	getBalancerOn()
String	getClusterId()
Collection<ServerName>	getDeadServerNames()
int	getDeadServers() Deprecated. As of release 2.0.0, this will be removed in HBase 3.0.0 (HBASE-13656). Use getDeadServersSize().
int	getDeadServersSize()
String	getHBaseVersion()
long	getLastMajorCompactionTsForRegion(byte[] region)
long	getLastMajorCompactionTsForTable(TableName table)
ServerLoad	getLoad(ServerName sn)
ServerName	getMaster() Returns detailed information about the current master ServerName.
String[]	getMasterCoprocessors()
int	getMasterInfoPort()
int	getRegionsCount()
List<RegionState>	getRegionsInTransition()
int	getRequestsCount()
Collection<ServerName>	getServers()
int	getServersSize()
byte	getVersion() Deprecated. As of release 2.0.0, this will be removed in HBase 3.0.0
int	hashCode()
boolean	isBalancerOn()
static ClusterStatus.Builder	newBuilder()
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ClusterStatus

@Deprecated
public ClusterStatus(String hbaseVersion,
                                 String clusterid,
                                 Map<ServerName,ServerLoad> servers,
                                 Collection<ServerName> deadServers,
                                 ServerName master,
                                 Collection<ServerName> backupMasters,
                                 List<RegionState> rit,
                                 String[] masterCoprocessors,
                                 Boolean balancerOn,
                                 int masterInfoPort)

Deprecated. As of release 2.0.0, this will be removed in HBase 3.0.0 (HBASE-15511).

Use ClusterStatus.Builder to construct a ClusterStatus instead.

Method Detail

getDeadServerNames

public Collection<ServerName> getDeadServerNames()

Returns:

the names of region servers on the dead list

getServersSize

public int getServersSize()

Returns:

the number of region servers in the cluster

getDeadServers

@Deprecated
public int getDeadServers()

Deprecated. As of release 2.0.0, this will be removed in HBase 3.0.0 (HBASE-13656). Use getDeadServersSize().

Returns:

the number of dead region servers in the cluster

getDeadServersSize

public int getDeadServersSize()

Returns:

the number of dead region servers in the cluster

getAverageLoad

public double getAverageLoad()

Returns:

the average cluster load

getRegionsCount

public int getRegionsCount()

Returns:

the number of regions deployed on the cluster

getRequestsCount

public int getRequestsCount()

Returns:

the number of requests since last report

getHBaseVersion

public String getHBaseVersion()

Returns:

the HBase version string as reported by the HMaster

equals

public boolean equals(Object o)

Overrides:

equals in class Object

See Also:

Object.equals(java.lang.Object)

hashCode

public int hashCode()

Overrides:

hashCode in class Object

See Also:

Object.hashCode()

getVersion

@Deprecated
public byte getVersion()

Deprecated. As of release 2.0.0, this will be removed in HBase 3.0.0

Returns:

the object version number

getServers

public Collection<ServerName> getServers()

getMaster

public ServerName getMaster()

Returns detailed information about the current master ServerName.

Returns:

current master information if it exists

getBackupMastersSize

public int getBackupMastersSize()

Returns:

the number of backup masters in the cluster

getBackupMasters

public Collection<ServerName> getBackupMasters()

Returns:

the names of backup masters

getLoad

public ServerLoad getLoad(ServerName sn)

Parameters:

sn -

Returns:

Server's load or null if not found.

getRegionsInTransition

@InterfaceAudience.Private
public List<RegionState> getRegionsInTransition()

getClusterId

public String getClusterId()

getMasterCoprocessors

public String[] getMasterCoprocessors()

getLastMajorCompactionTsForTable

public long getLastMajorCompactionTsForTable(TableName table)

getLastMajorCompactionTsForRegion

public long getLastMajorCompactionTsForRegion(byte[] region)

isBalancerOn

public boolean isBalancerOn()

getBalancerOn

public Boolean getBalancerOn()

getMasterInfoPort

public int getMasterInfoPort()

toString

public String toString()

Overrides:

toString in class Object

newBuilder

public static ClusterStatus.Builder newBuilder()