Package de.zib.scalaris.jmx

Interface MonitorNodeMBean

All Known Implementing Classes:

MonitorNode

public interface MonitorNodeMBean

Provides methods to monitor a specific Scalaris (Erlang) VM via JMX.

Since:

3.15

Version:

3.15

Author:

Nico Kruber, kruber@zib.de

Method Summary

Modifier and Type	Method	Description
java.lang.Double	getCurLatencyAvg()	Gets the current, i.e.
java.lang.Double	getCurLatencyStddev()	Gets the current, i.e.
int	getDhtNodes()	Gets the number of Scalaris nodes running in the VM the monitor is connected to.
java.lang.String	getErlangVersion()	Gets the version of Erlang running in the VM the monitor is connected to.
java.util.Map<java.lang.Long,java.lang.Double>	getLatencyAvg()	Gets average latency values collected in the VM the monitor is connected to.
java.util.Map<java.lang.Long,java.lang.Double>	getLatencyStddev()	Gets the standard deviation of the latency values collected in the VM the monitor is connected to.
java.lang.String	getScalarisVersion()	Gets the version of Scalaris running in the VM the monitor is connected to.

Method Detail

getScalarisVersion

java.lang.String getScalarisVersion()
                             throws ConnectionException,
                                    UnknownException

Gets the version of Scalaris running in the VM the monitor is connected to.

Returns:

version string

Throws:

ConnectionException - if the connection is not active or a communication error occurs or an exit signal was received or the remote node sends a message containing an invalid cookie

UnknownException - if any other error occurs

getErlangVersion

java.lang.String getErlangVersion()
                           throws ConnectionException,
                                  UnknownException

Gets the version of Erlang running in the VM the monitor is connected to.

Returns:

version string

Throws:

ConnectionException - if the connection is not active or a communication error occurs or an exit signal was received or the remote node sends a message containing an invalid cookie

UnknownException - if any other error occurs

getDhtNodes

int getDhtNodes()
         throws ConnectionException,
                UnknownException

Gets the number of Scalaris nodes running in the VM the monitor is connected to.

Returns:

number of DHT nodes

Throws:

ConnectionException - if the connection is not active or a communication error occurs or an exit signal was received or the remote node sends a message containing an invalid cookie

UnknownException - if any other error occurs

getLatencyAvg

java.util.Map<java.lang.Long,java.lang.Double> getLatencyAvg()
                                                      throws ConnectionException,
                                                             UnknownException

Gets average latency values collected in the VM the monitor is connected to.

Returns:

map of timestamps to average latencies

Throws:

ConnectionException - if the connection is not active or a communication error occurs or an exit signal was received or the remote node sends a message containing an invalid cookie

UnknownException - if any other error occurs

getLatencyStddev

java.util.Map<java.lang.Long,java.lang.Double> getLatencyStddev()
                                                         throws ConnectionException,
                                                                UnknownException

Gets the standard deviation of the latency values collected in the VM the monitor is connected to.

Returns:

map of timestamps to latency (standard) deviation

Throws:

ConnectionException - if the connection is not active or a communication error occurs or an exit signal was received or the remote node sends a message containing an invalid cookie

UnknownException - if any other error occurs

getCurLatencyAvg

java.lang.Double getCurLatencyAvg()
                           throws ConnectionException,
                                  UnknownException

Gets the current, i.e. latest, average latency collected in the VM the monitor is connected to.

Returns:

latest average latency (or null if there is none)

Throws:

ConnectionException - if the connection is not active or a communication error occurs or an exit signal was received or the remote node sends a message containing an invalid cookie

UnknownException - if any other error occurs

getCurLatencyStddev

java.lang.Double getCurLatencyStddev()
                              throws ConnectionException,
                                     UnknownException

Gets the current, i.e. latest, standard deviation of the latency collected in the VM the monitor is connected to.

Returns:

latest latency (standard) deviation (or null if there is none)

Throws:

ConnectionException - if the connection is not active or a communication error occurs or an exit signal was received or the remote node sends a message containing an invalid cookie

UnknownException - if any other error occurs