Class MicrometerMetricsExporter

java.lang.Object
cloud.opencode.base.cache.metrics.MicrometerMetricsExporter
public final class MicrometerMetricsExporter extends Object
Micrometer Metrics Exporter - Export cache metrics to Micrometer registry Micrometer 指标导出器 - 将缓存指标导出到 Micrometer 注册表

Provides integration with Micrometer for cache monitoring. Uses a registry abstraction to avoid compile-time dependency on Micrometer.

提供与 Micrometer 的集成用于缓存监控。使用注册表抽象避免对 Micrometer 的编译时依赖。

Exported Metrics | 导出的指标:

  • cache.gets{result=hit|miss} - Cache get operations | 缓存获取操作
  • cache.puts - Cache put operations | 缓存放入操作
  • cache.evictions - Cache evictions | 缓存淘汰
  • cache.size - Current cache size | 当前缓存大小
  • cache.load.duration - Load duration | 加载耗时
  • cache.get.latency - Get latency percentiles | 获取延迟百分位

Usage Examples | 使用示例:

// With actual Micrometer
MeterRegistry registry = new SimpleMeterRegistry();
MicrometerMetricsExporter exporter = MicrometerMetricsExporter.builder()
    .registry(MicrometerRegistry.wrap(registry))
    .prefix("app")
    .tag("env", "production")
    .build();

exporter.register("users", userCache);
exporter.registerAll(CacheManager.getInstance());

Features | 主要功能:

  • Micrometer registry integration - Micrometer 注册表集成
  • Auto-register all managed caches - 自动注册所有托管缓存
  • Custom tags and prefix support - 自定义标签和前缀支持
  • Latency percentile export - 延迟百分位导出

Security | 安全性:

  • Thread-safe: Yes - 线程安全: 是
  • Null-safe: Yes - 空值安全: 是
Since:
JDK 25, opencode-base-cache V1.0.0
Author:
Leon Soo www.LeonSoo.com
See Also:

  • Method Details

    • builder

      public static MicrometerMetricsExporter.Builder builder()
      Create exporter builder 创建导出器构建器
      Returns:
      builder | 构建器

    • create

      public static MicrometerMetricsExporter create(MicrometerMetricsExporter.MeterRegistry registry)
      Create exporter with registry 使用注册表创建导出器
      Parameters:
      registry - meter registry | 指标注册表
      Returns:
      exporter | 导出器

    • register

      public <K,V> MicrometerMetricsExporter register(String name, Cache<K,V> cache)
      Register a cache for metrics collection 注册缓存进行指标收集
      Type Parameters:
      K - key type | 键类型
      V - value type | 值类型
      Parameters:
      name - cache name | 缓存名称
      cache - the cache | 缓存
      Returns:
      this exporter | 此导出器

    • registerAll

      public MicrometerMetricsExporter registerAll(CacheManager manager)
      Register all caches from CacheManager 从 CacheManager 注册所有缓存
      Parameters:
      manager - cache manager | 缓存管理器
      Returns:
      this exporter | 此导出器

    • unregister

      public MicrometerMetricsExporter unregister(String name)
      Unregister a cache 取消注册缓存
      Parameters:
      name - cache name | 缓存名称
      Returns:
      this exporter | 此导出器