org.opennms.features.topology.api.info

Class MeasurementsWrapper

java.lang.Object

org.opennms.features.topology.api.info.MeasurementsWrapper

public class MeasurementsWrapper
extends Object

Constructor Summary

Constructors

Constructor and Description
MeasurementsWrapper(MeasurementsService measurementsService)

Method Summary

Modifier and Type	Method and Description
List<Double>	computeUtilization(OnmsNode node, String ifName) This method computes the utilization of a given interface resource.
List<Double>	computeUtilization(String resource, long start, long end, long step, String aggregation) This method computes the utilization of a given interface resource.
double	getLastValue(String resource, String attribute) Queries the Measuement Api for the last value found in a given timeframe.
double	getLastValue(String resource, String attribute, String aggregation) Queries the Measurement Api for the last value found in a given timeframe.
double	getLastValue(String resource, String attribute, String aggregation, boolean relaxed)
QueryResponse	query(QueryRequest request) Method to query the Measurements Api.
List<Double>	query(String resource, String attribute, long start, long end, long step, String aggregation, boolean relaxed) A method to query the Measurements Api for a given resource/attribute.

Methods inherited from class java.lang.Object

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

Constructor Detail

MeasurementsWrapper

public MeasurementsWrapper(MeasurementsService measurementsService)

Method Detail

getLastValue

public double getLastValue(String resource,
                           String attribute)
                    throws MeasurementException

Queries the Measuement Api for the last value found in a given timeframe.

Parameters:

resource - the resource to be used

attribute - the attribute to query for

Returns:

the last known value

Throws:

MeasurementException

getLastValue

public double getLastValue(String resource,
                           String attribute,
                           String aggregation)
                    throws MeasurementException

Queries the Measurement Api for the last value found in a given timeframe.

Parameters:

resource - the resource to be used

attribute - the attribute to query for

aggregation - the aggregation method

Returns:

the last known value

Throws:

MeasurementException

getLastValue

public double getLastValue(String resource,
                           String attribute,
                           String aggregation,
                           boolean relaxed)
                    throws MeasurementException

Throws:

MeasurementException

query

public List<Double> query(String resource,
                          String attribute,
                          long start,
                          long end,
                          long step,
                          String aggregation,
                          boolean relaxed)
                   throws MeasurementException

A method to query the Measurements Api for a given resource/attribute.

Parameters:

resource - the resource to be used

attribute - the attribute to query for

start - the start timestamp

end - the end timestamp

step - the step size

aggregation - the aggregation method

Returns:

the list of double values

Throws:

MeasurementException

computeUtilization

public List<Double> computeUtilization(OnmsNode node,
                                       String ifName)
                                throws MeasurementException

This method computes the utilization of a given interface resource. The method returns two double values encapsulated in a list. It uses the HC attributes for the computation and non-HC as fallback attributes.

Parameters:

node - the node to be used

ifName - the inteface of the node

Returns:

the in/out percentage utilization encapsulated in a list

Throws:

MeasurementException

computeUtilization

public List<Double> computeUtilization(String resource,
                                       long start,
                                       long end,
                                       long step,
                                       String aggregation)
                                throws MeasurementException

This method computes the utilization of a given interface resource. The method returns two double values encapsulated in a list. It uses the HC attributes for the computation and non-HC as fallback attributes.

Parameters:

resource - the resource for which the utilization must be computed

start - the start timestamp

end - the end timestamp

step - the step size

aggregation - the aggregation function

Returns:

a list containing two double values for the in/out percentage utilization

Throws:

MeasurementException

query

public QueryResponse query(QueryRequest request)
                    throws MeasurementException

Method to query the Measurements Api.

Parameters:

request - the request instance

Returns:

the response instance

Throws:

Exception

MeasurementException