Allow dots in metric names and label names

Signed-off-by: Fabian Stäber <[email protected]>

Author: fstab

examples/example-exemplars-tail-sampling/example-greeting-service/src/main/java/io/prometheus/metrics/examples/otel_exemplars/greeting/GreetingServlet.java

@@ -27,7 +27,7 @@ public GreetingServlet() {
             .withUnit(Unit.SECONDS)
             .withLabelNames("http_status")
             .register();
-        histogram.withLabelValues("200");
+        histogram.initLabelValues("200");
     }
 
     @Override

examples/example-exemplars-tail-sampling/example-hello-world-app/src/main/java/io/prometheus/metrics/examples/otel_exemplars/app/HelloWorldServlet.java

@@ -34,7 +34,7 @@ public HelloWorldServlet() {
                 .withUnit(Unit.SECONDS)
                 .withLabelNames("http_status")
                 .register();
-        histogram.withLabelValues("200");
+        histogram.initLabelValues("200");
     }
 
     @Override

examples/example-tomcat-servlet/src/main/java/io/prometheus/metrics/examples/tomcat_servlet/HelloWorldServlet.java

@@ -32,6 +32,11 @@ public class HelloWorldServlet extends HttpServlet {
             .withLabelNames("http_status")
             .register();
 
+    public HelloWorldServlet() {
+        counter.initLabelValues("200");
+        histogram.initLabelValues("200");
+    }
+
     @Override
     protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws IOException {
         long start = System.nanoTime();

prometheus-metrics-config/src/main/java/io/prometheus/metrics/config/PrometheusProperties.java

@@ -58,7 +58,7 @@ public MetricsProperties getDefaultMetricProperties() {
      * May return {@code null} if no metric-specific properties are configured for a metric name.
      */
     public MetricsProperties getMetricProperties(String metricName) {
-        return metricProperties.get(metricName);
+        return metricProperties.get(metricName.replace(".", "_"));
     }
 
     public ExemplarsProperties getExemplarProperties() {

prometheus-metrics-config/src/main/java/io/prometheus/metrics/config/PrometheusPropertiesLoader.java

@@ -39,6 +39,8 @@ public static PrometheusProperties load() throws PrometheusPropertiesException {
     // This will remove entries from properties when they are processed.
     private static Map<String, MetricsProperties> loadMetricsConfigs(Map<Object, Object> properties) {
         Map<String, MetricsProperties> result = new HashMap<>();
+        // Note that the metric name in the properties file must be as exposed in the Prometheus exposition formats,
+        // i.e. all dots replaced with underscores.
         Pattern pattern = Pattern.compile("io\\.prometheus\\.metrics\\.([^.]+)\\.");
         // Create a copy of the keySet() for iterating. We cannot iterate directly over keySet()
         // because entries are removed when MetricsConfig.load(...) is called.
@@ -49,7 +51,7 @@ private static Map<String, MetricsProperties> loadMetricsConfigs(Map<Object, Obj
         for (String propertyName : propertyNames) {
             Matcher matcher = pattern.matcher(propertyName);
             if (matcher.find()) {
-                String metricName = matcher.group(1);
+                String metricName = matcher.group(1).replace(".", "_");
                 if (!result.containsKey(metricName)) {
                     result.put(metricName, MetricsProperties.load("io.prometheus.metrics." + metricName, properties));
                 }

prometheus-metrics-core/src/main/java/io/prometheus/metrics/core/metrics/Counter.java

@@ -9,13 +9,16 @@
 import io.prometheus.metrics.model.snapshots.CounterSnapshot;
 import io.prometheus.metrics.model.snapshots.Exemplar;
 import io.prometheus.metrics.model.snapshots.Labels;
+import io.prometheus.metrics.model.snapshots.PrometheusNaming;
 
 import java.util.ArrayList;
 import java.util.Collections;
 import java.util.List;
 import java.util.concurrent.atomic.DoubleAdder;
 import java.util.concurrent.atomic.LongAdder;
 
+import static io.prometheus.metrics.model.snapshots.PrometheusNaming.prometheusName;
+
 /**
  * Counter metric.
  * <p>
@@ -109,8 +112,8 @@ protected CounterSnapshot collect(List<Labels> labels, List<DataPoint> metricDat
         return new CounterSnapshot(getMetadata(), data);
     }
 
-    static String normalizeName(String name) {
-        if (name != null && name.endsWith("_total")) {
+    static String stripTotalSuffix(String name) {
+        if (name != null && (name.endsWith("_total") || name.endsWith(".total"))) {
             name = name.substring(0, name.length() - 6);
         }
         return name;
@@ -231,12 +234,12 @@ private Builder(PrometheusProperties properties) {
          * In the example above both {@code c1} and {@code c2} would be named {@code "events_total"} in Prometheus.
          * <p>
          * Throws an {@link IllegalArgumentException} if
-         * {@link io.prometheus.metrics.model.snapshots.MetricMetadata#isValidMetricName(String) MetricMetadata.isValidMetricName(name)}
+         * {@link io.prometheus.metrics.model.snapshots.PrometheusNaming#isValidMetricName(String) MetricMetadata.isValidMetricName(name)}
          * is {@code false}.
          */
         @Override
         public Builder withName(String name) {
-            return super.withName(normalizeName(name));
+            return super.withName(stripTotalSuffix(name));
         }
 
         @Override

prometheus-metrics-core/src/main/java/io/prometheus/metrics/core/metrics/CounterWithCallback.java

@@ -80,12 +80,12 @@ private Builder(PrometheusProperties properties) {
          * In the example above both {@code c1} and {@code c2} would be named {@code "events_total"} in Prometheus.
          * <p>
          * Throws an {@link IllegalArgumentException} if
-         * {@link io.prometheus.metrics.model.snapshots.MetricMetadata#isValidMetricName(String) MetricMetadata.isValidMetricName(name)}
+         * {@link io.prometheus.metrics.model.snapshots.PrometheusNaming#isValidMetricName(String) MetricMetadata.isValidMetricName(name)}
          * is {@code false}.
          */
         @Override
         public Builder withName(String name) {
-            return super.withName(Counter.normalizeName(name));
+            return super.withName(Counter.stripTotalSuffix(name));
         }
 
         @Override

prometheus-metrics-core/src/main/java/io/prometheus/metrics/core/metrics/Info.java

@@ -2,16 +2,16 @@
 
 import io.prometheus.metrics.config.PrometheusProperties;
 import io.prometheus.metrics.model.snapshots.InfoSnapshot;
-import io.prometheus.metrics.model.snapshots.Label;
 import io.prometheus.metrics.model.snapshots.Labels;
 import io.prometheus.metrics.model.snapshots.Unit;
 
 import java.util.ArrayList;
-import java.util.Arrays;
 import java.util.Collections;
 import java.util.List;
 import java.util.concurrent.CopyOnWriteArrayList;
 
+import static io.prometheus.metrics.model.snapshots.PrometheusNaming.prometheusName;
+
 /**
  * Info metric. Example:
  * <pre>{@code
@@ -90,15 +90,12 @@ private Builder(PrometheusProperties config) {
          * In the example above both {@code info1} and {@code info2} will be named {@code "runtime_info"} in Prometheus.
          * <p>
          * Throws an {@link IllegalArgumentException} if
-         * {@link io.prometheus.metrics.model.snapshots.MetricMetadata#isValidMetricName(String) MetricMetadata.isValidMetricName(name)}
+         * {@link io.prometheus.metrics.model.snapshots.PrometheusNaming#isValidMetricName(String) MetricMetadata.isValidMetricName(name)}
          * is {@code false}.
          */
         @Override
         public Builder withName(String name) {
-            if (name != null && name.endsWith("_info")) {
-                name = name.substring(0, name.length() - 5);
-            }
-            return super.withName(name);
+            return super.withName(stripInfoSuffix(name));
         }
 
         /**
@@ -112,16 +109,16 @@ public Builder withUnit(Unit unit) {
             return this;
         }
 
-        private static String normalizeName(String name) {
-            if (name != null && name.endsWith("_info")) {
+        private static String stripInfoSuffix(String name) {
+            if (name != null && (name.endsWith("_info") || name.endsWith(".info"))) {
                 name = name.substring(0, name.length() - 5);
             }
             return name;
         }
 
         @Override
         public Info build() {
-            return new Info(withName(normalizeName(name)));
+            return new Info(this);
         }
 
         @Override

prometheus-metrics-core/src/main/java/io/prometheus/metrics/core/metrics/MetricWithFixedMetadata.java

@@ -3,11 +3,14 @@
 import io.prometheus.metrics.config.PrometheusProperties;
 import io.prometheus.metrics.model.snapshots.Labels;
 import io.prometheus.metrics.model.snapshots.MetricMetadata;
+import io.prometheus.metrics.model.snapshots.PrometheusNaming;
 import io.prometheus.metrics.model.snapshots.Unit;
 
 import java.util.Arrays;
 import java.util.List;
 
+import static io.prometheus.metrics.model.snapshots.PrometheusNaming.prometheusName;
+
 /**
  * Almost all metrics have fixed metadata, i.e. the metric name is known when the metric is created.
  * <p>
@@ -31,9 +34,8 @@ protected MetricMetadata getMetadata() {
 
     private String makeName(String name, Unit unit) {
         if (unit != null) {
-            String suffix = "_" + unit;
-            if (!name.endsWith(suffix)) {
-                name = name + suffix;
+            if (!name.endsWith(unit.toString())) {
+                name = name + "_" + unit;
             }
         }
         return name;
@@ -51,7 +53,7 @@ protected Builder(List<String> illegalLabelNames, PrometheusProperties propertie
         }
 
         public B withName(String name) {
-            if (!MetricMetadata.isValidMetricName(name)) {
+            if (!PrometheusNaming.isValidMetricName(name)) {
                 throw new IllegalArgumentException("'" + name + "': Illegal metric name.");
             }
             this.name = name;
@@ -70,7 +72,7 @@ public B withHelp(String help) {
 
         public B withLabelNames(String... labelNames) {
             for (String labelName : labelNames) {
-                if (!Labels.isValidLabelName(labelName)) {
+                if (!PrometheusNaming.isValidLabelName(labelName)) {
                     throw new IllegalArgumentException(labelName + ": illegal label name");
                 }
                 if (illegalLabelNames.contains(labelName)) {

prometheus-metrics-core/src/main/java/io/prometheus/metrics/core/metrics/StateSet.java

@@ -3,6 +3,7 @@
 import io.prometheus.metrics.config.MetricsProperties;
 import io.prometheus.metrics.config.PrometheusProperties;
 import io.prometheus.metrics.model.snapshots.Labels;
+import io.prometheus.metrics.model.snapshots.MetricMetadata;
 import io.prometheus.metrics.model.snapshots.StateSetSnapshot;
 import io.prometheus.metrics.core.datapoints.StateSetDataPoint;
 
@@ -11,6 +12,8 @@
 import java.util.List;
 import java.util.stream.Stream;
 
+import static io.prometheus.metrics.model.snapshots.PrometheusNaming.prometheusName;
+
 /**
  * StateSet metric. Example:
  * <pre>{@code
@@ -58,7 +61,7 @@ private StateSet(Builder builder, PrometheusProperties prometheusProperties) {
         exemplarsEnabled = getConfigProperty(properties, MetricsProperties::getExemplarsEnabled);
         this.names = builder.names; // builder.names is already a validated copy
         for (String name : names) {
-            if (this.getMetadata().getName().equals(name)) {
+            if (this.getMetadata().getPrometheusName().equals(prometheusName(name))) {
                 throw new IllegalArgumentException("Label name " + name + " is illegal (can't use the metric name as label name in state set metrics)");
             }
         }