/**
 * Implementations are thread safe so plugins may use the PluginMetrics instance from multiple threads
 */
public interface PluginMetrics extends Closeable {* @param name        The name of the metric
     * @param description A human-readable description to include in the metric
     * @param tags        additional key/value attributes of the metric
     */
    MetricName metricName(String name, String description, Map<String, String> tags);

    /**
     * AddCreate a metric{@link toMetricName} monitorwith anthe objectgiven thatname, implementsdescription {@linkand MetricValueProvider}tags. ThisThe metricgroup won'twill be associatedset withto any"plugins"
     * sensor. This is a way to expose existing values as metrics.Tags to uniquely identify the plugins are automatically added to the provided tags
     *
     * @param metricName name        The name of the metric
     * @param metricValueProviderdescription TheA metrichuman-readable valuedescription providerto associatedinclude within thisthe metric
     * @throws IllegalArgumentException if a metric with same name already exists.@param tags        additional key/value attributes of the metric
     */
    voidMetricName addMetric(MetricName metricName, MetricValueProvider<?> metricValueProvidermetricName(String name, String description, Map<String, String> tags);

    /**
     * RemoveAdd a metric ifto itmonitor exists.
an object that implements  *
     * @param metricName The name of the metric
     * @throws IllegalArgumentException if the plugin has not already created a metric with this name{@link MetricValueProvider}. This metric won't be associated with any
     * sensor. This is a way to expose existing values as metrics.
     *
     */
 @param metricName The name voidof removeMetric(MetricName metricName);

the metric
    / **
 @param metricValueProvider The metric *value Createprovider aassociated sensor with thethis givenmetric
 unique name. The name must* only@throws beIllegalArgumentException uniqueif fora themetric plugin,with sosame differentname plugins can use the same namesalready exists.
     */
    void * @param name The sensor nameaddMetric(MetricName metricName, MetricValueProvider<?> metricValueProvider);

     * @return The sensor/**
     * @throwsRemove IllegalArgumentException if a sensormetric withif sameit nameexists.
 already exists for this plugin*
     */
 @param   Sensor sensor(StringmetricName The name);

 of the  /**metric
     * Remove@throws aIllegalArgumentException sensorif (ifthe itplugin exists)has andnot itsalready associatedcreated metrics.
a metric with this  *name
     */
 @param name The namevoid of the sensor to be removedremoveMetric(MetricName metricName);

    /**
     * Create @throwsa IllegalArgumentExceptionsensor ifwith the plugingiven hasunique notname. alreadyThe createdname a sensor with this namemust only be unique for the plugin, so different plugins can use the same names.
     */
     * void removeSensor(String@param name The sensor name);
}

/**
 * Get a configured instance of the give class specified by the given configuration key. If the object implements
 * Configurable configure it using the configuration. If the object implements Monitorable, set the appropriate PluginMetrics for that instance.
 *
 * @param key The configuration key for the class.
 * @param t The interface the class should implement.
 * @param metrics The metrics registry to use to build the PluginMetrics instance if the class implements Monitorable.
 * @return A configured instance of the class.
 */
public <T> T getConfiguredInstance(String key, Class<T> t, Metrics metrics);

/**
 * Get a configured instance of the give class specified by the given configuration key. If the object implements
 * Configurable configure it using the configuration. If the object implements Monitorable, set the appropriate PluginMetrics for that instance.
 *
 * @param key The configuration key for the class.
 * @param t The interface the class should implement.
 * @param configOverrides override origin configs.
 * @param metrics The metrics registry to use to build the PluginMetrics instance if the class implements Monitorable.
 * @return A configured instance of the class.
 */
public <T> T getConfiguredInstance(String key, Class<T> t, Map<String, Object> configOverrides, Metrics metrics);

/**
 * Get a configured instance of the give class specified by the given configuration key. If the object implements
 * Configurable configure it using the configuration. If the object implements Monitorable, set the appropriate PluginMetrics for that instance.
 * list of configured instances of the given class specified by the given configuration key. The configuration
 * may specify either null or an empty string to indicate no configured instances. If an instance implements Monitorable, 
 * set the appropriate PluginMetrics for that instance. In both cases, this method returns an empty list to indicate no configured instances.
 * @param key The configuration key for the class.
 * @param t The interface the class should implement.
 * @param configOverrides overrideConfiguration overrides originto configsuse.
 * @param metrics The metrics registry to use to build the PluginMetrics instanceinstances iffor theeach class that implements Monitorable.
 * @return AThe configured instancelist of theconfigured classinstances.
 */
public <T> TList<T> getConfiguredInstancegetConfiguredInstances(String key, Class<T> t, Map<String, Object> configOverrides, Metrics metrics);

/**
 * Get a list of configured instances of the given class specified by the given configuration key. The configuration
 * may specify either null or an empty string to indicate no configured instances. If an instance implements Monitorable, 
 * set the appropriate PluginMetrics for that instance. In both cases, this method returns an empty list to indicate no configured instances.
 * @param key The configuration key for the class.
 * @param t The interface the class should implement.
 * @param configOverrides Configuration overrides to use. classes.   
 * @param metricsclassNames The metrics registry to uselist of class names of the instances to build the PluginMetrics instances for eachcreate.
 * @param t The interface the class thatshould implements Monitorableimplement.
 * @return@param TheconfigOverrides listConfiguration ofoverrides configuredto instancesuse.
 */
public <T> List<T> getConfiguredInstances(String key, Class<T> t, Map<String, Object> configOverrides, Metrics metrics);

/**
 * Get a list of configured instances of the given class specified by the given configuration key. The configuration
 * may specify either null or an empty string to indicate no configured instances. If an instance implements Monitorable, 
 * set the appropriate PluginMetrics for that instance. In both cases, this method returns an empty list to indicate no configured instances.
 * @param key The configuration key for the classes.   
 * @param classNames The list of class names of the instances to create.
 * @param t The interface the class should implement.
 * @param configOverrides Configuration overrides to use.
 * @param metrics The metrics registry to use to build the PluginMetrics instances for each class that implements Monitorable.
 * @return The list of configured instances.
 */
public <T> List<T> getConfiguredInstances(String key, List<String> classNames, Class<T> t, Map<String, Object> configOverrides, Metrics metrics)

public interface Converter extends Closeable {

    @Override
    default void close() throws IOException {
        // no-op
    }
}