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
 Double getCurLatencyAvg()
          Gets the current, i.e.
 Double getCurLatencyStddev()
          Gets the current, i.e.
 int getDhtNodes()
          Gets the number of Scalaris nodes running in the VM the monitor is connected to.
 String getErlangVersion()
          Gets the version of Erlang running in the VM the monitor is connected to.
 Map<Long,Double> getLatencyAvg()
          Gets average latency values collected in the VM the monitor is connected to.
 Map<Long,Double> getLatencyStddev()
          Gets the standard deviation of the latency values collected in the VM the monitor is connected to.
 String getScalarisVersion()
          Gets the version of Scalaris running in the VM the monitor is connected to.
 

Method Detail

getScalarisVersion

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

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

Map<Long,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

Map<Long,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

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

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