org.rhq.enterprise.server.measurement

Class MeasurementOOBManagerBean

java.lang.Object

org.rhq.enterprise.server.measurement.MeasurementOOBManagerBean

All Implemented Interfaces:

MeasurementOOBManagerLocal

public class MeasurementOOBManagerBean
extends Object
implements MeasurementOOBManagerLocal

Manager bean for Out-of-Bound measurements.

Author:

Heiko W. Rupp

Constructor Summary

Constructors

Constructor and Description
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
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
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) Resets the OOB data for the passed schedule

Methods inherited from class java.lang.Object

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

Constructor Detail

MeasurementOOBManagerBean

public MeasurementOOBManagerBean()

Method Detail

computeOOBsFromHourBeginingAt

public 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). Algorithm is as follows:

• insert new values in tmp table
• update real table with max (tmp table, real table)
• insert items from tmp table that were not in real table
• tuncate tmp table

Specified by:

computeOOBsFromHourBeginingAt in interface MeasurementOOBManagerLocal

Parameters:

subject - Subject of the caller

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

computeOOBsForLastHour

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

Description copied from interface: MeasurementOOBManagerLocal

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.

Specified by:

computeOOBsForLastHour in interface MeasurementOOBManagerLocal

metrics - The most recent 1 hr aggregates

calculateOOB

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

Description copied from interface: MeasurementOOBManagerLocal

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.

Specified by:

calculateOOB in interface MeasurementOOBManagerLocal

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

computeOOBsFromLastHour

public 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

Specified by:

computeOOBsFromLastHour in interface MeasurementOOBManagerLocal

Parameters:

subject - Caller

removeOOBsForSchedule

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

Resets the OOB data for the passed schedule

Specified by:

removeOOBsForSchedule in interface MeasurementOOBManagerLocal

Parameters:

subject - Caller

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

removeOOBsForGroupAndDefinition

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

Specified by:

removeOOBsForGroupAndDefinition in interface MeasurementOOBManagerLocal

getSchedulesWithOOBs

public 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.

Specified by:

getSchedulesWithOOBs in interface MeasurementOOBManagerLocal

Parameters:

subject - The caller

metricNameFilter - a schedule name to filter for

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

getHighestNOOBsForResource

public 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

Specified by:

getHighestNOOBsForResource in interface MeasurementOOBManagerLocal

Parameters:

subject - caller

resourceId - the resource we are interested in

n - max number of entries wanted

Returns:

getHighestNOOBsForGroup

public 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

Specified by:

getHighestNOOBsForGroup in interface MeasurementOOBManagerLocal

Parameters:

subject - caller

groupId - the group we are interested in

n - max number of entries wanted

Returns: