org.apache.flink.metrics.reporter

Interface MetricReporter

All Known Implementing Classes:

AbstractReporter

public interface MetricReporter

Reporters are used to export Metrics to an external backend.

Reporters are instantiated either a) via reflection, in which case they must be public, non-abstract, and have a public no-argument constructor. b) via a MetricReporterFactory, in which case no restrictions apply. (recommended)

Reporters are neither required nor encouraged to support both instantiation paths.

Method Summary

Modifier and Type	Method and Description
void	close() Closes this reporter.
void	notifyOfAddedMetric(Metric metric, String metricName, MetricGroup group) Called when a new Metric was added.
void	notifyOfRemovedMetric(Metric metric, String metricName, MetricGroup group) Called when a Metric was should be removed.
void	open(MetricConfig config) Configures this reporter.

Method Detail

open

void open(MetricConfig config)

Configures this reporter.

If the reporter was instantiated generically and hence parameter-less, this method is the place where the reporter sets it's basic fields based on configuration values. Otherwise, this method will typically be a no-op since resources can be acquired in the constructor.

This method is always called first on a newly instantiated reporter.

Parameters:

config - A properties object that contains all parameters set for this reporter.

close

void close()

Closes this reporter. Should be used to close channels, streams and release resources.

notifyOfAddedMetric

void notifyOfAddedMetric(Metric metric,
                         String metricName,
                         MetricGroup group)

Called when a new Metric was added.

Parameters:

metric - the metric that was added

metricName - the name of the metric

group - the group that contains the metric

notifyOfRemovedMetric

void notifyOfRemovedMetric(Metric metric,
                           String metricName,
                           MetricGroup group)

Called when a Metric was should be removed.

Parameters:

metric - the metric that should be removed

metricName - the name of the metric

group - the group that contains the metric