org.rhq.enterprise.server.measurement

Interface MeasurementBaselineManagerLocal

All Superinterfaces:

MeasurementBaselineManagerRemote

All Known Implementing Classes:

MeasurementBaselineManagerBean

public interface MeasurementBaselineManagerLocal
extends MeasurementBaselineManagerRemote

A manager for MeasurementBaselines.

Author:

Heiko W. Rupp, John Mazzitelli, Joseph Marques

Method Summary

Methods

Modifier and Type	Method and Description
int	_calculateAutoBaselinesDELETE(long olderThanTime) Deletes baselines that are older than the time specified
org.rhq.core.domain.measurement.MeasurementBaseline	calculateAutoBaseline(org.rhq.core.domain.auth.Subject subject, Integer measurementScheduleId, long startDate, long endDate, boolean save) Calculate a baseline value for the given metric based on the specified date range, optionally setting the metric's baseline to the calculated value.
org.rhq.core.domain.measurement.MeasurementBaseline	calculateAutoBaseline(org.rhq.core.domain.auth.Subject subject, int groupId, int definitionId, long startDate, long endDate, boolean save)
org.rhq.core.domain.measurement.MeasurementBaseline	calculateAutoBaselineForGroupInNewTransaction(org.rhq.core.domain.auth.Subject subject, int groupId, int definitionId, long startDate, long endDate, boolean save)
org.rhq.core.domain.measurement.MeasurementBaseline	calculateAutoBaselineInNewTransaction(org.rhq.core.domain.auth.Subject subject, Integer measurementScheduleId, long startDate, long endDate, boolean save)
void	calculateAutoBaselines() This is the entry point which calls out to all other *calculateAutoBaselines* methods seen in this interface.
long	calculateAutoBaselines(long amountOfData, long olderThanTime) Calculates baselines for all scheduled measurements.
void	calculateBaselines(Set<Integer> scheduleIds, long olderThan, long amountOfData) Given a list of scheduleIds, this method calculates and stores baselines using the amount of 1 hr data specified and older than the time specified.
void	enableAutoBaselineCalculation(org.rhq.core.domain.auth.Subject subject, Integer[] resourceIds, Integer[] definitionIds) Unset the user-entered property in baselines so that we can do autobaselines on it again.
org.rhq.core.domain.measurement.MeasurementBaseline	getBaselineIfEqual(org.rhq.core.domain.auth.Subject subject, int groupId, int definitionId)
Set<Integer>	getSchedulesWithoutBaselines() Note This method exists only for transaction demarcation.
void	saveNewBaselines(Set<Integer> scheduleIds, Map<Integer,org.rhq.core.domain.measurement.MeasurementBaseline> baselines) Persists the newly calculated baselines.

Methods inherited from interface org.rhq.enterprise.server.measurement.MeasurementBaselineManagerRemote

findBaselinesForResource

Method Detail

calculateAutoBaselines

void calculateAutoBaselines()

This is the entry point which calls out to all other *calculateAutoBaselines* methods seen in this interface. This is the method that should be called on a regular basis by some sort of job scheduler / timer to determine whether baselines even need to be calculated. This is an inexpensive operation and can be run every minute if needed because it will only calculate baselines for the ones that need it (as configured by the system preferences for how frequently they should be recalculated, and how much data should be used in that recalculation).

calculateAutoBaselines

long calculateAutoBaselines(long amountOfData,
                          long olderThanTime)

Calculates baselines for all scheduled measurements. The measurement data that was collected between the given start and end times is used to calculate the baselines.

Parameters:

amountOfData - will use amountOfData to compute new min/max/mean for baselines as appropriate

olderThanTime - deletes baselines older than the time specified

Returns:

the time that all the baselines were computed;

_calculateAutoBaselinesDELETE

int _calculateAutoBaselinesDELETE(long olderThanTime)
                                  throws Exception

Deletes baselines that are older than the time specified

Parameters:

olderThanTime - deletes baselines older than the time specified

Returns:

number of rows deleted

Throws:

Exception

getSchedulesWithoutBaselines

Set<Integer> getSchedulesWithoutBaselines()

Note This method exists only for transaction demarcation.

Returns:

The Set of of enabled, numeric, schedules that do not have baselines.

calculateBaselines

void calculateBaselines(Set<Integer> scheduleIds,
                      long olderThan,
                      long amountOfData)

Given a list of scheduleIds, this method calculates and stores baselines using the amount of 1 hr data specified and older than the time specified.

Note This method exists only for transaction demarcation.

Parameters:

scheduleIds - The schedules that do not yet have baselines

olderThan - Use 1 hr data prior to this time

amountOfData - The amount of data to use for calculating baselines. This value is treated as a duration. For example, a value of 259200000 would be treated as 3 days.

saveNewBaselines

void saveNewBaselines(Set<Integer> scheduleIds,
                    Map<Integer,org.rhq.core.domain.measurement.MeasurementBaseline> baselines)

Persists the newly calculated baselines.

Note This method exists only for transaction demarcation.

Parameters:

scheduleIds - the scheduleIds for whom we want to persist baselines (a subset of baselines.keyset, we may not save them all in one call to this method)

baselines - Map of scheduleIds to The baselines to persist.

getBaselineIfEqual

org.rhq.core.domain.measurement.MeasurementBaseline getBaselineIfEqual(org.rhq.core.domain.auth.Subject subject,
                                                                     int groupId,
                                                                     int definitionId)

calculateAutoBaseline

org.rhq.core.domain.measurement.MeasurementBaseline calculateAutoBaseline(org.rhq.core.domain.auth.Subject subject,
                                                                        Integer measurementScheduleId,
                                                                        long startDate,
                                                                        long endDate,
                                                                        boolean save)
                                                                          throws BaselineCreationException,
                                                                                 MeasurementNotFoundException

Calculate a baseline value for the given metric based on the specified date range, optionally setting the metric's baseline to the calculated value.

Parameters:

subject -

measurementScheduleId - measurement id to recalc.

startDate - begin date range

endDate - end date range

save - whether or not to save the recalculated baseline

Returns:

the calculated baseline value

Throws:

BaselineCreationException

MeasurementNotFoundException

calculateAutoBaselineInNewTransaction

org.rhq.core.domain.measurement.MeasurementBaseline calculateAutoBaselineInNewTransaction(org.rhq.core.domain.auth.Subject subject,
                                                                                        Integer measurementScheduleId,
                                                                                        long startDate,
                                                                                        long endDate,
                                                                                        boolean save)
                                                                                          throws BaselineCreationException,
                                                                                                 MeasurementNotFoundException

Throws:

BaselineCreationException

MeasurementNotFoundException

calculateAutoBaseline

org.rhq.core.domain.measurement.MeasurementBaseline calculateAutoBaseline(org.rhq.core.domain.auth.Subject subject,
                                                                        int groupId,
                                                                        int definitionId,
                                                                        long startDate,
                                                                        long endDate,
                                                                        boolean save)
                                                                          throws BaselineCreationException,
                                                                                 MeasurementNotFoundException

Throws:

BaselineCreationException

MeasurementNotFoundException

calculateAutoBaselineForGroupInNewTransaction

org.rhq.core.domain.measurement.MeasurementBaseline calculateAutoBaselineForGroupInNewTransaction(org.rhq.core.domain.auth.Subject subject,
                                                                                                int groupId,
                                                                                                int definitionId,
                                                                                                long startDate,
                                                                                                long endDate,
                                                                                                boolean save)
                                                                                                  throws BaselineCreationException,
                                                                                                         MeasurementNotFoundException

Throws:

BaselineCreationException

MeasurementNotFoundException

enableAutoBaselineCalculation

void enableAutoBaselineCalculation(org.rhq.core.domain.auth.Subject subject,
                                 Integer[] resourceIds,
                                 Integer[] definitionIds)

Unset the user-entered property in baselines so that we can do autobaselines on it again.

Parameters:

subject -

resourceIds -

definitionIds - measurement definition IDs