com.inductiveautomation.ignition.gateway.metrics

Interface MetricHistoryManager

public interface MetricHistoryManager

Created by mattgross on 3/15/2016. Defines the methods used to register a metric and retrieve a metric and its historical values from the internal system. Note that the internal system is NOT the internal database in /data/db.

Field Summary

Fields

Modifier and Type	Field and Description
static int	BASE_RETAIN_MINUTES
static int	BASE_UPDATE_MILLIS

Method Summary

Modifier and Type	Method and Description
java.util.List<Datapoint>	historyAll(java.lang.String metricName) Returns all history for the metric.
java.util.List<Datapoint>	historyInterpolated(java.lang.String metricName, int density) Returns all available history for the metric in a compressed form.
java.util.List<Datapoint>	historyMostRecent(java.lang.String metricName, int dataPoints) Returns the most recent X datapoints for the metric.
void	record(java.lang.String metricId, com.codahale.metrics.Metric metric)
void	record(java.lang.String metricId, com.codahale.metrics.Metric metric, int pollRateMillis, int retainMinutes)
void	registerCounter(com.codahale.metrics.Counter counter, java.lang.String counterPath) Registers the counter in both the GatewayContext metricRegistry and in this history manager..
void	registerCounter(com.codahale.metrics.Counter counter, java.lang.String counterPath, int pollRateMillis, int retainMinutes) Registers the counter in this history manager at the specified poll rate in milliseconds.
void	registerGauge(com.codahale.metrics.Gauge<java.lang.Double> gauge, java.lang.String gaugePath) Registers the gauge in this history manager.
void	registerGauge(com.codahale.metrics.Gauge<java.lang.Double> gauge, java.lang.String gaugePath, int pollRateMillis, int retainMinutes) Registers the gauge in this history manager at the specified poll rate in milliseconds.
void	stopRecording(java.lang.String metricId)
void	unregisterMetric(java.lang.String metricPath) Removes the metric this history manager.

Field Detail

BASE_UPDATE_MILLIS

static final int BASE_UPDATE_MILLIS

See Also:

Constant Field Values

BASE_RETAIN_MINUTES

static final int BASE_RETAIN_MINUTES

See Also:

Constant Field Values

Method Detail

record

void record(java.lang.String metricId,
            com.codahale.metrics.Metric metric)

record

void record(java.lang.String metricId,
            com.codahale.metrics.Metric metric,
            int pollRateMillis,
            int retainMinutes)

stopRecording

void stopRecording(java.lang.String metricId)

registerGauge

void registerGauge(com.codahale.metrics.Gauge<java.lang.Double> gauge,
                   java.lang.String gaugePath)

Registers the gauge in this history manager. After the gauge is registered, it is polled at the base update rate, and the polled value recorded in history. Values are retained for a few minutes (determined by the BASE_RETAIN_MINUTES value) and then are deleted from the internal database.

Parameters:

gauge -

gaugePath - the gauge can be retrieved at any time using this path

registerGauge

void registerGauge(com.codahale.metrics.Gauge<java.lang.Double> gauge,
                   java.lang.String gaugePath,
                   int pollRateMillis,
                   int retainMinutes)

Registers the gauge in this history manager at the specified poll rate in milliseconds. The retainMinutes parameter determines the number of minutes to retain the value in history before it is deleted.

Parameters:

gauge -

gaugePath - the gauge can be retrieved at any time using this path

pollRateMillis -

retainMinutes -

registerCounter

void registerCounter(com.codahale.metrics.Counter counter,
                     java.lang.String counterPath)

Registers the counter in both the GatewayContext metricRegistry and in this history manager.. After the counter is registered, it is polled at the base update rate, and the polled value recorded in history. Values are retained for a few minutes (determined by the BASE_RETAIN_MINUTES value) and then are deleted from the internal database.

Parameters:

counter -

counterPath - the counter can be retrieved at any time using this path

registerCounter

void registerCounter(com.codahale.metrics.Counter counter,
                     java.lang.String counterPath,
                     int pollRateMillis,
                     int retainMinutes)

Registers the counter in this history manager at the specified poll rate in milliseconds. The retainMinutes parameter determines the number of minutes to retain the value in the internal system before it is deleted.

Parameters:

counter -

counterPath - the counter can be retrieved at any time using this path

pollRateMillis -

retainMinutes -

unregisterMetric

void unregisterMetric(java.lang.String metricPath)

Removes the metric this history manager. All records related to the metric will also be purged.

Parameters:

metricPath - the path that was originally used to register the metric.

historyAll

java.util.List<Datapoint> historyAll(java.lang.String metricName)
                              throws java.sql.SQLException

Returns all history for the metric. The list is sorted chronologically, where the most recent value is at the end of the list.

Parameters:

metricName -

Returns:

Throws:

java.sql.SQLException

historyMostRecent

java.util.List<Datapoint> historyMostRecent(java.lang.String metricName,
                                            int dataPoints)
                                     throws java.sql.SQLException

Returns the most recent X datapoints for the metric. The list is sorted chronologically, where the most recent value is at the end of the list.

Parameters:

metricName -

dataPoints - the most recent X datapoints to return

Returns:

Throws:

java.sql.SQLException

historyInterpolated

java.util.List<Datapoint> historyInterpolated(java.lang.String metricName,
                                              int density)
                                       throws java.sql.SQLException

Returns all available history for the metric in a compressed form. Use the density parameter to thin out the history and remove in-between points. A value of 1 includes all points. A value of 2 includes every other point, and a value of 4 includes every 4th point, etc.

Parameters:

metricName -

density -

Returns:

Throws:

java.sql.SQLException