All Downloads are FREE. Search and download functionalities are using the official Maven repository.

io.quarkus.smallrye.metrics.runtime.SmallRyeMetricsRecorder Maven / Gradle / Ivy

There is a newer version: 3.17.0
Show newest version
package io.quarkus.smallrye.metrics.runtime;

import java.lang.management.BufferPoolMXBean;
import java.lang.management.ClassLoadingMXBean;
import java.lang.management.GarbageCollectorMXBean;
import java.lang.management.ManagementFactory;
import java.lang.management.MemoryMXBean;
import java.lang.management.MemoryPoolMXBean;
import java.lang.management.MemoryType;
import java.lang.management.OperatingSystemMXBean;
import java.lang.management.RuntimeMXBean;
import java.lang.management.ThreadInfo;
import java.lang.management.ThreadMXBean;
import java.util.Arrays;
import java.util.List;
import java.util.function.Consumer;

import jakarta.enterprise.inject.spi.CDI;

import org.eclipse.microprofile.metrics.ConcurrentGauge;
import org.eclipse.microprofile.metrics.Counter;
import org.eclipse.microprofile.metrics.Gauge;
import org.eclipse.microprofile.metrics.Histogram;
import org.eclipse.microprofile.metrics.Metadata;
import org.eclipse.microprofile.metrics.Metered;
import org.eclipse.microprofile.metrics.MetricRegistry;
import org.eclipse.microprofile.metrics.MetricType;
import org.eclipse.microprofile.metrics.MetricUnits;
import org.eclipse.microprofile.metrics.Tag;
import org.eclipse.microprofile.metrics.Timer;
import org.jboss.logging.Logger;

import io.quarkus.arc.runtime.BeanContainer;
import io.quarkus.runtime.ImageMode;
import io.quarkus.runtime.ShutdownContext;
import io.quarkus.runtime.annotations.Recorder;
import io.quarkus.runtime.metrics.MetricsFactory;
import io.smallrye.metrics.ExtendedMetadata;
import io.smallrye.metrics.ExtendedMetadataBuilder;
import io.smallrye.metrics.MetricRegistries;
import io.smallrye.metrics.MetricsRequestHandler;
import io.smallrye.metrics.elementdesc.BeanInfo;
import io.smallrye.metrics.elementdesc.MemberInfo;
import io.smallrye.metrics.interceptors.MetricResolver;
import io.smallrye.metrics.setup.MetricsMetadata;

@Recorder
public class SmallRyeMetricsRecorder {

    private static final Logger log = Logger.getLogger("io.quarkus.metrics");

    // threading
    private static final String THREAD_COUNT = "thread.count";
    private static final String THREAD_DAEMON_COUNT = "thread.daemon.count";
    private static final String THREAD_MAX_COUNT = "thread.max.count";

    // class loading
    private static final String CURRENT_LOADED_CLASS_COUNT = "classloader.loadedClasses.count";
    private static final String TOTAL_LOADED_CLASS_COUNT = "classloader.loadedClasses.total";
    private static final String TOTAL_UNLOADED_CLASS_COUNT = "classloader.unloadedClasses.total";

    // runtime
    private static final String JVM_UPTIME = "jvm.uptime";

    // operating system
    private static final String SYSTEM_LOAD_AVERAGE = "cpu.systemLoadAverage";
    private static final String CPU_AVAILABLE_PROCESSORS = "cpu.availableProcessors";
    private static final String SYSTEM_CPU_LOAD = "cpu.systemCpuLoad";
    private static final String PROCESS_CPU_LOAD = "cpu.processCpuLoad";
    private static final String PROCESS_CPU_TIME = "cpu.processCpuTime";
    private static final String FREE_PHYSICAL_MEM_SIZE = "memory.freePhysicalSize";
    private static final String FREE_SWAP_SIZE = "memory.freeSwapSize";

    // memory
    private static final String MEMORY_COMMITTED_NON_HEAP = "memory.committedNonHeap";
    private static final String MEMORY_COMMITTED_HEAP = "memory.committedHeap";
    private static final String MEMORY_MAX_HEAP = "memory.maxHeap";
    private static final String MEMORY_MAX_NON_HEAP = "memory.maxNonHeap";
    private static final String MEMORY_USED_HEAP = "memory.usedHeap";
    private static final String MEMORY_USED_NON_HEAP = "memory.usedNonHeap";

    private static final SmallRyeMetricsFactory factory = new SmallRyeMetricsFactory();

    public SmallRyeMetricsHandler handler(String metricsPath) {
        SmallRyeMetricsHandler handler = new SmallRyeMetricsHandler();
        handler.setMetricsPath(metricsPath);
        // tell the metrics internal handler to not append CORS headers
        // these will be handled by the Quarkus CORS filter, if enabled
        CDI.current().select(MetricsRequestHandler.class).get().appendCorsHeaders(false);
        return handler;
    }

    public void registerVendorMetrics() {
        MetricRegistry registry = MetricRegistries.get(MetricRegistry.Type.VENDOR);
        memoryPoolMetrics(registry);
        vendorSpecificMemoryMetrics(registry);
        vendorOperatingSystemMetrics(registry);
    }

    public void registerBaseMetrics() {
        MetricRegistry registry = MetricRegistries.get(MetricRegistry.Type.BASE);

        garbageCollectionMetrics(registry);
        classLoadingMetrics(registry);
        baseOperatingSystemMetrics(registry);
        threadingMetrics(registry);
        runtimeMetrics(registry);
        baseMemoryMetrics(registry);
    }

    public void registerMicrometerJvmMetrics(ShutdownContext shutdown) {
        MetricRegistry registry = MetricRegistries.get(MetricRegistry.Type.BASE);

        micrometerJvmGcMetrics(registry, shutdown);
        micrometerJvmThreadMetrics(registry);
        micrometerJvmMemoryMetrics(registry);
        micrometerJvmClassLoaderMetrics(registry);
        micrometerRuntimeMetrics(registry);
    }

    public void registerMetrics(BeanInfo beanInfo, MemberInfo memberInfo) {
        MetricRegistry registry = MetricRegistries.get(MetricRegistry.Type.APPLICATION);
        MetricsMetadata.registerMetrics(registry,
                new MetricResolver(),
                beanInfo,
                memberInfo);
    }

    public void registerMetric(MetricRegistry.Type scope,
            MetadataHolder metadataHolder,
            TagHolder[] tagHolders,
            Object implementor) {
        Metadata metadata = metadataHolder.toMetadata();
        Tag[] tags = Arrays.stream(tagHolders).map(TagHolder::toTag).toArray(Tag[]::new);
        MetricRegistry registry = MetricRegistries.get(scope);

        switch (metadata.getTypeRaw()) {
            case GAUGE:
                registry.register(metadata, (Gauge) implementor, tags);
                break;
            case TIMER:
                if (implementor == null) {
                    registry.timer(metadata, tags);
                } else {
                    registry.register(metadata, (Timer) implementor);
                }
                break;
            case COUNTER:
                if (implementor == null) {
                    registry.counter(metadata, tags);
                } else {
                    registry.register(metadata, (Counter) implementor, tags);
                }
                break;
            case HISTOGRAM:
                if (implementor == null) {
                    registry.histogram(metadata, tags);
                } else {
                    registry.register(metadata, (Histogram) implementor, tags);
                }
                break;
            case CONCURRENT_GAUGE:
                if (implementor == null) {
                    registry.concurrentGauge(metadata, tags);
                } else {
                    registry.register(metadata, (ConcurrentGauge) implementor, tags);
                }
                break;
            case METERED:
                if (implementor == null) {
                    registry.meter(metadata, tags);
                } else {
                    registry.register(metadata, (Metered) implementor, tags);
                }
                break;
            case INVALID:
                break;
            default:
                break;
        }
    }

    public void registerMetrics(Consumer consumer) {
        if (consumer != null) {
            consumer.accept(factory);
        }
    }

    public void createRegistries(BeanContainer container) {
        MetricRegistries.get(MetricRegistry.Type.APPLICATION);
        MetricRegistries.get(MetricRegistry.Type.BASE);
        MetricRegistries.get(MetricRegistry.Type.VENDOR);

        //HACK: registration is done via statics, but cleanup is done via pre destroy
        //however if the bean is not used it will not be created, so no cleanup will be done
        //we force bean creation here to make sure the container can restart correctly
        container.beanInstance(MetricRegistries.class).getApplicationRegistry();
    }

    public void dropRegistriesAtShutdown(ShutdownContext shutdownContext) {
        shutdownContext.addShutdownTask(MetricRegistries::dropAll);
    }

    private void garbageCollectionMetrics(MetricRegistry registry) {
        List gcs = ManagementFactory.getGarbageCollectorMXBeans();
        if (gcs.isEmpty()) {
            return;
        }
        Metadata countMetadata = Metadata.builder()
                .withName("gc.total")
                .withType(MetricType.COUNTER)
                .withDisplayName("Garbage Collection Count")
                .withUnit("none")
                .withDescription(
                        "Displays the total number of collections that have occurred. This attribute lists -1 if the collection count is undefined for this collector.")
                .build();
        Metadata timeMetadata = Metadata.builder()
                .withName("gc.time")
                .withType(MetricType.COUNTER)
                .withDisplayName("Garbage Collection Time")
                .withUnit("milliseconds")
                .withDescription(
                        "Displays the approximate accumulated collection elapsed time in milliseconds. This attribute " +
                                "displays -1 if the collection elapsed time is undefined for this collector. The Java " +
                                "virtual machine implementation may use a high resolution timer to measure the " +
                                "elapsed time. This attribute may display the same value even if the collection " +
                                "count has been incremented if the collection elapsed time is very short.")
                .build();
        for (GarbageCollectorMXBean gc : gcs) {
            registry.register(countMetadata, new GetCountOnlyCounter() {
                @Override
                public long getCount() {
                    return gc.getCollectionCount();
                }
            }, new Tag("name", gc.getName()));
            registry.register(timeMetadata, new GetCountOnlyCounter() {
                @Override
                public long getCount() {
                    return gc.getCollectionTime();
                }
            }, new Tag("name", gc.getName()));
        }
    }

    private void classLoadingMetrics(MetricRegistry registry) {
        ClassLoadingMXBean classLoadingMXBean = ManagementFactory.getClassLoadingMXBean();

        Metadata meta = Metadata.builder()
                .withName(TOTAL_LOADED_CLASS_COUNT)
                .withType(MetricType.COUNTER)
                .withDisplayName("Total Loaded Class Count")
                .withDescription(
                        "Displays the total number of classes that have been loaded since the Java virtual machine has started execution.")
                .build();
        registry.register(meta, new GetCountOnlyCounter() {
            @Override
            public long getCount() {
                return classLoadingMXBean.getTotalLoadedClassCount();
            }
        });

        meta = Metadata.builder()
                .withName(TOTAL_UNLOADED_CLASS_COUNT)
                .withType(MetricType.COUNTER)
                .withDisplayName("Total Unloaded Class Count")
                .withDescription(
                        "Displays the total number of classes unloaded since the Java virtual machine has started execution.")
                .build();
        registry.register(meta, new GetCountOnlyCounter() {
            @Override
            public long getCount() {
                return classLoadingMXBean.getUnloadedClassCount();
            }
        });

        meta = Metadata.builder()
                .withName(CURRENT_LOADED_CLASS_COUNT)
                .withType(MetricType.GAUGE)
                .withDisplayName("Current Loaded Class Count")
                .withDescription("Displays the number of classes that are currently loaded in the Java virtual machine.")
                .build();
        registry.register(meta, new Gauge() {
            @Override
            public Number getValue() {
                return classLoadingMXBean.getLoadedClassCount();
            }
        });
    }

    private void baseOperatingSystemMetrics(MetricRegistry registry) {
        OperatingSystemMXBean operatingSystemMXBean = ManagementFactory.getOperatingSystemMXBean();

        Metadata meta = Metadata.builder()
                .withName(SYSTEM_LOAD_AVERAGE)
                .withType(MetricType.GAUGE)
                .withDisplayName("System Load Average")
                .withDescription("Displays the system load average for the last minute. The system load average " +
                        "is the sum of the number of runnable entities queued to the available processors and the " +
                        "number of runnable entities running on the available processors averaged over a period of time. " +
                        "The way in which the load average is calculated is operating system specific but is typically a " +
                        "damped time-dependent average. If the load average is not available, a negative value is displayed. " +
                        "This attribute is designed to provide a hint about the system load and may be queried frequently. " +
                        "The load average may be unavailable on some platforms where it is expensive to implement this method.")
                .build();
        registry.register(meta, new Gauge() {
            @Override
            public Number getValue() {
                return operatingSystemMXBean.getSystemLoadAverage();
            }
        });

        meta = Metadata.builder()
                .withName(CPU_AVAILABLE_PROCESSORS)
                .withType(MetricType.GAUGE)
                .withDisplayName("Available Processors")
                .withDescription(
                        "Displays the number of processors available to the Java virtual machine. This value may change during "
                                +
                                "a particular invocation of the virtual machine.")
                .build();
        registry.register(meta, new Gauge() {
            @Override
            public Number getValue() {
                return operatingSystemMXBean.getAvailableProcessors();
            }
        });

        // some metrics are only available in jdk internal class 'com.sun.management.OperatingSystemMXBean': cast to it.
        // com.sun.management.OperatingSystemMXBean is not available in SubstratVM
        // the cast will fail for some JVM not derived from HotSpot (J9 for example) so we check if it is assignable to it
        if (ImageMode.current() == ImageMode.JVM
                && com.sun.management.OperatingSystemMXBean.class.isAssignableFrom(operatingSystemMXBean.getClass())) {
            try {
                com.sun.management.OperatingSystemMXBean internalOperatingSystemMXBean = (com.sun.management.OperatingSystemMXBean) operatingSystemMXBean;
                meta = Metadata.builder()
                        .withName(PROCESS_CPU_LOAD)
                        .withType(MetricType.GAUGE)
                        .withUnit(MetricUnits.PERCENT)
                        .withDisplayName("Process CPU load")
                        .withDescription("Displays  the \"recent cpu usage\" for the Java Virtual Machine process. " +
                                "This value is a double in the [0.0,1.0] interval. A value of 0.0 means that none of " +
                                "the CPUs were running threads from the JVM process during the recent period of time " +
                                "observed, while a value of 1.0 means that all CPUs were actively running threads from " +
                                "the JVM 100% of the time during the recent period being observed. Threads from the JVM " +
                                "include the application threads as well as the JVM internal threads. " +
                                "All values between 0.0 and 1.0 are possible depending of the activities going on in " +
                                "the JVM process and the whole system. " +
                                "If the Java Virtual Machine recent CPU usage is not available, the method returns a negative value.")
                        .build();
                registry.register(meta, new Gauge() {
                    @Override
                    public Number getValue() {
                        return internalOperatingSystemMXBean.getProcessCpuLoad();
                    }
                });
            } catch (ClassCastException cce) {
                // this should never occur
                log.debug("Unable to cast the OperatingSystemMXBean to com.sun.management.OperatingSystemMXBean, " +
                        "not registering extended operating system metrics", cce);
            }
        }
    }

    private void vendorOperatingSystemMetrics(MetricRegistry registry) {
        OperatingSystemMXBean operatingSystemMXBean = ManagementFactory.getOperatingSystemMXBean();

        // some metrics are only available in jdk internal class 'com.sun.management.OperatingSystemMXBean': cast to it.
        // com.sun.management.OperatingSystemMXBean is not available in SubstratVM
        // the cast will fail for some JVM not derived from HotSpot (J9 for example) so we check if it is assignable to it
        if (ImageMode.current() == ImageMode.JVM
                && com.sun.management.OperatingSystemMXBean.class.isAssignableFrom(operatingSystemMXBean.getClass())) {
            try {
                com.sun.management.OperatingSystemMXBean internalOperatingSystemMXBean = (com.sun.management.OperatingSystemMXBean) operatingSystemMXBean;
                Metadata meta = Metadata.builder()
                        .withName(SYSTEM_CPU_LOAD)
                        .withType(MetricType.GAUGE)
                        .withUnit(MetricUnits.PERCENT)
                        .withDisplayName("System CPU load")
                        .withDescription("Displays the \"recent cpu usage\" for the whole system. This value is a double " +
                                "in the [0.0,1.0] interval. A value of 0.0 means that all CPUs were idle during the recent " +
                                "period of time observed, while a value of 1.0 means that all CPUs were actively running " +
                                "100% of the time during the recent period being observed. " +
                                "All values betweens 0.0 and 1.0 are possible depending of the activities going on in the " +
                                "system. If the system recent cpu usage is not available, the method returns a negative value.")
                        .build();
                registry.register(meta, new Gauge() {
                    @Override
                    public Number getValue() {
                        return internalOperatingSystemMXBean.getSystemCpuLoad();
                    }
                });

                meta = Metadata.builder()
                        .withName(PROCESS_CPU_TIME)
                        .withType(MetricType.GAUGE)
                        .withUnit(MetricUnits.NANOSECONDS)
                        .withDisplayName("Process CPU time")
                        .withDescription(
                                "Displays the CPU time used by the process on which the Java virtual machine is running " +
                                        "in nanoseconds. The returned value is of nanoseconds precision but not necessarily " +
                                        "nanoseconds accuracy. This method returns -1 if the the platform does not support " +
                                        "this operation.")
                        .build();
                registry.register(meta, new Gauge() {
                    @Override
                    public Number getValue() {
                        return internalOperatingSystemMXBean.getProcessCpuTime();
                    }
                });

                meta = Metadata.builder()
                        .withName(FREE_PHYSICAL_MEM_SIZE)
                        .withType(MetricType.GAUGE)
                        .withUnit(MetricUnits.BYTES)
                        .withDisplayName("Free physical memory size")
                        .withDescription("Displays the amount of free physical memory in bytes.")
                        .build();
                registry.register(meta, new Gauge() {
                    @Override
                    public Number getValue() {
                        return internalOperatingSystemMXBean.getFreePhysicalMemorySize();
                    }
                });

                meta = Metadata.builder()
                        .withName(FREE_SWAP_SIZE)
                        .withType(MetricType.GAUGE)
                        .withUnit(MetricUnits.BYTES)
                        .withDisplayName("Free swap size")
                        .withDescription("Displays the amount of free swap space in bytes.")
                        .build();
                registry.register(meta, new Gauge() {
                    @Override
                    public Number getValue() {
                        return internalOperatingSystemMXBean.getFreeSwapSpaceSize();
                    }
                });
            } catch (ClassCastException cce) {
                // this should never occur
                log.debug("Unable to cast the OperatingSystemMXBean to com.sun.management.OperatingSystemMXBean, " +
                        "not registering extended operating system metrics", cce);
            }
        }
    }

    private void threadingMetrics(MetricRegistry registry) {
        ThreadMXBean thread = ManagementFactory.getThreadMXBean();

        Metadata meta = Metadata.builder()
                .withName(THREAD_COUNT)
                .withType(MetricType.GAUGE)
                .withDisplayName("Thread Count")
                .withDescription("Displays the current number of live threads including both daemon and non-daemon threads")
                .build();
        registry.register(meta, new Gauge() {
            @Override
            public Number getValue() {
                return thread.getThreadCount();
            }
        });

        meta = Metadata.builder()
                .withName(THREAD_DAEMON_COUNT)
                .withType(MetricType.GAUGE)
                .withDisplayName("Daemon Thread Count")
                .withDescription("Displays the current number of live daemon threads.")
                .build();
        registry.register(meta, new Gauge() {
            @Override
            public Number getValue() {
                return thread.getDaemonThreadCount();
            }
        });

        meta = Metadata.builder()
                .withName(THREAD_MAX_COUNT)
                .withType(MetricType.GAUGE)
                .withDisplayName("Peak Thread Count")
                .withDescription("Displays the peak live thread count since the Java virtual machine started or peak was " +
                        "reset. This includes daemon and non-daemon threads.")
                .build();
        registry.register(meta, new Gauge() {
            @Override
            public Number getValue() {
                return thread.getPeakThreadCount();
            }
        });
    }

    private void runtimeMetrics(MetricRegistry registry) {
        RuntimeMXBean runtimeMXBean = ManagementFactory.getRuntimeMXBean();

        Metadata meta = Metadata.builder()
                .withName(JVM_UPTIME)
                .withType(MetricType.GAUGE)
                .withUnit(MetricUnits.MILLISECONDS)
                .withDisplayName("JVM Uptime")
                .withDescription("Displays the time from the start of the Java virtual machine in milliseconds.")
                .build();
        registry.register(meta, new Gauge() {
            @Override
            public Number getValue() {
                return runtimeMXBean.getUptime();
            }
        });
    }

    private void baseMemoryMetrics(MetricRegistry registry) {
        MemoryMXBean memoryMXBean = ManagementFactory.getMemoryMXBean();
        Metadata meta = Metadata.builder()
                .withName(MEMORY_COMMITTED_HEAP)
                .withType(MetricType.GAUGE)
                .withUnit(MetricUnits.BYTES)
                .withDisplayName("Committed Heap Memory")
                .withDescription(
                        "Displays the amount of memory in bytes that is committed for the Java virtual machine to use. " +
                                "This amount of memory is guaranteed for the Java virtual machine to use.")
                .build();
        registry.register(meta, new Gauge() {
            @Override
            public Number getValue() {
                return memoryMXBean.getHeapMemoryUsage().getCommitted();
            }
        });

        meta = Metadata.builder()
                .withName(MEMORY_MAX_HEAP)
                .withType(MetricType.GAUGE)
                .withUnit(MetricUnits.BYTES)
                .withDisplayName("Max Heap Memory")
                .withDescription("Displays the maximum amount of heap memory in bytes that can be used for memory management. "
                        +
                        "This attribute displays -1 if the maximum heap memory size is undefined. This amount of memory is not "
                        +
                        "guaranteed to be available for memory management if it is greater than the amount of committed memory. "
                        +
                        "The Java virtual machine may fail to allocate memory even if the amount of used memory does " +
                        "not exceed this maximum size.")
                .build();
        registry.register(meta, new Gauge() {
            @Override
            public Number getValue() {
                return memoryMXBean.getHeapMemoryUsage().getMax();
            }
        });

        meta = Metadata.builder()
                .withName(MEMORY_USED_HEAP)
                .withType(MetricType.GAUGE)
                .withUnit(MetricUnits.BYTES)
                .withDisplayName("Used Heap Memory")
                .withDescription("Displays the amount of used heap memory in bytes.")
                .build();
        registry.register(meta, new Gauge() {
            @Override
            public Number getValue() {
                return memoryMXBean.getHeapMemoryUsage().getUsed();
            }
        });
    }

    private void vendorSpecificMemoryMetrics(MetricRegistry registry) {
        MemoryMXBean memoryMXBean = ManagementFactory.getMemoryMXBean();

        Metadata meta = Metadata.builder()
                .withName(MEMORY_COMMITTED_NON_HEAP)
                .withType(MetricType.GAUGE)
                .withUnit(MetricUnits.BYTES)
                .withDisplayName("Committed Non Heap Memory")
                .withDescription(
                        "Displays the amount of non heap memory in bytes that is committed for the Java virtual machine to use.")
                .build();
        registry.register(meta, new Gauge() {
            @Override
            public Number getValue() {
                return memoryMXBean.getNonHeapMemoryUsage().getCommitted();
            }
        });

        meta = Metadata.builder()
                .withName(MEMORY_MAX_NON_HEAP)
                .withType(MetricType.GAUGE)
                .withUnit(MetricUnits.BYTES)
                .withDisplayName("Max Non Heap Memory")
                .withDescription("Displays the maximum amount of used non-heap memory in bytes.")
                .build();
        registry.register(meta, new Gauge() {
            @Override
            public Number getValue() {
                return memoryMXBean.getNonHeapMemoryUsage().getMax();
            }
        });

        meta = Metadata.builder()
                .withName(MEMORY_USED_NON_HEAP)
                .withType(MetricType.GAUGE)
                .withUnit(MetricUnits.BYTES)
                .withDisplayName("Used Non Heap Memory")
                .withDescription("Displays the amount of used non-heap memory in bytes.")
                .build();
        registry.register(meta, new Gauge() {
            @Override
            public Number getValue() {
                return memoryMXBean.getNonHeapMemoryUsage().getUsed();
            }
        });
    }

    private void memoryPoolMetrics(MetricRegistry registry) {
        // MemoryPoolMXBean doesn't work in native mode
        if (ImageMode.current() == ImageMode.JVM) {
            List mps = ManagementFactory.getMemoryPoolMXBeans();
            Metadata usageMetadata = Metadata.builder()
                    .withName("memoryPool.usage")
                    .withType(MetricType.GAUGE)
                    .withDisplayName("Current usage of the memory pool denoted by the 'name' tag")
                    .withDescription("Current usage of the memory pool denoted by the 'name' tag")
                    .withUnit(MetricUnits.BYTES)
                    .build();
            Metadata maxMetadata = Metadata.builder()
                    .withName("memoryPool.usage.max")
                    .withType(MetricType.GAUGE)
                    .withDisplayName("Peak usage of the memory pool denoted by the 'name' tag")
                    .withDescription("Peak usage of the memory pool denoted by the 'name' tag")
                    .withUnit(MetricUnits.BYTES)
                    .build();
            for (MemoryPoolMXBean mp : mps) {
                if (mp.getCollectionUsage() != null && mp.getPeakUsage() != null) {
                    // this will be the case for the heap memory pools
                    registry.register(usageMetadata, new Gauge() {
                        @Override
                        public Number getValue() {
                            return mp.getCollectionUsage().getUsed();
                        }
                    },
                            new Tag("name", mp.getName()));

                    registry.register(maxMetadata, new Gauge() {
                        @Override
                        public Number getValue() {
                            return mp.getPeakUsage().getUsed();
                        }
                    },
                            new Tag("name", mp.getName()));
                } else if (mp.getUsage() != null && mp.getPeakUsage() != null) {
                    // this will be the case for the non-heap memory pools
                    registry.register(usageMetadata, new Gauge() {
                        @Override
                        public Number getValue() {
                            return mp.getUsage().getUsed();
                        }
                    },
                            new Tag("name", mp.getName()));

                    registry.register(maxMetadata, new Gauge() {
                        @Override
                        public Number getValue() {
                            return mp.getPeakUsage().getUsed();
                        }
                    },
                            new Tag("name", mp.getName()));
                }
            }
        }
    }

    private void micrometerJvmGcMetrics(MetricRegistry registry, ShutdownContext shutdownContext) {
        if (ImageMode.current() == ImageMode.JVM) {
            MicrometerGCMetrics gcMetrics = new MicrometerGCMetrics();

            registry.register(new ExtendedMetadataBuilder()
                    .withName("jvm.gc.max.data.size")
                    .withType(MetricType.GAUGE)
                    .withUnit(MetricUnits.BYTES)
                    .withDescription("Max size of old generation memory pool")
                    .skipsScopeInOpenMetricsExportCompletely(true)
                    .build(), new Gauge() {
                        @Override
                        public Number getValue() {
                            return gcMetrics.getMaxDataSize();
                        }
                    });
            registry.register(new ExtendedMetadataBuilder()
                    .withName("jvm.gc.live.data.size")
                    .withType(MetricType.GAUGE)
                    .withUnit(MetricUnits.BYTES)
                    .withDescription("Size of old generation memory pool after a full GC")
                    .skipsScopeInOpenMetricsExportCompletely(true)
                    .build(), new Gauge() {
                        @Override
                        public Number getValue() {
                            return gcMetrics.getLiveDataSize();
                        }
                    });
            registry.register(new ExtendedMetadataBuilder()
                    .withName("jvm.gc.memory.promoted")
                    .withType(MetricType.COUNTER)
                    .withUnit(MetricUnits.BYTES)
                    .withDescription(
                            "Count of positive increases in the size of the old generation memory pool before GC to after GC")
                    .skipsScopeInOpenMetricsExportCompletely(true)
                    .withOpenMetricsKeyOverride("jvm_gc_memory_promoted_bytes_total")
                    .build(), new GetCountOnlyCounter() {
                        @Override
                        public long getCount() {
                            return gcMetrics.getPromotedBytes();
                        }
                    });
            registry.register(new ExtendedMetadataBuilder()
                    .withName("jvm.gc.memory.allocated")
                    .withType(MetricType.COUNTER)
                    .withUnit(MetricUnits.BYTES)
                    .withDescription(
                            "Incremented for an increase in the size of the young generation memory pool after one GC to before the next")
                    .skipsScopeInOpenMetricsExportCompletely(true)
                    .withOpenMetricsKeyOverride("jvm_gc_memory_allocated_bytes_total")
                    .build(), new GetCountOnlyCounter() {
                        @Override
                        public long getCount() {
                            return gcMetrics.getAllocatedBytes();
                        }
                    });

            // start updating the metric values in a listener for GC events
            // Metrics that mimic the jvm.gc.pause timer will be registered lazily as GC events occur
            gcMetrics.startWatchingNotifications();
            shutdownContext.addShutdownTask(gcMetrics::cleanUp);
        }
    }

    /**
     * Mimics Uptime metrics from Micrometer. Most of the logic here is basically copied from
     * {@link Micrometer
     * Uptime metrics}.
     *
     * @param registry
     */
    private void micrometerRuntimeMetrics(MetricRegistry registry) {
        RuntimeMXBean runtimeMXBean = ManagementFactory.getRuntimeMXBean();

        registry.register(
                new ExtendedMetadataBuilder()
                        .withName("process.runtime")
                        .withType(MetricType.GAUGE)
                        .withUnit(MetricUnits.MILLISECONDS)
                        .withDescription("The uptime of the Java virtual machine")
                        .skipsScopeInOpenMetricsExportCompletely(true)
                        .build(),
                new Gauge() {
                    @Override
                    public Number getValue() {
                        return runtimeMXBean.getUptime();
                    }
                });
        registry.register(
                new ExtendedMetadataBuilder()
                        .withName("process.start.time")
                        .withType(MetricType.GAUGE)
                        .withUnit(MetricUnits.MILLISECONDS)
                        .withDescription("Start time of the process since unix epoch.")
                        .skipsScopeInOpenMetricsExportCompletely(true)
                        .build(),
                new Gauge() {
                    @Override
                    public Number getValue() {
                        return runtimeMXBean.getStartTime();
                    }
                });
    }

    private void micrometerJvmThreadMetrics(MetricRegistry registry) {
        ThreadMXBean threadBean = ManagementFactory.getThreadMXBean();

        registry.register(
                new ExtendedMetadataBuilder()
                        .withName("jvm.threads.peak")
                        .withType(MetricType.GAUGE)
                        .withUnit("threads")
                        .withDescription("The peak live thread count since the Java virtual machine started or peak was reset")
                        .skipsScopeInOpenMetricsExportCompletely(true)
                        .build(),
                new Gauge() {
                    @Override
                    public Number getValue() {
                        return threadBean.getPeakThreadCount();
                    }
                });
        registry.register(
                new ExtendedMetadataBuilder()
                        .withName("jvm.threads.daemon")
                        .withType(MetricType.GAUGE)
                        .withUnit("threads")
                        .withDescription("The current number of live daemon threads")
                        .skipsScopeInOpenMetricsExportCompletely(true)
                        .build(),
                new Gauge() {
                    @Override
                    public Number getValue() {
                        return threadBean.getDaemonThreadCount();
                    }
                });
        registry.register(
                new ExtendedMetadataBuilder()
                        .withName("jvm.threads.live")
                        .withType(MetricType.GAUGE)
                        .withUnit("threads")
                        .withDescription("The current number of live threads including both daemon and non-daemon threads")
                        .skipsScopeInOpenMetricsExportCompletely(true)
                        .build(),
                new Gauge() {
                    @Override
                    public Number getValue() {
                        return threadBean.getThreadCount();
                    }
                });

        if (ImageMode.current() == ImageMode.JVM) {
            ExtendedMetadata threadStatesMetadata = new ExtendedMetadataBuilder()
                    .withName("jvm.threads.states")
                    .withType(MetricType.GAUGE)
                    .withUnit("threads")
                    .withDescription("The current number of threads having a particular state")
                    .skipsScopeInOpenMetricsExportCompletely(true)
                    .build();
            for (Thread.State state : Thread.State.values()) {
                registry.register(threadStatesMetadata,
                        new Gauge() {
                            @Override
                            public Number getValue() {
                                return getThreadStateCount(threadBean, state);
                            }
                        },
                        new Tag("state", state.name().toLowerCase().replace("_", "-")));
            }
        }
    }

    private void micrometerJvmMemoryMetrics(MetricRegistry registry) {
        if (ImageMode.current() == ImageMode.JVM) {
            for (MemoryPoolMXBean memoryPoolMXBean : ManagementFactory.getMemoryPoolMXBeans()) {
                String area = MemoryType.HEAP.equals(memoryPoolMXBean.getType()) ? "heap" : "nonheap";
                Tag[] tags = new Tag[] { new Tag("id", memoryPoolMXBean.getName()),
                        new Tag("area", area) };

                registry.register(
                        new ExtendedMetadataBuilder()
                                .withName("jvm.memory.used")
                                .withType(MetricType.GAUGE)
                                .withUnit("bytes")
                                .withDescription("The amount of used memory")
                                .skipsScopeInOpenMetricsExportCompletely(true)
                                .build(),
                        new Gauge() {
                            @Override
                            public Number getValue() {
                                return memoryPoolMXBean.getUsage().getUsed();
                            }
                        },
                        tags);

                registry.register(
                        new ExtendedMetadataBuilder()
                                .withName("jvm.memory.committed")
                                .withType(MetricType.GAUGE)
                                .withUnit("bytes")
                                .withDescription(
                                        "The amount of memory in bytes that is committed for the Java virtual machine to use")
                                .skipsScopeInOpenMetricsExportCompletely(true)
                                .build(),
                        new Gauge() {
                            @Override
                            public Number getValue() {
                                return memoryPoolMXBean.getUsage().getCommitted();
                            }
                        },
                        tags);

                registry.register(
                        new ExtendedMetadataBuilder()
                                .withName("jvm.memory.max")
                                .withType(MetricType.GAUGE)
                                .withUnit("bytes")
                                .withDescription("The maximum amount of memory in bytes that can be used for memory management")
                                .skipsScopeInOpenMetricsExportCompletely(true)
                                .build(),
                        new Gauge() {
                            @Override
                            public Number getValue() {
                                return memoryPoolMXBean.getUsage().getMax();
                            }
                        },
                        tags);
            }

            for (BufferPoolMXBean bufferPoolBean : ManagementFactory.getPlatformMXBeans(BufferPoolMXBean.class)) {
                Tag tag = new Tag("id", bufferPoolBean.getName());

                registry.register(
                        new ExtendedMetadataBuilder()
                                .withName("jvm.buffer.count")
                                .withType(MetricType.GAUGE)
                                .withUnit("buffers")
                                .withDescription("An estimate of the number of buffers in the pool")
                                .skipsScopeInOpenMetricsExportCompletely(true)
                                .build(),
                        new Gauge() {
                            @Override
                            public Number getValue() {
                                return bufferPoolBean.getCount();
                            }
                        },
                        tag);

                registry.register(
                        new ExtendedMetadataBuilder()
                                .withName("jvm.buffer.memory.used")
                                .withType(MetricType.GAUGE)
                                .withUnit("bytes")
                                .withDescription(
                                        "An estimate of the memory that the Java virtual machine is using for this buffer pool")
                                .skipsScopeInOpenMetricsExportCompletely(true)
                                .build(),
                        new Gauge() {
                            @Override
                            public Number getValue() {
                                return bufferPoolBean.getMemoryUsed();
                            }
                        },
                        tag);

                registry.register(
                        new ExtendedMetadataBuilder()
                                .withName("jvm.buffer.total.capacity")
                                .withType(MetricType.GAUGE)
                                .withUnit("bytes")
                                .withDescription("An estimate of the total capacity of the buffers in this pool")
                                .skipsScopeInOpenMetricsExportCompletely(true)
                                .build(),
                        new Gauge() {
                            @Override
                            public Number getValue() {
                                return bufferPoolBean.getTotalCapacity();
                            }
                        },
                        tag);
            }

        }
    }

    private void micrometerJvmClassLoaderMetrics(MetricRegistry registry) {
        // The ClassLoadingMXBean can be used in native mode, but it only returns zeroes, so there's no point in including such metrics.
        if (ImageMode.current() == ImageMode.JVM) {
            ClassLoadingMXBean classLoadingBean = ManagementFactory.getClassLoadingMXBean();

            registry.register(
                    new ExtendedMetadataBuilder()
                            .withName("jvm.classes.loaded")
                            .withType(MetricType.GAUGE)
                            .withUnit("classes")
                            .withDescription("The number of classes that are currently loaded in the Java virtual machine")
                            .withOpenMetricsKeyOverride("jvm_classes_loaded_classes")
                            .build(),
                    new Gauge() {
                        @Override
                        public Number getValue() {
                            return classLoadingBean.getLoadedClassCount();
                        }
                    });

            registry.register(
                    new ExtendedMetadataBuilder()
                            .withName("jvm.classes.unloaded")
                            .withType(MetricType.COUNTER)
                            .withUnit("classes")
                            .withDescription(
                                    "The total number of classes unloaded since the Java virtual machine has started execution")
                            .withOpenMetricsKeyOverride("jvm_classes_unloaded_classes_total")
                            .build(),
                    new GetCountOnlyCounter() {
                        @Override
                        public long getCount() {
                            return classLoadingBean.getUnloadedClassCount();
                        }
                    });
        }
    }

    private long getThreadStateCount(ThreadMXBean threadBean, Thread.State state) {
        int count = 0;
        for (ThreadInfo threadInfo : threadBean.getThreadInfo(threadBean.getAllThreadIds())) {
            if (threadInfo != null && threadInfo.getThreadState() == state) {
                count++;
            }
        }
        return count;
    }
}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy