org.apache.solr.metrics

Interface SolrMetricProducer

All Superinterfaces:

AutoCloseable

All Known Subinterfaces:

SolrCache<K,V>

All Known Implementing Classes:

AnalysisRequestHandlerBase, AuditLoggerPlugin, AuthenticationPlugin, AutoScalingHandler, AutoscalingHistoryHandler, BasicAuthPlugin, BlobHandler, BreakIteratorBoundaryScanner, CaffeineCache, CdcrRequestHandler, CdcrUpdateLog, CollectionsHandler, ConfigSetsHandler, ConfigurableInternodeAuthHadoopPlugin, ContentStreamHandlerBase, CoreAdminHandler, DefaultEncoder, DirectUpdateHandler2, DocumentAnalysisRequestHandler, DumpRequestHandler, ExportHandler, FastLRUCache, FieldAnalysisRequestHandler, FileFloatSource.ReloadCacheRequestHandler, GapFragmenter, GraphHandler, HadoopAuthPlugin, HdfsDirectoryFactory, HdfsLocalityReporter, HdfsUpdateLog, HealthCheckHandler, HighlightingPluginBase, HtmlEncoder, HtmlFormatter, HttpShardHandlerFactory, InfoHandler, InstrumentedHttpListenerFactory, InstrumentedHttpRequestExecutor, InstrumentedPoolingHttpClientConnectionManager, JWTAuthPlugin, KerberosPlugin, LFUCache, LoggingHandler, LRUCache, LukeRequestHandler, Metrics, MetricsCollectorHandler, MetricsHandler, MetricsHistoryHandler, MoreLikeThisHandler, MultiDestinationAuditLogger, NotFoundRequestHandler, PeerSync, PeerSyncWithLeader, PingRequestHandler, PKIAuthenticationPlugin, PluginInfoHandler, PropertiesRequestHandler, PublicKeyHandler, RealTimeGetHandler, RegexFragmenter, ReplicationHandler, RequestHandlerBase, SchemaHandler, ScoreOrderFragmentsBuilder, SearchHandler, SecurityConfHandler, SecurityConfHandlerLocal, SecurityConfHandlerZk, SegmentsInfoRequestHandler, ShowFileRequestHandler, SimpleBoundaryScanner, SimpleFragListBuilder, SimpleFragmentsBuilder, SingleFragListBuilder, SolrBoundaryScanner, SolrConfigHandler, SolrCore, SolrFieldCacheBean, SolrFragmentsBuilder, SolrIndexSearcher, SolrInfoMBeanHandler, SolrLogAuditLoggerPlugin, SQLHandler, StandardRequestHandler, StreamHandler, SuggestComponent, SystemInfoHandler, TaggerRequestHandler, ThreadDumpHandler, UpdateLog, UpdateRequestHandler, UpdateRequestHandlerApi, UpdateShardHandler, WeightedFragListBuilder, ZookeeperInfoHandler, ZookeeperStatusHandler

public interface SolrMetricProducer
extends AutoCloseable

Used by objects that expose metrics through SolrMetricManager.

Method Summary

Modifier and Type	Method and Description
default void	close() Implementations should always call SolrMetricProducer.super.close() to ensure that metrics with the same life-cycle as this component are properly unregistered.
default SolrMetricsContext	getSolrMetricsContext() Implementing classes should override this method to provide the context obtained in initializeMetrics(SolrMetricsContext, String) to ensure proper cleanup of metrics at the end of the life-cycle of this component.
static String	getUniqueMetricTag(Object o, String parentName) Unique metric tag identifies components with the same life-cycle, which should be registered / unregistered together.
default void	initializeMetrics(SolrMetricManager manager, String registry, String tag, String scope) Deprecated. use initializeMetrics(SolrMetricsContext, String) instead
default void	initializeMetrics(SolrMetricsContext parentContext, String scope) Initialize metrics specific to this producer.

Method Detail

getUniqueMetricTag

static String getUniqueMetricTag(Object o,
                                 String parentName)

Unique metric tag identifies components with the same life-cycle, which should be registered / unregistered together. It is in the format of A:B:C, where A is the parent of B is the parent of C and so on. If object "B" is unregistered C also must get unregistered. If object "A" is unregistered B and C also must get unregistered.

Parameters:

o - object to create a tag for

parentName - parent object name, or null if no parent exists

initializeMetrics

@Deprecated
default void initializeMetrics(SolrMetricManager manager,
                                           String registry,
                                           String tag,
                                           String scope)

Deprecated. use initializeMetrics(SolrMetricsContext, String) instead

Initializes metrics specific to this producer

Parameters:

manager - an instance of SolrMetricManager

registry - registry name where metrics are registered

tag - a symbolic tag that represents this instance of the producer, or a group of related instances that have the same life-cycle. This tag is used when managing life-cycle of some metrics.

scope - scope of the metrics (eg. handler name) to separate metrics of components with the same implementation but different scope.

initializeMetrics

default void initializeMetrics(SolrMetricsContext parentContext,
                               String scope)

Initialize metrics specific to this producer.

Parameters:

parentContext - parent metrics context. If this component has the same life-cycle as the parent it can simply use the parent context, otherwise it should obtain a child context using SolrMetricsContext.getChildContext(Object) passing this as the child.

scope - component scope

getSolrMetricsContext

default SolrMetricsContext getSolrMetricsContext()

Implementing classes should override this method to provide the context obtained in initializeMetrics(SolrMetricsContext, String) to ensure proper cleanup of metrics at the end of the life-cycle of this component.

close

default void close()
            throws IOException

Implementations should always call SolrMetricProducer.super.close() to ensure that metrics with the same life-cycle as this component are properly unregistered. This prevents obscure memory leaks. from: https://docs.oracle.com/javase/8/docs/api/java/lang/AutoCloseable.html While this interface method is declared to throw Exception, implementers are strongly encouraged to declare concrete implementations of the close method to throw more specific exceptions, or to throw no exception at all if the close operation cannot fail.

Specified by:

close in interface AutoCloseable

Throws:

IOException