Add GC duration histogram

prometheus-metrics-instrumentation-jvm/src/main/java/io/prometheus/metrics/instrumentation/jvm/JvmGarbageCollectorMetrics.java

@@ -1,6 +1,8 @@
 package io.prometheus.metrics.instrumentation.jvm;
 
+import com.sun.management.GarbageCollectionNotificationInfo;
 import io.prometheus.metrics.config.PrometheusProperties;
+import io.prometheus.metrics.core.metrics.Histogram;
 import io.prometheus.metrics.core.metrics.SummaryWithCallback;
 import io.prometheus.metrics.model.registry.PrometheusRegistry;
 import io.prometheus.metrics.model.snapshots.Quantiles;
@@ -9,6 +11,8 @@
 import java.lang.management.ManagementFactory;
 import java.util.List;
 import javax.annotation.Nullable;
+import javax.management.NotificationEmitter;
+import javax.management.openmbean.CompositeData;
 
 /**
  * JVM Garbage Collector metrics. The {@link JvmGarbageCollectorMetrics} are registered as part of
@@ -39,6 +43,7 @@
 public class JvmGarbageCollectorMetrics {
 
   private static final String JVM_GC_COLLECTION_SECONDS = "jvm_gc_collection_seconds";
+  private static final String JVM_GC_DURATION = "jvm_gc_duration";
 
   private final PrometheusProperties config;
   private final List<GarbageCollectorMXBean> garbageCollectorBeans;
@@ -67,6 +72,46 @@ private void register(PrometheusRegistry registry) {
               }
             })
         .register(registry);
+
+    registerGCDurationHistogram(registry);
+  }
+
+  private void registerGCDurationHistogram(PrometheusRegistry registry) {
+    double[] buckets = {0.01, 0.1, 1, 10};
+
+    Histogram gcDurationHistogram =
+        Histogram.builder(config)
+            .name(JVM_GC_DURATION)
+            .help("Duration of JVM garbage collection actions.")
+            .labelNames("jvm_gc_action", "jvm_gc_name", "jvm_gc_cause")
+            .classicUpperBounds(buckets)
+            .register(registry);
+
+    for (GarbageCollectorMXBean gcBean : garbageCollectorBeans) {
+
+      if (!(gcBean instanceof NotificationEmitter)) {
+        continue;
+      }
+
+      ((NotificationEmitter) gcBean)
+          .addNotificationListener(
+              (notification, handback) -> {
+                if (!GarbageCollectionNotificationInfo.GARBAGE_COLLECTION_NOTIFICATION.equals(
+                    notification.getType())) {
+                  return;
+                }
+
+                GarbageCollectionNotificationInfo info =
+                    GarbageCollectionNotificationInfo.from(
+                        (CompositeData) notification.getUserData());
+
+                gcDurationHistogram
+                    .labelValues(info.getGcAction(), info.getGcName(), info.getGcCause())
+                    .observe(Unit.millisToSeconds(info.getGcInfo().getDuration()));
+              },
+              null,
+              null);
+    }
   }
 
   public static Builder builder() {

prometheus-metrics-instrumentation-jvm/src/test/java/io/prometheus/metrics/instrumentation/jvm/JvmGarbageCollectorMetricsTest.java

@@ -58,7 +58,9 @@ public void testGoodCase() throws IOException {
   @Test
   public void testIgnoredMetricNotScraped() {
     MetricNameFilter filter =
-        MetricNameFilter.builder().nameMustNotBeEqualTo("jvm_gc_collection_seconds").build();
+        MetricNameFilter.builder()
+            .nameMustNotBeEqualTo("jvm_gc_collection_seconds", "jvm_gc_duration")
+            .build();
 
     PrometheusRegistry registry = new PrometheusRegistry();
     JvmGarbageCollectorMetrics.builder()