Module io.helidon.metrics.api
Package io.helidon.metrics.spi

Interface MetricsProgrammaticConfig

All Known Implementing Classes:
MpMetricsProgrammaticConfig, SeMetricsProgrammaticConfig
public interface MetricsProgrammaticConfig
Programmatic (rather than user-configurable) settings that govern certain metrics behavior.

Implementations of this interface are typically provided by Helidon itself rather than developers building applications and are not intended for per-deployment (or even per-application) customization.

  • Method Details

    • instance

      static MetricsProgrammaticConfig instance()
      Returns the singleton instance of the metrics programmatic settings.

      Runtime code normally does not need to call this method. Metrics factory creation applies discovered MetricsProgrammaticConfig services to MetricsConfig automatically.

      Returns:
      the singleton

    • scopeDefaultValue

      default Optional<String> scopeDefaultValue()
      Default tag value to use for the scope tag if none is specified when the meter ID is created.
      Returns:
      default scope tag value

    • scopeTagName

      default Optional<String> scopeTagName()
      Name to use for a tag, added to each meter's identity, conveying its scope in output.
      Returns:
      the scope tag name

    • appTagName

      default Optional<String> appTagName()
      Name to use for a tag, added to each meter's identity, conveying the application it belongs to.
      Returns:
      the app tag name

    • reservedTagNames

      default Set<String> reservedTagNames()
      Returns the reserved tag names (for scope and app).
      Returns:
      reserved tag names

    • apply

      default MetricsConfig.Builder apply(MetricsConfig.Builder builder)
      Augments an existing MetricsConfig.Builder, presumably from actual config, with overrides provided by this programmatic config instance.
      Parameters:
      builder - original metrics configuration builder
      Returns:
      metrics config with any overrides applied

    • apply

      default MetricsConfig apply(MetricsConfig metricsConfig)
      Creates a new MetricsConfig instance by applying overrides from this programmatic config instance.
      Parameters:
      metricsConfig - original metrics configuration
      Returns:
      new metrics configuration with overrides applied