hydra

Class StatMonitor

java.lang.Object

hydra.StatMonitor

All Implemented Interfaces:

java.lang.Runnable

public class StatMonitor
extends java.lang.Object
implements java.lang.Runnable

Monitors the conditions in StatMonitorPrms.conditions and halts the test if one of the conditions is violated. Hydra automatically starts a monitor in each remote hostagent, plus the hydra master, which serves as the local hostagent. See StatMonitorPrms for other configuration options.

To start a monitor, invoke start(HostDescription, MasterProxyIF, TestConfig). To stop the monitor, invoke stop().

StatMonitor is not suitable for use by hydra clients, since it connects to a distributed system outside the normal hydra channels. Also, all monitors, including those started automatically by hydra, share the same conditions. Speak up if you would like the monitor to be made suitable for clients.

Since:

5.0

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DUMP Action: Do stack dumps on the test when condition is violated.
static java.lang.String	HALT Action: Halt the test when condition is violated.
static java.lang.String	HAS_CHANGED_BY_LESS_THAN Op: The current value and the initial value differ by less than the amount
static java.lang.String	IS_EQUAL_TO Op: The current value is equal to the amount
static java.lang.String	IS_GREATER_THAN Op: The current value is greater than the amount
static java.lang.String	IS_LESS_THAN Op: The current value is less than the amount
static java.lang.String	IS_UNCHANGED Op: The current value and the initial value do not differ (the amount is ignored)
static java.lang.String	WARN Action: Warn the test when condition is violated.

Constructor Summary

Constructors

Constructor and Description
StatMonitor(java.util.Vector conditions, HostDescription hd, MasterProxyIF master, TestConfig config)

Method Summary

Modifier and Type	Method and Description
protected static java.util.Vector	parseConditions(java.util.Vector conditionsIn)
void	run() Runs the statistics monitor.
static void	start(HostDescription hd, MasterProxyIF master, TestConfig tc) Starts the statistics monitor in this VM, using the supplied master for reporting violations.
static void	stop() Stops the statistics monitor in this VM.

Methods inherited from class java.lang.Object

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

Field Detail

HAS_CHANGED_BY_LESS_THAN

public static final java.lang.String HAS_CHANGED_BY_LESS_THAN

Op: The current value and the initial value differ by less than the amount

See Also:

Constant Field Values

IS_UNCHANGED

public static final java.lang.String IS_UNCHANGED

Op: The current value and the initial value do not differ (the amount is ignored)

See Also:

Constant Field Values

IS_LESS_THAN

public static final java.lang.String IS_LESS_THAN

Op: The current value is less than the amount

See Also:

Constant Field Values

IS_GREATER_THAN

public static final java.lang.String IS_GREATER_THAN

Op: The current value is greater than the amount

See Also:

Constant Field Values

IS_EQUAL_TO

public static final java.lang.String IS_EQUAL_TO

Op: The current value is equal to the amount

See Also:

Constant Field Values

HALT

public static final java.lang.String HALT

Action: Halt the test when condition is violated.

See Also:

Constant Field Values

DUMP

public static final java.lang.String DUMP

Action: Do stack dumps on the test when condition is violated.

See Also:

Constant Field Values

WARN

public static final java.lang.String WARN

Action: Warn the test when condition is violated.

See Also:

Constant Field Values

Constructor Detail

StatMonitor

public StatMonitor(java.util.Vector conditions,
                   HostDescription hd,
                   MasterProxyIF master,
                   TestConfig config)

Method Detail

run

public void run()

Runs the statistics monitor.

Specified by:

run in interface java.lang.Runnable

parseConditions

protected static java.util.Vector parseConditions(java.util.Vector conditionsIn)

start

public static void start(HostDescription hd,
                         MasterProxyIF master,
                         TestConfig tc)

Starts the statistics monitor in this VM, using the supplied master for reporting violations. Only starts a monitor if there are conditions.

stop

public static void stop()

Stops the statistics monitor in this VM.