Update HighCardinalityTagsDetector docs

Utilize the recently added concepts like
Builder and HighCardinalityMeterInfo.

Closes micrometer-metricsgh-6822

Author: jonatan-ivanov

docs/modules/ROOT/pages/concepts/high-cardinality-tags-detector.adoc

@@ -54,13 +54,13 @@ You can provide your own `Function<MeterRegistry, HighCardinalityTagsDetector>`
 include::{include-java}/metrics/HighCardinalityTagsDetectorTests.java[tags=registry_integration_factory,indent=0]
 ----
 
-=== Config params
+=== Configure with a Builder
 
-Constructors of `HighCardinalityTagsDetector` can be used to set parameters:
+`HighCardinalityTagsDetector.Builder` can be used to conveniently set parameters:
 
 [source,java,subs=+attributes]
 ----
-include::{include-java}/metrics/HighCardinalityTagsDetectorTests.java[tags=registry_integration_full_config,indent=0]
+include::{include-java}/metrics/HighCardinalityTagsDetectorTests.java[tags=registry_integration_builder,indent=0]
 ----
 
 === One-Time Check
@@ -83,7 +83,7 @@ For continuous monitoring in production, you don't need to create a scheduled jo
 
 === Custom Consumer
 
-Instead of the default logging behavior, you can provide a `Consumer<String>` to handle high cardinality notifications:
+Instead of the default logging behavior, you can provide a `Consumer<HighCardinalityMeterInfo>` to handle high cardinality notifications:
 
 [source,java,subs=+attributes]
 ----

docs/src/test/java/io/micrometer/docs/metrics/HighCardinalityTagsDetectorTests.java

@@ -57,29 +57,34 @@ void registryIntegration() {
         // end::registry_integration_factory[]
 
         // @formatter:off
-        // tag::registry_integration_full_config[]
+        // tag::registry_integration_builder[]
         registry.config().withHighCardinalityTagsDetector(r ->
-            new HighCardinalityTagsDetector(
-                r,
-                1000, // 1000 different meters with the same name
-                Duration.ofMinutes(5), // check ~every 5 minutes
-                name -> alert("High cardinality meter: " + name)
-            )
+            new HighCardinalityTagsDetector.Builder(r)
+                .threshold(1000) // 1000 different meters with the same name
+                .delay(Duration.ofMinutes(5)) // check ~every 5 minutes
+                .highCardinalityMeterInfoConsumer(info -> alert("Nooo!"))
+                .build()
         );
-        // end::registry_integration_full_config[]
+        // end::registry_integration_builder[]
         // @formatter:on
     }
 
     @Test
     void oneTimeCheck() {
         // tag::one_time_check[]
-        try (HighCardinalityTagsDetector detector = new HighCardinalityTagsDetector(registry, 10,
-                Duration.ofMinutes(1))) {
+        try (HighCardinalityTagsDetector detector = new HighCardinalityTagsDetector.Builder(registry).threshold(10)
+            .build()) {
             // Create meters with a high cardinality tag (uid)
             for (int i = 0; i < 15; i++) {
                 registry.counter("requests", "uid", String.valueOf(i)).increment();
             }
+
             assertThat(detector.findFirst()).isNotEmpty().get().isEqualTo("requests");
+            assertThat(detector.findFirstHighCardinalityMeterInfo()).isNotEmpty().get().satisfies(info -> {
+                assertThat(info.getName()).isEqualTo("requests");
+                assertThat(info.getCount()).isEqualTo(15);
+            });
+
         }
         // detector.close() is implicit here but don't forget to close it otherwise!
         // end::one_time_check[]
@@ -94,7 +99,9 @@ void customConsumer() {
         // @formatter:off
         // tag::custom_consumer_config[]
         registry.config().withHighCardinalityTagsDetector(r ->
-            new HighCardinalityTagsDetector(r, 10, Duration.ofMinutes(1), this::recordHighCardinalityEvent)
+            new HighCardinalityTagsDetector.Builder(r).threshold(10)
+                .highCardinalityMeterInfoConsumer(this::recordHighCardinalityEvent)
+                .build()
         );
         // end::custom_consumer_config[]
         // @formatter:on
@@ -104,9 +111,9 @@ void customConsumer() {
     }
 
     // tag::custom_consumer[]
-    void recordHighCardinalityEvent(String name) {
-        alert("High cardinality meter: " + name);
-        registry.counter("highCardinality.detections").increment();
+    void recordHighCardinalityEvent(HighCardinalityTagsDetector.HighCardinalityMeterInfo info) {
+        alert("High cardinality detected in " + info.getName() + " with " + info.getCount() + " meters!");
+        registry.counter("highCardinality.detections", "meter", info.getName()).increment();
     }
     // end::custom_consumer[]