org.rhq.enterprise.server.measurement

Interface AvailabilityManagerLocal

All Superinterfaces:

AvailabilityManagerRemote

All Known Implementing Classes:

AvailabilityManagerBean

public interface AvailabilityManagerLocal
extends AvailabilityManagerRemote

Manager that is used to determine a resource's availability over a span of time.

Author:

Heiko W. Rupp, John Mazzitelli

Method Summary

Methods

Modifier and Type	Method and Description
List<AvailabilityPoint>	findAvailabilitiesForAutoGroup(org.rhq.core.domain.auth.Subject subject, int parentResourceId, int resourceTypeId, long begin, long end, int points, boolean withCurrentAvailability) Get the individual availability data points for the given auto group.
List<AvailabilityPoint>	findAvailabilitiesForResource(org.rhq.core.domain.auth.Subject subject, int resourceId, long begin, long end, int points, boolean withCurrentAvailability) Get the individual availability data points for the given resource.
List<AvailabilityPoint>	findAvailabilitiesForResourceGroup(org.rhq.core.domain.auth.Subject subject, int groupId, long begin, long end, int points, boolean withCurrentAvailability) Get the individual availability data points for the given resource group.
List<org.rhq.core.domain.measurement.Availability>	findAvailabilityWithinInterval(int resourceId, Date startDate, Date endDate) Deprecated.
org.rhq.core.domain.measurement.AvailabilityType	getCurrentAvailabilityTypeForResource(org.rhq.core.domain.auth.Subject subject, int resourceId) Indicates if the given resource is currently up (i.e.
void	mergeAvailabilitiesInNewTransaction(List<org.rhq.core.domain.measurement.Availability> availabilities, org.rhq.enterprise.server.measurement.AvailabilityManagerBean.MergeInfo mergeInfo) Internal use only.
boolean	mergeAvailabilityReport(org.rhq.core.domain.discovery.AvailabilityReport report) Merge an AvailabilityReport that has been received from an agent.
int	purgeAvailabilities(long oldest) Purges all availabilities that are old.
void	updateAgentResourceAvailabilities(int agentId, org.rhq.core.domain.measurement.AvailabilityType platformAvailabilityType, org.rhq.core.domain.measurement.AvailabilityType childAvailabilityType) Update availabilities for all resources managed by the given agent to the given availability type (which may be null to indicate unknown).
void	updateLastAvailabilityReportInNewTransaction(int agentId) Executing this method will update the given agent's lastAvailabilityReport time in a new transaction

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

findAvailabilityByCriteria, findAvailabilityForResource, getCurrentAvailabilityForResource

Method Detail

purgeAvailabilities

int purgeAvailabilities(long oldest)

Purges all availabilities that are old. The oldest time is the epoch milliseconds of the oldest availability that is to be retained. The end time is the time that is examined. No availability row with a null end time will ever be purged.

Parameters:

oldest - oldest time (in epoch milliseconds) to retain; older records get purged

Returns:

the number of availabilities that were purged

getCurrentAvailabilityTypeForResource

org.rhq.core.domain.measurement.AvailabilityType getCurrentAvailabilityTypeForResource(org.rhq.core.domain.auth.Subject subject,
                                                                                     int resourceId)

Indicates if the given resource is currently up (i.e. available) or down.

Parameters:

subject -

resourceId -

Returns:

the current status of the resource

findAvailabilitiesForResource

List<AvailabilityPoint> findAvailabilitiesForResource(org.rhq.core.domain.auth.Subject subject,
                                                    int resourceId,
                                                    long begin,
                                                    long end,
                                                    int points,
                                                    boolean withCurrentAvailability)

Get the individual availability data points for the given resource.

Parameters:

subject -

resourceId - PK of the resource wanted

begin - start time for data we are interested in

end - end time for data we are interested in

points - number of data points to return

withCurrentAvailability - if true, the last data point in the range will match the resource's current availability no matter what

Returns:

the availabilities over the given time span in a list

findAvailabilitiesForResourceGroup

List<AvailabilityPoint> findAvailabilitiesForResourceGroup(org.rhq.core.domain.auth.Subject subject,
                                                         int groupId,
                                                         long begin,
                                                         long end,
                                                         int points,
                                                         boolean withCurrentAvailability)

Get the individual availability data points for the given resource group.

Parameters:

subject -

groupId - PK of the resource group wanted

begin - start time for data we are interested in

end - end time for data we are interested in

points - number of data points to return

withCurrentAvailability - if true, the last data point in the range will match the resource group's current availability no matter what

Returns:

the availabilities over the given time span in a list

findAvailabilitiesForAutoGroup

List<AvailabilityPoint> findAvailabilitiesForAutoGroup(org.rhq.core.domain.auth.Subject subject,
                                                     int parentResourceId,
                                                     int resourceTypeId,
                                                     long begin,
                                                     long end,
                                                     int points,
                                                     boolean withCurrentAvailability)

Get the individual availability data points for the given auto group.

Parameters:

subject -

parentResourceId - PK of the parent resource of the auto group wanted

resourceTypeId - PK of the resource type of the auto group wanted

begin - start time for data we are interested in

end - end time for data we are interested in

points - number of data points to return

withCurrentAvailability - if true, the last data point in the range will match the autogroup's current availability no matter what

Returns:

the availabilities over the given time span in a list

mergeAvailabilityReport

boolean mergeAvailabilityReport(org.rhq.core.domain.discovery.AvailabilityReport report)

Merge an AvailabilityReport that has been received from an agent. A report will only contain those availabilities that have changed since the agent's last sent report. Note that if an agent has been restarted, it will always send a full report as its first. An agent is obliged to sent at least one availability record in the report in order for the server to determine which agent is sending the report (since a record has a Resource in it and from any Resource we can dsetermine the Agent).

Parameters:

report - the report containing 1 or more availabilities for 1 or more resources.

Returns:

If true, this indicates everything seems OK - the server merged everything successfully and the server and agent seem to be in sync with each. If false, the server thinks something isn't right and it may be out of sync with the agent. When false is returned, the caller should send in a full availability report the next time in order to ensure the server and agent are in sync. true should always be returned if the given availability report is already a full report.

mergeAvailabilitiesInNewTransaction

void mergeAvailabilitiesInNewTransaction(List<org.rhq.core.domain.measurement.Availability> availabilities,
                                       org.rhq.enterprise.server.measurement.AvailabilityManagerBean.MergeInfo mergeInfo)

Internal use only. Used only for transactional processing purposes.

Parameters:

availabilities -

mergeInfo -

updateLastAvailabilityReportInNewTransaction

void updateLastAvailabilityReportInNewTransaction(int agentId)

Executing this method will update the given agent's lastAvailabilityReport time in a new transaction

Parameters:

agentId - the id of the agent

updateAgentResourceAvailabilities

void updateAgentResourceAvailabilities(int agentId,
                                     org.rhq.core.domain.measurement.AvailabilityType platformAvailabilityType,
                                     org.rhq.core.domain.measurement.AvailabilityType childAvailabilityType)

Update availabilities for all resources managed by the given agent to the given availability type (which may be null to indicate unknown). NOTE: This does not include the top-level platform resource for the agent. To update a single resource avail see #updateResourceAvailability(Subject, Availability).

Parameters:

agentId - all resources managed by this agent will have their availabilities changed

platformAvailabilityType - the type that the agent's top level platform resource will have

childAvailabilityType - the type that the agent's child resources will have

findAvailabilityWithinInterval

@Deprecated
List<org.rhq.core.domain.measurement.Availability> findAvailabilityWithinInterval(int resourceId,
                                                                                           Date startDate,
                                                                                           Date endDate)

Deprecated.