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

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
void	removeOutdatedOOBs(org.rhq.core.domain.auth.Subject subject, long cutoffTime) Remove OOBs for schedules that had their baselines calculated after a certain cutoff point.

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

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

removeOutdatedOOBs

void removeOutdatedOOBs(org.rhq.core.domain.auth.Subject subject,
                        long cutoffTime)

Remove OOBs for schedules that had their baselines calculated after a certain cutoff point. This is used to get rid of outdated OOB data for baselines that got recalculated, as the new baselines will be 'big' enough for what have been OOBs before and we don't have any baseline history.

Parameters:

subject - The caller

cutoffTime - The reference time to determine new baselines

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: