|
IBM Rational Performance Tester TES | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface IStatisticsManager
The IStatisticsManager interface provides access to statistical counters for users of
ICustomCode2
.
Statistical counters are stored in a hierarchy of counters. Periodically, all counter values in the tree are
reported to the performance testing workbench and collected into performance test run results
where they are available for use in reports and graphs. Each counter in the tree has a type.
See StatType
. The operations that are available on a counter
depend on the counter's type.
Field Summary | |
---|---|
static int |
ALL
Reports all statistical counters. |
static int |
NONE
Reports no statistics. |
static int |
PRIMARY_COUNTERS
Reports a moderate number of statistical counters. |
static int |
PRIMARY_TEST_ACTIONS
Reports a moderate number of statistical counters. |
static int |
SCHEDULE_ACTIONS
Reports only those statistical counters associated with the schedule. |
static int |
SECONDARY_TEST_ACTIONS
Reports a large number of statistical counters. |
Method Summary | |
---|---|
com.ibm.rational.test.lt.kernel.statistics.impl.Average |
getAverage(String[] path)
Retrieves a child Average counter. |
int |
getLevel()
Returns the current level of statistics verbosity. |
com.ibm.rational.test.lt.kernel.statistics.impl.Range |
getRange(String[] path)
Retrieves a child Range counter. |
com.ibm.rational.test.lt.kernel.statistics.impl.Rate |
getRate(String[] path)
Retrieves a child Rate counter. |
com.ibm.rational.test.lt.kernel.statistics.impl.Scalar |
getScalar(String[] path)
Retrieves a child Scalar counter. |
com.ibm.rational.test.lt.kernel.statistics.impl.Static |
getStatic(String[] path)
Retrieves a child Static counter. |
IStatTree |
getStatTree()
Returns the root of the statistical counter tree. |
com.ibm.rational.test.lt.kernel.statistics.impl.StatTree |
getStructure(String[] path)
Retrieves a Structure counter. |
com.ibm.rational.test.lt.kernel.statistics.impl.Text |
getText(String[] path)
Retrieves a child Text counter. |
IVerificationPoint |
getVerificationPoint(String[] path)
Retrieves a child VerificationPoint counter. |
void |
reportVerificationPoint(VerdictEvent vp,
IVerificationPoint vpStat)
Report a TPTP VerdictEvent as a verification point. |
boolean |
wouldReport(int level)
Determines if the current execution will report statistics at a given level. |
Field Detail |
---|
static final int NONE
Used for internal testing purposes only.
static final int PRIMARY_COUNTERS
This level includes counters that the protocol determines to be of primary importance. This is the same as PRIMARY_TEST_ACTIONS.
(HTTP) Reports statistics related to pages but not to individual requests.
IStatisticsManager.ALL
,
IStatisticsManager.SCHEDULE_ACTIONS
,
IStatisticsManager.PRIMARY_TEST_ACTIONS
,
IStatisticsManager.SECONDARY_TEST_ACTIONS
,
Constant Field Valuesstatic final int ALL
This level includes all available counters.
(HTTP) Reports statistics related to individual HTTP requests.
IStatisticsManager.SCHEDULE_ACTIONS
,
IStatisticsManager.PRIMARY_TEST_ACTIONS
,
IStatisticsManager.SECONDARY_TEST_ACTIONS
,
Constant Field Valuesstatic final int SCHEDULE_ACTIONS
This level includes counters that reported by schedule level actions and does not include any protocol counters.
IStatisticsManager.ALL
,
IStatisticsManager.PRIMARY_TEST_ACTIONS
,
IStatisticsManager.SECONDARY_TEST_ACTIONS
,
Constant Field Valuesstatic final int PRIMARY_TEST_ACTIONS
This level includes counters that the protocol determines to be of primary importance. This is the same as PRIMARY_COUNTERS.
(HTTP) Reports statistics related to pages but not to individual requests.
IStatisticsManager.ALL
,
IStatisticsManager.SCHEDULE_ACTIONS
,
IStatisticsManager.PRIMARY_COUNTERS
,
IStatisticsManager.SECONDARY_TEST_ACTIONS
,
Constant Field Valuesstatic final int SECONDARY_TEST_ACTIONS
This level includes all counters that the protocol determines to be of primary importance plus those determined to be of secondary importance.
(HTTP) Reports statistics related to individual HTTP requests.
IStatisticsManager.ALL
,
IStatisticsManager.SCHEDULE_ACTIONS
,
IStatisticsManager.PRIMARY_TEST_ACTIONS
,
Constant Field ValuesMethod Detail |
---|
int getLevel()
boolean wouldReport(int level)
Returns true if a statistics counter of the given statisticsLevel should be created. This method evaluates the statistics level and whether the calling virtual user is being sampled.
level
- The level of the proposed counter.
IStatTree getStatTree()
com.ibm.rational.test.lt.kernel.statistics.impl.StatTree getStructure(String[] path)
Uses getStat()
to find or create a Structure counter of the given path.
The path is relative to the root of the statistics tree. Each element of the path array specifies one
level in the statistics tree hierarchy.
All counters along the path that do not already exist will be created.
All counters that are created by this method will be type STRUCTURE.
path
- The path to the desired Structure counter.
com.ibm.rational.test.lt.kernel.statistics.impl.Text getText(String[] path)
Uses getStat()
to find or create a Text counter of the given path.
The path is relative to the root of the statistics tree. Each element of the path array specifies one
level in the statistics tree hierarchy.
All counters along the path that do not already exist will be created.
All counters that are created by this method except the last element of path
will be type STRUCTURE.
path
- The path to the desired Text counter.
com.ibm.rational.test.lt.kernel.statistics.impl.Static getStatic(String[] path)
Uses getStat()
to find or create a Static counter of the given path.
The path is relative to the root of the statistics tree. Each element of the path array specifies one
level in the statistics tree hierarchy.
All counters along the path that do not already exist will be created.
All counters that are created by this method except the last element of path
will be type STRUCTURE.
path
- The path to the desired counter.
com.ibm.rational.test.lt.kernel.statistics.impl.Scalar getScalar(String[] path)
Uses getStat()
to find or create a Scalar counter of the given path.
The path is relative to the root of the statistics tree. Each element of the path array specifies one
level in the statistics tree hierarchy.
All counters along the path that do not already exist will be created.
All counters that are created by this method except the last element of path
will be type STRUCTURE.
path
- The path to the desired Scalar counter.
com.ibm.rational.test.lt.kernel.statistics.impl.Rate getRate(String[] path)
Uses getStat()
to find or create a Rate counter of the given path.
The path is relative to the root of the statistics tree. Each element of the path array specifies one
level in the statistics tree hierarchy.
All counters along the path that do not already exist will be created.
All counters that are created by this method except the last element of path
will be type STRUCTURE.
path
- The path to the desired Rate counter.
com.ibm.rational.test.lt.kernel.statistics.impl.Average getAverage(String[] path)
Uses getStat()
to find or create a Average counter of the given path.
The path is relative to the root of the statistics tree. Each element of the path array specifies one
level in the statistics tree hierarchy.
All counters along the path that do not already exist will be created.
All counters that are created by this method except the last element of path
will be type STRUCTURE.
path
- The path to the desired Average counter.
com.ibm.rational.test.lt.kernel.statistics.impl.Range getRange(String[] path)
Uses getStat()
to find or create a Range counter of the given path.
The path is relative to the root of the statistics tree. Each element of the path array specifies one
level in the statistics tree hierarchy.
All counters along the path that do not already exist will be created.
All counters that are created by this method except the last element of path
will be type STRUCTURE.
path
- The path to the desired Range counter.
IVerificationPoint getVerificationPoint(String[] path)
Uses getStat()
to find or create a
VerificationPoint counter of the given path. The path is
relative to the root of the statistics tree. Each element
of the path array specifies one level in the statistics
tree hierarchy. All counters along the path that do not
already exist will be created. All counters that are
created by this method except the last element of
path
will be type STRUCTURE.
path
- The path to the desired VerificationPoint
counter.
void reportVerificationPoint(VerdictEvent vp, IVerificationPoint vpStat)
VerdictEvents reported by this method contribute to the rollup of verdicts by the parent containers. The counter for the verdict in the given VerificationPoint statistics counter is incremented.
vp
- the TPTP VerdictEvent to report as a
verification point.vpStat
- the counter associated with this verification
point.
|
IBM Rational Performance Tester TES | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |