Package org.infinispan.metrics.impl

Interface MetricsRegistry

All Superinterfaces:

Constants

All Known Implementing Classes:

MetricsRegistryImpl, NoMetricRegistry

public interface MetricsRegistry
extends Constants

A registry for metrics.

This component should not have any dependency on any other component. Also, the tag Constants.CACHE_MANAGER_TAG_NAME should be set and match the one defined in GlobalConfiguration.cacheManagerName().

This registry should only be used if it needs to register metrics before the Transport is started. Otherwise, MetricsCollector should be used as it adds tags related to the node.

Field Summary

Fields inherited from interface org.infinispan.metrics.Constants

CACHE_MANAGER_TAG_NAME, CACHE_TAG_NAME, JGROUPS_CLUSTER_TAG_NAME, JGROUPS_PREFIX, NODE_TAG_NAME, SITE_TAG_NAME, TARGET_NODE

Method Summary

Modifier and Type	Method	Description
boolean	namesAsTags()	Same as GlobalMetricsConfiguration.namesAsTags().
Set<Object>	registerMetrics(Object instance, Collection<org.infinispan.commons.stat.MetricInfo> attributes, String namePrefix, Map<String,String> tags)	Register the MBeanMetadata.AttributeMetadata as metrics.
String	scrape(String contentType)	Prometheus like scrapping of the registered metrics.
boolean	supportScrape()	If this instance supports scrapping.
void	unregisterMetric(Object metricId)	Unregisters a single metric.
default void	unregisterMetrics(Collection<Object> metricsId)	Unregisters multiple metrics.

Method Details

registerMetrics

Set<Object> registerMetrics(Object instance,
 Collection<org.infinispan.commons.stat.MetricInfo> attributes,
 String namePrefix,
 Map<String,String> tags)

Register the MBeanMetadata.AttributeMetadata as metrics.

Parameters:

instance - The instance from where metrics are collected.

attributes - The attribute (metrics) to be registered, if valid.

namePrefix - The prefix or the component name.

tags - Extra tags to be attached to the metrics.

Returns:

A set of ids that can be used by unregisterMetric(Object) or unregisterMetrics(Collection).

unregisterMetric

void unregisterMetric(Object metricId)

Unregisters a single metric.

If the metricId is not a valid id, this method does nothing.

Parameters:

metricId - The metric id as returned by registerMetrics(Object, Collection, String, Map).

unregisterMetrics

default void unregisterMetrics(Collection<Object> metricsId)

Unregisters multiple metrics.

Check unregisterMetric(Object) for more details.

Parameters:

metricsId - The metric id as returned by registerMetrics(Object, Collection, String, Map).

namesAsTags

boolean namesAsTags()

Same as GlobalMetricsConfiguration.namesAsTags().

Returns:

true if it should use tags to identify the cluster, site or cache manager name.

supportScrape

boolean supportScrape()

If this instance supports scrapping.

Returns:

true if it supports Prometheus scrapping.

See Also:

• scrape(String)

scrape

String scrape(String contentType)

Prometheus like scrapping of the registered metrics.

It returns null if supportScrape() returns false.

Parameters:

contentType - A valid content-type.

Returns:

A String with the metrics values.