Package de.zib.scalaris.jmx

Class MonitorNode

java.lang.Object

de.zib.scalaris.jmx.MonitorNode

All Implemented Interfaces:

MonitorNodeMBean

public class MonitorNode
extends java.lang.Object
implements MonitorNodeMBean

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

Since:

3.15

Version:

3.15

Author:

Nico Kruber, kruber@zib.de

Constructor Summary

Constructors

Constructor	Description
MonitorNode(java.lang.String node)	Creates a connection to the erlang VM of the given Scalaris node.

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.

Methods inherited from class java.lang.Object

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

Constructor Detail

MonitorNode

public MonitorNode(java.lang.String node)
            throws ConnectionException

Creates a connection to the erlang VM of the given Scalaris node. Uses the connection policy of the global connection factory.

Parameters:

node - Scalaris node to connect with

Throws:

ConnectionException - if the connection fails or the connection policy is not cloneable

Method Detail

getScalarisVersion

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

Description copied from interface: MonitorNodeMBean

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

Specified by:

getScalarisVersion in interface MonitorNodeMBean

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

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

Description copied from interface: MonitorNodeMBean

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

Specified by:

getErlangVersion in interface MonitorNodeMBean

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

public int getDhtNodes()
                throws ConnectionException,
                       UnknownException

Description copied from interface: MonitorNodeMBean

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

Specified by:

getDhtNodes in interface MonitorNodeMBean

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

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

Description copied from interface: MonitorNodeMBean

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

Specified by:

getLatencyAvg in interface MonitorNodeMBean

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

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

Description copied from interface: MonitorNodeMBean

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

Specified by:

getLatencyStddev in interface MonitorNodeMBean

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

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

Description copied from interface: MonitorNodeMBean

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

Specified by:

getCurLatencyAvg in interface MonitorNodeMBean

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

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

Description copied from interface: MonitorNodeMBean

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

Specified by:

getCurLatencyStddev in interface MonitorNodeMBean

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