org.rhq.enterprise.server.measurement
Class MeasurementDataManagerBean

java.lang.Object
  org.rhq.enterprise.server.measurement.MeasurementDataManagerBean

All Implemented Interfaces:

MeasurementDataManagerLocal, MeasurementDataManagerRemote

public class MeasurementDataManagerBean
extends java.lang.Object
implements MeasurementDataManagerLocal, MeasurementDataManagerRemote

A manager for MeasurementDatas.

Author:

Heiko W. Rupp, Greg Hinkle, Ian Springer

Constructor Summary

MeasurementDataManagerBean()

Method Summary

void	addNumericData(java.util.Set<MeasurementDataNumeric> data) Add metrics data to the database.
void	addTraitData(java.util.Set<MeasurementDataTrait> data)
java.util.List<MeasurementDataTrait>	findCurrentTraitsForResource(Subject subject, int resourceId, DisplayType displayType) Return the Traits for the passed resource.
java.util.List<java.util.List<MeasurementDataNumericHighLowComposite>>	findDataForAutoGroup(Subject subject, int autoGroupParentResourceId, int autoGroupChildResourceTypeId, int measurementDefinitionId, long beginTime, long endTime, int numberOfDataPoints, boolean aggregateOverAutoGroup) Returns a list of numeric data point lists for the given auto group - one per specified measurement definition.
java.util.List<java.util.List<MeasurementDataNumericHighLowComposite>>	findDataForCompatibleGroup(Subject subject, int groupId, int definitionId, long beginTime, long endTime, int numPoints, boolean groupAggregateOnly) Returns a list of numeric data point lists for the given compatible group - one per specified measurement definition.
java.util.List<java.util.List<MeasurementDataNumericHighLowComposite>>	findDataForResource(Subject subject, int resourceId, int[] definitionIds, long beginTime, long endTime, int numDataPoints)
java.util.List<java.util.List<MeasurementDataNumericHighLowComposite>>	findDataForSiblingResources(Subject subject, int[] resourceIds, int measurementDefinitionId, long beginTime, long endTime, int numberOfDataPoints) Return a List of List where each nested list contains the data for one of the passed resource ids
java.util.Set<MeasurementData>	findLiveData(Subject subject, int resourceId, int[] definitionIds) Get live metrics for a given MeasurementSchedule
java.util.Map<java.lang.Integer,java.util.List<MetricDisplaySummary>>	findNarrowedMetricDisplaySummariesForCompatibleResources(Subject subject, java.util.Collection<Resource> resources, long beginTime, long endTime) Get the MetricDisplaySummarys for the resources passed in, that all need to be of the same ResourceType.
java.util.Map<java.lang.Integer,java.util.List<MetricDisplaySummary>>	findNarrowedMetricDisplaySummariesForResourcesAndParent(Subject subject, int resourceTypeId, int parentId, java.util.List<java.lang.Integer> resourceIds, long begin, long end) Return a map of <resource id, List<MetricDisplaySummary>>, where the list contains the MetricDisplaySummary for the (enabled) schedules of the resource
java.util.Map<java.lang.Integer,java.util.List<MetricDisplaySummary>>	findNarrowedMetricsDisplaySummariesForAutoGroup(Subject subject, int parentId, int cType, long beginTime, long endTime)
java.util.Map<java.lang.Integer,java.util.List<MetricDisplaySummary>>	findNarrowedMetricsDisplaySummariesForCompGroup(Subject subject, ResourceGroup group, long beginTime, long endTime) Get metric display summaries for the resources of the passed compatible group, where the MetricDisplaySummary only contains the metric name and number of alerts.
java.util.List<MeasurementDataTrait>	findTraits(Subject subject, int resourceId, int definitionId) Return all known trait data for the passed schedule, defined by resourceId and definitionId
MeasurementAggregate	getAggregate(Subject subject, int groupId, int definitionId, long startTime, long endTime)
MeasurementAggregate	getAggregate(Subject subject, int scheduleId, long startTime, long endTime) Get the aggregate values of the numerical values for a given schedule.
MeasurementDataNumeric	getCurrentNumericForSchedule(int scheduleId) Return the current numeric value for the passed schedule
MeasurementDataTrait	getCurrentTraitForSchedule(int scheduleId) Return the current trait value for the passed schedule
void	mergeMeasurementReport(MeasurementReport report)
int	purgeTraits(long oldest)

Methods inherited from class java.lang.Object

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

Constructor Detail

MeasurementDataManagerBean

public MeasurementDataManagerBean()

Method Detail

purgeTraits

public int purgeTraits(long oldest)

Specified by:

purgeTraits in interface MeasurementDataManagerLocal

mergeMeasurementReport

public void mergeMeasurementReport(MeasurementReport report)

Specified by:

mergeMeasurementReport in interface MeasurementDataManagerLocal

addNumericData

public void addNumericData(java.util.Set<MeasurementDataNumeric> data)

Add metrics data to the database. Data that is passed can come from several Schedules, but needs to be of only one type of MeasurementGathering. For good performance it is important that the agent sends batches as big as possible (ok, perhaps not more than 100 items at a time).

Specified by:

addNumericData in interface MeasurementDataManagerLocal

Parameters:

data - the actual data points

addTraitData

public void addTraitData(java.util.Set<MeasurementDataTrait> data)

Specified by:

addTraitData in interface MeasurementDataManagerLocal

findDataForSiblingResources

public java.util.List<java.util.List<MeasurementDataNumericHighLowComposite>> findDataForSiblingResources(Subject subject,
                                                                                                          int[] resourceIds,
                                                                                                          int measurementDefinitionId,
                                                                                                          long beginTime,
                                                                                                          long endTime,
                                                                                                          int numberOfDataPoints)

Return a List of List where each nested list contains the data for one of the passed resource ids

Specified by:

findDataForSiblingResources in interface MeasurementDataManagerLocal

measurementDefinitionId - measurement definition id for a numeric metric associated with the given sibling resources

Returns:

findDataForAutoGroup

public java.util.List<java.util.List<MeasurementDataNumericHighLowComposite>> findDataForAutoGroup(Subject subject,
                                                                                                   int autoGroupParentResourceId,
                                                                                                   int autoGroupChildResourceTypeId,
                                                                                                   int measurementDefinitionId,
                                                                                                   long beginTime,
                                                                                                   long endTime,
                                                                                                   int numberOfDataPoints,
                                                                                                   boolean aggregateOverAutoGroup)

Description copied from interface: MeasurementDataManagerLocal

Returns a list of numeric data point lists for the given auto group - one per specified measurement definition. The data points represent the average min/avg/max values of the members of the group.

Specified by:

findDataForAutoGroup in interface MeasurementDataManagerLocal

measurementDefinitionId - measurement definition id of numeric metrics associated with the given auto group

aggregateOverAutoGroup - TODO

Returns:

findNarrowedMetricDisplaySummariesForResourcesAndParent

public java.util.Map<java.lang.Integer,java.util.List<MetricDisplaySummary>> findNarrowedMetricDisplaySummariesForResourcesAndParent(Subject subject,
                                                                                                                                     int resourceTypeId,
                                                                                                                                     int parentId,
                                                                                                                                     java.util.List<java.lang.Integer> resourceIds,
                                                                                                                                     long begin,
                                                                                                                                     long end)

Return a map of <resource id, List<MetricDisplaySummary>>, where the list contains the MetricDisplaySummary for the (enabled) schedules of the resource

Specified by:

findNarrowedMetricDisplaySummariesForResourcesAndParent in interface MeasurementDataManagerLocal

Parameters:

subject - Subject of the caller

resourceTypeId - ResourceTypeId of the child resources

parentId - ID of the common parent resource

resourceIds - List of primary keys of the resources we are interested in

begin - begin time

end - end time

findNarrowedMetricsDisplaySummariesForCompGroup

public java.util.Map<java.lang.Integer,java.util.List<MetricDisplaySummary>> findNarrowedMetricsDisplaySummariesForCompGroup(Subject subject,
                                                                                                                             ResourceGroup group,
                                                                                                                             long beginTime,
                                                                                                                             long endTime)

Description copied from interface: MeasurementDataManagerLocal

Get metric display summaries for the resources of the passed compatible group, where the MetricDisplaySummary only contains the metric name and number of alerts. All other fields are not set.

Specified by:

findNarrowedMetricsDisplaySummariesForCompGroup in interface MeasurementDataManagerLocal

Parameters:

subject - subject of the caller

group - compatible group

Returns:

a Map of resource id, List of summaries for this resource

findNarrowedMetricsDisplaySummariesForAutoGroup

public java.util.Map<java.lang.Integer,java.util.List<MetricDisplaySummary>> findNarrowedMetricsDisplaySummariesForAutoGroup(Subject subject,
                                                                                                                             int parentId,
                                                                                                                             int cType,
                                                                                                                             long beginTime,
                                                                                                                             long endTime)

Specified by:

findNarrowedMetricsDisplaySummariesForAutoGroup in interface MeasurementDataManagerLocal

findNarrowedMetricDisplaySummariesForCompatibleResources

public java.util.Map<java.lang.Integer,java.util.List<MetricDisplaySummary>> findNarrowedMetricDisplaySummariesForCompatibleResources(Subject subject,
                                                                                                                                      java.util.Collection<Resource> resources,
                                                                                                                                      long beginTime,
                                                                                                                                      long endTime)

Get the MetricDisplaySummarys for the resources passed in, that all need to be of the same ResourceType. Summaries only contain a basic selection of fields for the purpose of filling the Child resource popups.

Specified by:

findNarrowedMetricDisplaySummariesForCompatibleResources in interface MeasurementDataManagerLocal

getCurrentTraitForSchedule

@Nullable
public MeasurementDataTrait getCurrentTraitForSchedule(int scheduleId)

Return the current trait value for the passed schedule

Specified by:

getCurrentTraitForSchedule in interface MeasurementDataManagerLocal

Parameters:

scheduleId - id of a MeasurementSchedule that 'points' to a Trait

Returns:

One trait or null if nothing was found in the db.

getCurrentNumericForSchedule

@Nullable
public MeasurementDataNumeric getCurrentNumericForSchedule(int scheduleId)

Description copied from interface: MeasurementDataManagerLocal

Return the current numeric value for the passed schedule

Specified by:

getCurrentNumericForSchedule in interface MeasurementDataManagerLocal

Parameters:

scheduleId - id of a MeasurementSchedule that 'points' to a MeasurementDataNumeric record

Returns:

One MeasurementDataNumeric or null if nothing was found

getAggregate

public MeasurementAggregate getAggregate(Subject subject,
                                         int scheduleId,
                                         long startTime,
                                         long endTime)

Description copied from interface: MeasurementDataManagerLocal

Get the aggregate values of the numerical values for a given schedule. This can only provide aggregates for data in the "live" table

Specified by:

getAggregate in interface MeasurementDataManagerLocal

Specified by:

getAggregate in interface MeasurementDataManagerRemote

Parameters:

subject - the user requesting the aggregate

scheduleId - the id of the MeasurementSchedule for which this aggregate is being requested

Returns:

MeasurementAggregate bean with the data

getAggregate

public MeasurementAggregate getAggregate(Subject subject,
                                         int groupId,
                                         int definitionId,
                                         long startTime,
                                         long endTime)

Specified by:

getAggregate in interface MeasurementDataManagerLocal

findCurrentTraitsForResource

public java.util.List<MeasurementDataTrait> findCurrentTraitsForResource(Subject subject,
                                                                         int resourceId,
                                                                         DisplayType displayType)

Return the Traits for the passed resource. This method will for each trait only return the 'youngest' entry. If there are no traits found for that resource, an empty list is returned. If displayType is null, no displayType is honoured, else the traits will be filtered for the given displayType

Specified by:

findCurrentTraitsForResource in interface MeasurementDataManagerLocal

Specified by:

findCurrentTraitsForResource in interface MeasurementDataManagerRemote

Parameters:

resourceId - Id of the resource we are interested in

displayType - A display type for filtering or null for all traits.

Returns:

a List of MeasurementDataTrait

findDataForCompatibleGroup

public java.util.List<java.util.List<MeasurementDataNumericHighLowComposite>> findDataForCompatibleGroup(Subject subject,
                                                                                                         int groupId,
                                                                                                         int definitionId,
                                                                                                         long beginTime,
                                                                                                         long endTime,
                                                                                                         int numPoints,
                                                                                                         boolean groupAggregateOnly)

Description copied from interface: MeasurementDataManagerLocal

Returns a list of numeric data point lists for the given compatible group - one per specified measurement definition. The data points represent the average min/avg/max values of the members of the group.

Specified by:

findDataForCompatibleGroup in interface MeasurementDataManagerLocal

Specified by:

findDataForCompatibleGroup in interface MeasurementDataManagerRemote

findDataForResource

public java.util.List<java.util.List<MeasurementDataNumericHighLowComposite>> findDataForResource(Subject subject,
                                                                                                  int resourceId,
                                                                                                  int[] definitionIds,
                                                                                                  long beginTime,
                                                                                                  long endTime,
                                                                                                  int numDataPoints)

Specified by:

findDataForResource in interface MeasurementDataManagerLocal

Specified by:

findDataForResource in interface MeasurementDataManagerRemote

findLiveData

public java.util.Set<MeasurementData> findLiveData(Subject subject,
                                                   int resourceId,
                                                   int[] definitionIds)

Description copied from interface: MeasurementDataManagerLocal

Get live metrics for a given MeasurementSchedule

Specified by:

findLiveData in interface MeasurementDataManagerLocal

Specified by:

findLiveData in interface MeasurementDataManagerRemote

Returns:

MeasurementData for this Schedule

findTraits

public java.util.List<MeasurementDataTrait> findTraits(Subject subject,
                                                       int resourceId,
                                                       int definitionId)

Return all known trait data for the passed schedule, defined by resourceId and definitionId

Specified by:

findTraits in interface MeasurementDataManagerLocal

Specified by:

findTraits in interface MeasurementDataManagerRemote

Parameters:

resourceId - PK of a Resource

definitionId - PK of a MeasurementDefinition

Returns:

a List of MeasurementDataTrait objects.