SOLR-17587: Prometheus Writer duplicate TYPE information in exposition format #2902

mlbiscoc · 2024-12-10T16:55:32Z

https://issues.apache.org/jira/browse/SOLR-17587

Description

Solr's Prometheus writer duplicates # TYPE <metric name> <prometheus metric type> in it's exposition format for coreregistry metrics.

This is an illegal format and depending on the technologies prometheus exposition verification for example Telegraf, this will fail. For Prometheus server itself, this still passes and collects the metrics just fine for some reason.

This is because the Prometheus Writer takes Dropwizard registries and exports them to Prometheus Registries to expose them in Prometheus format. Solr creates Dropwizard registry for every core and differentiates the metrics that way even though they have the same metric names.

For prometheus, this creates an issue in that metrics should be differentiated in it's attributes and tags. So when the metrics are output with the Prometheus response writer, it duplicates the TYPE information because it is a registry for every core and doesn't know that the other core registries have the same metric name and results in duplicate TYPE information.

Solution

When metrics are going to be exported for prometheus, we merge all the core Dropwizard metric registries into a single registry and export that registry into prometheus. Duplicate metric names in a registry is not allowed in prometheus, so we will also append the core name to the Dropwizard metric to differentiate which metric belongs to what core and parse the labels accordingly.

This also allowed to clean up and simply some of the SolrPrometheusCoreFormatter code.

Tests

Updated the test accordingly with the coreName existing in the Dropwizard metric names and it's parsing.

Also added an assert in testPrometheusStructureOutput to confirm there is no duplicate TYPE information in prometheus output.

Checklist

Please review the following and check all that apply:

I have reviewed the guidelines for How to Contribute and my code conforms to the standards described there to the best of my ability.
I have created a Jira issue and added the issue ID to my pull request title.
I have given Solr maintainers access to contribute to my PR branch. (optional but recommended, not available for branches on forks living under an organisation)
I have developed this patch against the main branch.
I have run ./gradlew check.
I have added tests for my changes.
I have added documentation for the Reference Guide

mlbiscoc · 2024-12-18T21:39:07Z

Going to bump this PR. It's not a blocker for standard Prometheus server metrics collection but it can potentially block users using other exporters/collectors.

dsmiley

Correct me if I'm wrong, but had you kept the test that you had removed because hossman didn't like it (it was imperfect), a reviewer (like me but you too) would be able to see in this PR a diff against the output format to understand the impact (or lack of impact).

dsmiley · 2024-12-19T21:00:00Z

I could say the same thing for dependencies. People add/remove dependencies in build files (Maven/Gradle/Ivy) but ultimately what we want to know is, what JARs changed in the ultimate distribution.

mlbiscoc · 2024-12-19T21:19:59Z

Correct me if I'm wrong, but had you kept the test that you had removed because hossman didn't like it (it was imperfect), a reviewer (like me but you too) would be able to see in this PR a diff against the output format to understand the impact (or lack of impact).

In theory, yes you would see the difference that is happening here. But since you can't see the output, here is a basically the change to the output:

Before:

curl 'localhost:8983/solr/admin/metrics?wt=prometheus' | grep "#" | sort
# TYPE solr_metrics_core_average_request_time gauge
# TYPE solr_metrics_core_average_request_time gauge
# TYPE solr_metrics_core_average_searcher_warmup_time gauge
# TYPE solr_metrics_core_average_searcher_warmup_time gauge
# TYPE solr_metrics_core_cache gauge
# TYPE solr_metrics_core_cache gauge
# TYPE solr_metrics_core_highlighter_requests_total counter
# TYPE solr_metrics_core_highlighter_requests_total counter
# TYPE solr_metrics_core_index_size_bytes gauge
# TYPE solr_metrics_core_index_size_bytes gauge
# TYPE solr_metrics_core_requests_time_total counter
# TYPE solr_metrics_core_requests_time_total counter
# TYPE solr_metrics_core_requests_total counter
# TYPE solr_metrics_core_requests_total counter
# TYPE solr_metrics_core_searcher_documents gauge
# TYPE solr_metrics_core_searcher_documents gauge
# TYPE solr_metrics_core_tlog_total counter
# TYPE solr_metrics_core_tlog_total counter
# TYPE solr_metrics_core_update_handler gauge
# TYPE solr_metrics_core_update_handler gauge
# TYPE solr_metrics_jetty_dispatches_total counter
# TYPE solr_metrics_jetty_requests_total counter
# TYPE solr_metrics_jetty_response_total counter
# TYPE solr_metrics_jvm_buffers gauge
# TYPE solr_metrics_jvm_buffers_bytes gauge
# TYPE solr_metrics_jvm_gc gauge
# TYPE solr_metrics_jvm_gc_seconds gauge
# TYPE solr_metrics_jvm_heap gauge
# TYPE solr_metrics_jvm_memory_pools_bytes gauge
# TYPE solr_metrics_jvm_threads gauge
# TYPE solr_metrics_node_connections gauge
# TYPE solr_metrics_node_core_root_fs_bytes gauge
# TYPE solr_metrics_node_cores gauge
# TYPE solr_metrics_node_requests_time_total counter
# TYPE solr_metrics_node_requests_total counter
# TYPE solr_metrics_node_thread_pool_total counter
# TYPE solr_metrics_os gauge

After:

curl 'localhost:8983/solr/admin/metrics?wt=prometheus' | grep "#" | sort
# TYPE solr_metrics_core_average_request_time gauge
# TYPE solr_metrics_core_average_searcher_warmup_time gauge
# TYPE solr_metrics_core_cache gauge
# TYPE solr_metrics_core_highlighter_requests_total counter
# TYPE solr_metrics_core_index_size_bytes gauge
# TYPE solr_metrics_core_requests_time_total counter
# TYPE solr_metrics_core_requests_total counter
# TYPE solr_metrics_core_searcher_documents gauge
# TYPE solr_metrics_core_tlog_total counter
# TYPE solr_metrics_core_update_handler gauge
# TYPE solr_metrics_jetty_dispatches_total counter
# TYPE solr_metrics_jetty_requests_total counter
# TYPE solr_metrics_jetty_response_total counter
# TYPE solr_metrics_jvm_buffers gauge
# TYPE solr_metrics_jvm_buffers_bytes gauge
# TYPE solr_metrics_jvm_gc gauge
# TYPE solr_metrics_jvm_gc_seconds gauge
# TYPE solr_metrics_jvm_heap gauge
# TYPE solr_metrics_jvm_memory_pools_bytes gauge
# TYPE solr_metrics_jvm_threads gauge
# TYPE solr_metrics_node_connections gauge
# TYPE solr_metrics_node_core_root_fs_bytes gauge
# TYPE solr_metrics_node_cores gauge
# TYPE solr_metrics_node_requests_time_total counter
# TYPE solr_metrics_node_requests_total counter
# TYPE solr_metrics_node_thread_pool_total counter
# TYPE solr_metrics_os gauge

# is just a comment in Prometheus but # TYPE is special. Some technologies with verify there are dupes while others don't. This just removes the duplicates and merged the metrics under a single # TYPE

solr/core/src/java/org/apache/solr/handler/admin/MetricsHandler.java

solr/core/src/java/org/apache/solr/metrics/prometheus/core/SolrCoreCacheMetric.java

solr/core/src/java/org/apache/solr/metrics/prometheus/core/SolrCoreMetric.java

dsmiley

Getting much better now

dsmiley · 2024-12-20T19:57:37Z

solr/core/src/java/org/apache/solr/handler/admin/MetricsHandler.java

@@ -552,6 +549,11 @@ private List<MetricType> parseMetricTypes(SolrParams params) {
    return metricTypes;
  }

+  private String getCoreNameFromRegistry(String registryName) {
+    String coreName = registryName.substring(registryName.indexOf('.') + 1);
+    return coreName.replaceAll("\\.", "_");


for single char find & replace, just use replace. You'll see by code inspection it's much faster.

solr/core/src/java/org/apache/solr/metrics/prometheus/core/SolrCoreMetric.java

mlbiscoc · 2024-12-22T00:55:01Z

solr/core/src/java/org/apache/solr/response/PrometheusResponseWriter.java

+            throw new SolrException(
+                SolrException.ErrorCode.SERVER_ERROR,
+                "Error occurred exporting Dropwizard Metric to Prometheus",
+                e);


Also wanted to mention this. I was thinking to just remove the log.warn and actually throw a SolrException. I think at the time I thought that not failing metrics entirely and even just partially getting metrics was ok. But after some thought, adding this would actually fail any metrics from posting but helps exporting tests actually get caught if there is something wrong or even a user finding a bug. WDYT?

dsmiley

+1 looks great to me. I forgot about this PR; sorry. Can you suggest CHANGES.txt wording (a comment here is fine).

mlbiscoc · 2025-01-08T00:38:09Z

+1 looks great to me. I forgot about this PR; sorry. Can you suggest CHANGES.txt wording (a comment here is fine).

No problem, thanks for reviewing. How about under bug fix "Metrics: Prometheus response writer fix for non-compliant exposition format containing duplicate TYPE lines"

# Conflicts: # solr/CHANGES.txt

dsmiley · 2025-01-09T05:12:38Z

Apparently, named groups of Matcher was added in JDK 20. Can you please do a branch_9x backport PR cherry picking this change and make modifications for JDK 11? I'm thinking, declare a static Map of the named groups for each regexp.

dsmiley · 2025-01-09T14:28:06Z

If you haven't started; I will. It's just slightly more work in my IDE as I'm set up for the change.

mlbiscoc · 2025-01-09T14:33:00Z

If you haven't started; I will. It's just slightly more work in my IDE as I'm set up for the change.

No worries, I got it. I'll push a PR to 9x soon.

mlbiscoc · 2025-01-09T14:52:06Z

PR for 9x backport

Metrics: Prometheus response writer fix for non-compliant exposition format containing duplicate TYPE lines 9x backport of main: * SOLR-17587: wt=prometheus fix duplicate TYPE information (#2902)

mlbiscoc added 7 commits December 9, 2024 15:42

Merge core dropwizard registries for prometheus

f27803e

Create STANDALONE_CORE_PATTERN

5e07534

STANDALONE_CORE_PATTERN fix with try/catch

8abef07

Only push to prometheus is merged cores registry isn't empty

286911b

Fix and add new test

cf3b2e0

Add additional comment info

b553839

testStandaloneCorePattern()

ed482ab

github-actions bot added tests cat:search cat:metrics labels Dec 10, 2024

dsmiley reviewed Dec 19, 2024

View reviewed changes

Address comments

3ae9106

dsmiley reviewed Dec 20, 2024

View reviewed changes

Address more comments

b700157

mlbiscoc commented Dec 22, 2024

View reviewed changes

dsmiley approved these changes Jan 7, 2025

View reviewed changes

dsmiley added 3 commits January 7, 2025 21:01

Merge branch 'main' into fork/mlbiscoc/SOLR-17587-dupe-type-prom

fc86708

CHANGES.txt

b288537

Merge branch 'main' into fork/mlbiscoc/SOLR-17587-dupe-type-prom

3596c90

# Conflicts: # solr/CHANGES.txt

dsmiley merged commit 796b788 into apache:main Jan 9, 2025
1 check passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

SOLR-17587: Prometheus Writer duplicate TYPE information in exposition format #2902

SOLR-17587: Prometheus Writer duplicate TYPE information in exposition format #2902

mlbiscoc commented Dec 10, 2024

mlbiscoc commented Dec 18, 2024

dsmiley left a comment

dsmiley commented Dec 19, 2024

mlbiscoc commented Dec 19, 2024

dsmiley left a comment

dsmiley Dec 20, 2024

mlbiscoc Dec 22, 2024

dsmiley left a comment

mlbiscoc commented Jan 8, 2025

dsmiley commented Jan 9, 2025

dsmiley commented Jan 9, 2025

mlbiscoc commented Jan 9, 2025

mlbiscoc commented Jan 9, 2025

SOLR-17587: Prometheus Writer duplicate TYPE information in exposition format #2902

SOLR-17587: Prometheus Writer duplicate TYPE information in exposition format #2902

Conversation

mlbiscoc commented Dec 10, 2024

Description

Solution

Tests

Checklist

mlbiscoc commented Dec 18, 2024

dsmiley left a comment

Choose a reason for hiding this comment

dsmiley commented Dec 19, 2024

mlbiscoc commented Dec 19, 2024

dsmiley left a comment

Choose a reason for hiding this comment

dsmiley Dec 20, 2024

Choose a reason for hiding this comment

mlbiscoc Dec 22, 2024

Choose a reason for hiding this comment

dsmiley left a comment

Choose a reason for hiding this comment

mlbiscoc commented Jan 8, 2025

dsmiley commented Jan 9, 2025

dsmiley commented Jan 9, 2025

mlbiscoc commented Jan 9, 2025

mlbiscoc commented Jan 9, 2025