util

Class StatTasks

java.lang.Object

util.StatTasks

public class StatTasks
extends Object

Constructor Summary

Constructors

Constructor and Description
StatTasks()

Method Summary

Modifier and Type	Method and Description
static void	ensureStatIsNonNegative(String archiveID, String statType, String statName, String individStatName, String statKind) Check that the given stat is not negative.
static void	ensureTxOccurredTask() ENDTASK to throw a fit if no transactions occurred.
static List<PerfStatValue>	getStatFromArchive(String archiveID, String statType, String statName, String individStatName, String statKind) Retrieve a stat from the archive, for example this is useful for getting min or max stat values.
static void	validateStats() Validate stats in each archive in the current test run.

Methods inherited from class java.lang.Object

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

Constructor Detail

StatTasks

public StatTasks()

Method Detail

ensureTxOccurredTask

public static void ensureTxOccurredTask()

ENDTASK to throw a fit if no transactions occurred.

getStatFromArchive

public static List<PerfStatValue> getStatFromArchive(String archiveID,
                                                     String statType,
                                                     String statName,
                                                     String individStatName,
                                                     String statKind)

Retrieve a stat from the archive, for example this is useful for getting min or max stat values. Examples: getStatFromArchive("CachePerfStats", "*", "regions", StatSpecTokens.MAX); getStatFromArchive("OffHeapMemoryStats", "*", "objects", StatSpecTokens.MIN);

Parameters:

archiveID - The identifying name for the archive (currently you cannot specify a specific archive file); this ID is typically the hydra client name.

statType - A stat "Type" from vsd

statName - A stat "Name" from vsd

individStatName - The name of the stat to be obtained from statType.statName

statKind - A value from StatSpecTokens, such as StatSpecTokens.MIN or StatExpecTokens.MAX

Returns:

A List of PerfStatValue instances obtained from the stat archive of the current jvm, using a stat spec formed from the previous arguments.

ensureStatIsNonNegative

public static void ensureStatIsNonNegative(String archiveID,
                                           String statType,
                                           String statName,
                                           String individStatName,
                                           String statKind)

Check that the given stat is not negative. Throws TestException if it is.

Parameters:

archiveID - The identifying name for the archive (currently you cannot specify a specific archive file); this ID is typically the hydra client name.

statType - A stat "Type" from vsd

statName - A stat "Name" from vsd

individStatName - The name of the stat to be obtained from statType.statName

statKind - A value from StatSpecTokens, such as StatSpecTokens.MIN or StatExpecTokens.MAX

validateStats

public static void validateStats()

Validate stats in each archive in the current test run. This work is done only once in multiple threads/jvms. If this needs to execute more then onece, then StatTasksBB.leader should be reset to 0 first. This is suitable for invoking in and ENDTASK. It will be done once and check all stats for all members that ran throughout the test.