org.rhq.enterprise.server.measurement

Interface MeasurementOOBManagerLocal

All Known Implementing Classes:

MeasurementOOBManagerBean

public interface MeasurementOOBManagerLocal

Interface for the OOB Manager

Author:

Heiko W. Rupp

See Also:

MeasurementOOBManagerBean

Method Summary

Methods

Modifier and Type	Method and Description
int	calculateOOB(AggregateNumericMetric metric, org.rhq.core.domain.measurement.MeasurementBaseline baseline) Determines and calculates an OOB if necessary, If an OOB is generated, this method saves it to the database.
void	computeOOBsForLastHour(org.rhq.core.domain.auth.Subject subject, Iterable<AggregateNumericMetric> metrics) Computes OOBs using the provided 1 hr data which should be the most recent 1 hr aggregates.
void	computeOOBsFromHourBeginingAt(org.rhq.core.domain.auth.Subject subject, long begin) Compute oobs from the values in the 1h measurement table that just got added.
void	computeOOBsFromLastHour(org.rhq.core.domain.auth.Subject subject) Computes the OOBs for the last hour.
org.rhq.core.domain.util.PageList<org.rhq.core.domain.measurement.composite.MeasurementOOBComposite>	getHighestNOOBsForGroup(org.rhq.core.domain.auth.Subject subject, int groupId, int n) Returns the highest n OOBs for the passed group id within the last 72h
org.rhq.core.domain.util.PageList<org.rhq.core.domain.measurement.composite.MeasurementOOBComposite>	getHighestNOOBsForResource(org.rhq.core.domain.auth.Subject subject, int resourceId, int n) Returns the highest n OOBs for the passed resource id within the last 72h
org.rhq.core.domain.util.PageList<org.rhq.core.domain.measurement.composite.MeasurementOOBComposite>	getSchedulesWithOOBs(org.rhq.core.domain.auth.Subject subject, String metricNameFilter, String resourceNameFilter, String parentNameFilter, org.rhq.core.domain.util.PageControl pc) Return OOB Composites that contain all information about the OOBs in a given time as aggregates.
void	removeOOBsForGroupAndDefinition(org.rhq.core.domain.auth.Subject subject, int resourceGroupId, int measurementDefinitionId)
void	removeOOBsForSchedule(org.rhq.core.domain.auth.Subject subject, org.rhq.core.domain.measurement.MeasurementSchedule sched) Remove all OOB data for the passed schedule

Method Detail

computeOOBsFromHourBeginingAt

void computeOOBsFromHourBeginingAt(org.rhq.core.domain.auth.Subject subject,
                                 long begin)

Compute oobs from the values in the 1h measurement table that just got added. For the total result, this is an incremental computation. The idea is that it gets run *directly* after the 1h compression (and the baseline recalculation too).

Parameters:

subject - Subject of the caller

begin - Start time of the 1h entries to look at

computeOOBsForLastHour

void computeOOBsForLastHour(org.rhq.core.domain.auth.Subject subject,
                          Iterable<AggregateNumericMetric> metrics)

Computes OOBs using the provided 1 hr data which should be the most recent 1 hr aggregates. These metrics are provided as an argument as opposed to querying for them because we already have the 1 hr aggregates load in memory when metrics aggregation runs prior to calculating OOBs.

Parameters:

subject -

metrics - The most recent 1 hr aggregates

calculateOOB

int calculateOOB(AggregateNumericMetric metric,
               org.rhq.core.domain.measurement.MeasurementBaseline baseline)

Determines and calculates an OOB if necessary, If an OOB is generated, this method saves it to the database.

Note This method exists only for transaction demarcation.

Parameters:

metric - The 1 hr metric that is used to determine whether or not an OOB should be generated

Returns:

1 if an OOB is generated, 0 otherwise

getSchedulesWithOOBs

org.rhq.core.domain.util.PageList<org.rhq.core.domain.measurement.composite.MeasurementOOBComposite> getSchedulesWithOOBs(org.rhq.core.domain.auth.Subject subject,
                                                                                                                        String metricNameFilter,
                                                                                                                        String resourceNameFilter,
                                                                                                                        String parentNameFilter,
                                                                                                                        org.rhq.core.domain.util.PageControl pc)

Return OOB Composites that contain all information about the OOBs in a given time as aggregates.

Parameters:

subject - The caller

metricNameFilter -

resourceNameFilter - a resource name to filter for

parentNameFilter - a parent resource name to filter for @return List of schedules with the corresponing oob aggregates

pc - PageControl to do pagination

computeOOBsFromLastHour

void computeOOBsFromLastHour(org.rhq.core.domain.auth.Subject subject)

Computes the OOBs for the last hour. This is done by getting the latest timestamp of the 1h table and invoking #computeOOBsFromHourBeginingAt

Parameters:

subject - caller

removeOOBsForSchedule

void removeOOBsForSchedule(org.rhq.core.domain.auth.Subject subject,
                         org.rhq.core.domain.measurement.MeasurementSchedule sched)

Remove all OOB data for the passed schedule

Parameters:

subject - Caller

sched - the schedule for which we want to clean out the data

removeOOBsForGroupAndDefinition

void removeOOBsForGroupAndDefinition(org.rhq.core.domain.auth.Subject subject,
                                   int resourceGroupId,
                                   int measurementDefinitionId)

getHighestNOOBsForResource

org.rhq.core.domain.util.PageList<org.rhq.core.domain.measurement.composite.MeasurementOOBComposite> getHighestNOOBsForResource(org.rhq.core.domain.auth.Subject subject,
                                                                                                                              int resourceId,
                                                                                                                              int n)

Returns the highest n OOBs for the passed resource id within the last 72h

Parameters:

subject - caller

resourceId - the resource we are interested in

n - max number of entries wanted

Returns:

getHighestNOOBsForGroup

org.rhq.core.domain.util.PageList<org.rhq.core.domain.measurement.composite.MeasurementOOBComposite> getHighestNOOBsForGroup(org.rhq.core.domain.auth.Subject subject,
                                                                                                                           int groupId,
                                                                                                                           int n)

Returns the highest n OOBs for the passed group id within the last 72h

Parameters:

subject - caller

groupId - the resource we are interested in

n - max number of entries wanted

Returns: