net.jxta.meter
Interface ServiceMonitor

All Superinterfaces:

Module

public interface ServiceMonitor

extends Module

The base interface for all ServiceMonitors For complete information about Service Monitors see the Document Designing and Implementing Service Monitors

getModuleClassID

public ModuleClassID getModuleClassID()

Get ModuleClassID of this ServiceMonitor

getServiceMetric

public ServiceMetric getServiceMetric(ServiceMonitorFilter serviceMonitorFilter,
                                      long fromTime,
                                      long toTime,
                                      int pulseIndex,
                                      long reportRate)

Get ServiceMetrics accrued in during this pulse interval

Parameters:

serviceMonitorFilter - Filter Metrics based upon this MonitorFilter

fromTime - Beginning time as determined by the MonitorManager

toTime - Ending time as determined by the MonitorManager

pulseIndex - Pulse Index of the reporting rate Pyramid

reportRate - Reporting Rate (corresponding to the PulseNumber's index)

beginCumulativeReport

public void beginCumulativeReport()

A request for a cumulative Report(s) are coming, prepare to receive them

See Also:

endCumulativeReport()

getCumulativeServiceMetric

public ServiceMetric getCumulativeServiceMetric(ServiceMonitorFilter serviceMonitorFilter,
                                                long fromTime,
                                                long toTime)

Get ServiceMetrics since the start (or last reset time) of this ServiceMonitor. Calls to this will only occurr between calls to beginCumulativeReport() and endCumulativeReport()

Parameters:

serviceMonitorFilter - Filter Metrics based upon this MonitorFilter

fromTime - Beginning time as determined by the MonitorManager

toTime - Ending time as determined by the MonitorManager

See Also:

beginCumulativeReport(), endCumulativeReport()

endCumulativeReport

public void endCumulativeReport()

Indication that the flurry of requests for cumulative Report is over

See Also:

beginCumulativeReport()

validateCumulativeServiceMonitorFilter

public void validateCumulativeServiceMonitorFilter(ServiceMonitorFilter serviceMonitorFilter)
                                            throws MonitorFilterException

Validate ServiceMonitorFilter for a cumulative Report

Throws:

MonitorFilterException

validateServiceMonitorFilter

public void validateServiceMonitorFilter(ServiceMonitorFilter serviceMonitorFilter,
                                         long reportRate)
                                  throws MonitorFilterException

Validate ServiceMonitorFilter for a periodic Reporting

Throws:

MonitorFilterException

createSupportedCumulativeServiceMonitorFilter

public ServiceMonitorFilter createSupportedCumulativeServiceMonitorFilter(ServiceMonitorFilter serviceMonitorFilter)
                                                                   throws MonitorFilterException

Transform the provided ServiceMonitorFilter into one that is supported for cumulative reporting

Throws:

MonitorFilterException

createSupportedServiceMonitorFilter

public ServiceMonitorFilter createSupportedServiceMonitorFilter(ServiceMonitorFilter serviceMonitorFilter,
                                                                long reportRate)
                                                         throws MonitorFilterException

Transform the provided ServiceMonitorFilter into one that is supported for periodic reporting at the specified rate

Throws:

MonitorFilterException

serviceMonitorFilterRegistered

public void serviceMonitorFilterRegistered(ServiceMonitorFilter serviceMonitorFilter,
                                           int reportRateIndex,
                                           long reportRate,
                                           boolean newRate)

Information that the Monitor Manager has accepted a Monitoring for this filter at this rate

Parameters:

serviceMonitorFilter - Accepted Filter

reportRateIndex - Pulse Index into pyramid of accepted rate

reportRate - Accepted reporting rate

newRate - Is this a new reporting rate (ie you don't have any currently registered at this rate)

serviceMonitorFilterDeregistered

public void serviceMonitorFilterDeregistered(ServiceMonitorFilter serviceMonitorFilter,
                                             int reportRateIndex,
                                             long reportRate,
                                             boolean retiredRate)

Information that the Monitor Manager is deregistering the Monitoring for this filter at this rate

Parameters:

serviceMonitorFilter - Deregistered Filter

reportRateIndex - Pulse Index into pyramid of deregistered filter

reportRate - Reporting rate of deregistered filter

retiredRate - Is this a retired filter the last one registered at this rate (ie you don't have to keep metrics for this rate any longer)

destroy

public void destroy()

Clean up. The PeerGroup is probably about to be destroyed