com.sun.sgs.management
Interface AffinityGroupFinderMXBean

All Known Implementing Classes:

AffinityGroupFinderStats

public interface AffinityGroupFinderMXBean

The management interface for the affinity group finder.

Field Summary

static String

MXBEAN_NAME The name for uniquely identifying this MBean.

Method Summary

void	clear() Clears all data values.
void	findAffinityGroups() Finds affinity groups based on the current graph information.
double	getAvgIterations() Returns the average number of iterations required for algorithm runs.
double	getAvgRunTime() Returns the average amount of time, in milliseconds, spent in algorithm runs.
long	getLastClearTime() Returns the time of the last call to clear(), or the time this MBean was created if clear has never been called.
int	getMaxIterations() Returns the max number of iterations for any algorithm run.
long	getMaxRunTime() Returns the maximum amount of time, in milliseconds, spent in an algorithm run.
long	getMinRunTime() Returns the minimum amount of time, in milliseconds, spent in an algorithm run.
long	getNumberFailures() Returns the number of times the affinity group finder has failed, due to errors or node failures during a run.
long	getNumberGroups() Returns the number of groups found in the latest run of the affinity group finder.
long	getNumberRuns() Returns the number of times the affinity group finder has run, including runs that fail.
long	getNumberStopped() Returns the number of times the affinity group finder was stopped due to not converging soon enough.
int	getStopIteration() Returns the configured maximum number of iterations allowed to run before stopping the algorithm and returning the current results.

Field Detail

MXBEAN_NAME

static final String MXBEAN_NAME

The name for uniquely identifying this MBean.

See Also:

Constant Field Values

Method Detail

getNumberGroups

long getNumberGroups()

Returns the number of groups found in the latest run of the affinity group finder.

Returns:

the number of groups found in the latest run

getNumberRuns

long getNumberRuns()

Returns the number of times the affinity group finder has run, including runs that fail.

Returns:

the number of times the affinity group finder has run

getNumberFailures

long getNumberFailures()

Returns the number of times the affinity group finder has failed, due to errors or node failures during a run.

Returns:

the number of times the affinity group finder has failed

getNumberStopped

long getNumberStopped()

Returns the number of times the affinity group finder was stopped due to not converging soon enough. A stopped run is not a failed run; valid results are returned.

Returns:

the number of times the affinity group finder was stopped

getAvgRunTime

double getAvgRunTime()

Returns the average amount of time, in milliseconds, spent in algorithm runs.

Returns:

the average amount of time spent in algorithm runs

getMinRunTime

long getMinRunTime()

Returns the minimum amount of time, in milliseconds, spent in an algorithm run.

Returns:

the minimum amount of time spent in an algorithm run

getMaxRunTime

long getMaxRunTime()

Returns the maximum amount of time, in milliseconds, spent in an algorithm run.

Returns:

the maximum amount of time spent in an algorithm run

getAvgIterations

double getAvgIterations()

Returns the average number of iterations required for algorithm runs.

Returns:

the average number of iterations required for algorithm runs

getMaxIterations

int getMaxIterations()

Returns the max number of iterations for any algorithm run.

Returns:

the max number of iterations for any algorithm run

getStopIteration

int getStopIteration()

Returns the configured maximum number of iterations allowed to run before stopping the algorithm and returning the current results.

Returns:

the configured maximum number of iterations

clear

void clear()

Clears all data values.

getLastClearTime

long getLastClearTime()

Returns the time of the last call to clear(), or the time this MBean was created if clear has never been called. The time is the difference, measured in milliseconds, between the time at which this was last cleared and midnight, January 1, 1970 UTC.

Returns:

the time of the last call to clear

findAffinityGroups

void findAffinityGroups()

Finds affinity groups based on the current graph information. This will start a new run of the affinity group finder, or wait for the current run to complete.

NOTE: This method is useful for testing but may be removed.