-
Notifications
You must be signed in to change notification settings - Fork 120
[ISSUE #494] support prometheus #495
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: master
Are you sure you want to change the base?
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,234 @@ | ||
| /* | ||
| * Licensed to the Apache Software Foundation (ASF) under one or more | ||
| * contributor license agreements. See the NOTICE file distributed with | ||
| * this work for additional information regarding copyright ownership. | ||
| * The ASF licenses this file to You under the Apache License, Version 2.0 | ||
| * (the "License"); you may not use this file except in compliance with | ||
| * the License. You may obtain a copy of the License at | ||
| * | ||
| * http://www.apache.org/licenses/LICENSE-2.0 | ||
| * | ||
| * Unless required by applicable law or agreed to in writing, software | ||
| * distributed under the License is distributed on an "AS IS" BASIS, | ||
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||
| * See the License for the specific language governing permissions and | ||
| * limitations under the License. | ||
| */ | ||
| package org.apache.rocketmq.connect.metrics; | ||
|
|
||
| import com.codahale.metrics.Counter; | ||
| import com.codahale.metrics.Gauge; | ||
| import com.codahale.metrics.Histogram; | ||
| import com.codahale.metrics.Meter; | ||
| import com.codahale.metrics.Metric; | ||
| import com.codahale.metrics.MetricFilter; | ||
| import com.codahale.metrics.MetricRegistry; | ||
| import com.codahale.metrics.Snapshot; | ||
| import com.codahale.metrics.Timer; | ||
| import io.prometheus.client.dropwizard.samplebuilder.DefaultSampleBuilder; | ||
| import io.prometheus.client.dropwizard.samplebuilder.SampleBuilder; | ||
| import java.util.ArrayList; | ||
| import java.util.Arrays; | ||
| import java.util.HashMap; | ||
| import java.util.HashSet; | ||
| import java.util.List; | ||
| import java.util.Map; | ||
| import java.util.Set; | ||
| import java.util.SortedMap; | ||
| import java.util.concurrent.TimeUnit; | ||
| import java.util.logging.Level; | ||
| import java.util.logging.Logger; | ||
| import org.apache.rocketmq.connect.metrics.stats.Stat; | ||
|
|
||
| /** | ||
| * Collect Dropwizard metrics from a MetricRegistry. | ||
| */ | ||
| public class DropwizardExports extends io.prometheus.client.Collector implements io.prometheus.client.Collector.Describable { | ||
| private static final Logger LOGGER = Logger.getLogger(DropwizardExports.class.getName()); | ||
| private MetricRegistry registry; | ||
| private MetricFilter metricFilter; | ||
| private SampleBuilder sampleBuilder; | ||
|
|
||
| /** | ||
| * Creates a new DropwizardExports with a {@link DefaultSampleBuilder} and {@link MetricFilter#ALL}. | ||
| * | ||
| * @param registry a metric registry to export in prometheus. | ||
| */ | ||
| public DropwizardExports(MetricRegistry registry) { | ||
| this.registry = registry; | ||
| this.metricFilter = MetricFilter.ALL; | ||
| this.sampleBuilder = new DefaultSampleBuilder(); | ||
| } | ||
|
|
||
| /** | ||
| * Creates a new DropwizardExports with a {@link DefaultSampleBuilder} and custom {@link MetricFilter}. | ||
| * | ||
| * @param registry a metric registry to export in prometheus. | ||
| * @param metricFilter a custom metric filter. | ||
| */ | ||
| public DropwizardExports(MetricRegistry registry, MetricFilter metricFilter) { | ||
| this.registry = registry; | ||
| this.metricFilter = metricFilter; | ||
| this.sampleBuilder = new DefaultSampleBuilder(); | ||
| } | ||
|
|
||
| /** | ||
| * @param registry a metric registry to export in prometheus. | ||
| * @param sampleBuilder sampleBuilder to use to create prometheus samples. | ||
| */ | ||
| public DropwizardExports(MetricRegistry registry, SampleBuilder sampleBuilder) { | ||
| this.registry = registry; | ||
| this.metricFilter = MetricFilter.ALL; | ||
| this.sampleBuilder = sampleBuilder; | ||
| } | ||
|
|
||
| /** | ||
| * @param registry a metric registry to export in prometheus. | ||
| * @param metricFilter a custom metric filter. | ||
| * @param sampleBuilder sampleBuilder to use to create prometheus samples. | ||
| */ | ||
| public DropwizardExports(MetricRegistry registry, MetricFilter metricFilter, SampleBuilder sampleBuilder) { | ||
| this.registry = registry; | ||
| this.metricFilter = metricFilter; | ||
| this.sampleBuilder = sampleBuilder; | ||
| } | ||
|
|
||
| private static String getHelpMessage(String metricName, Metric metric) { | ||
| return String.format("Generated from Dropwizard metric import (metric=%s, type=%s)", metricName, metric.getClass().getName()); | ||
| } | ||
|
|
||
| /** | ||
| * Export counter as Prometheus <a href="https://prometheus.io/docs/concepts/metric_types/#gauge">Gauge</a>. | ||
| */ | ||
| MetricFamilySamples fromCounter(String dropwizardName, Counter counter) { | ||
| MetricFamilySamples.Sample sample = sampleBuilder.createSample(dropwizardName, "", new ArrayList<String>(), new ArrayList<String>(), new Long(counter.getCount()).doubleValue()); | ||
| return new MetricFamilySamples(sample.name, Type.GAUGE, getHelpMessage(dropwizardName, counter), Arrays.asList(sample)); | ||
| } | ||
|
|
||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
|
||
| /** | ||
| * Export gauge as a prometheus gauge. | ||
| */ | ||
| MetricFamilySamples fromGauge(String dropwizardName, Gauge gauge) { | ||
| Object obj = gauge.getValue(); | ||
| double value; | ||
| if (obj instanceof Number) { | ||
| value = ((Number) obj).doubleValue(); | ||
| } else if (obj instanceof Boolean) { | ||
| value = ((Boolean) obj) ? 1 : 0; | ||
| } else { | ||
| LOGGER.log(Level.FINE, String.format("Invalid type for Gauge %s: %s", sanitizeMetricName(dropwizardName), obj == null ? "null" : obj.getClass().getName())); | ||
| return null; | ||
| } | ||
| MetricFamilySamples.Sample sample = sampleBuilder.createSample(dropwizardName, "", new ArrayList<String>(), new ArrayList<String>(), value); | ||
| return new MetricFamilySamples(sample.name, Type.GAUGE, getHelpMessage(dropwizardName, gauge), Arrays.asList(sample)); | ||
| } | ||
|
|
||
| /** | ||
| * Export a histogram snapshot as a prometheus SUMMARY. | ||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
|
||
| * | ||
| * @param dropwizardName metric name. | ||
| * @param snapshot the histogram snapshot. | ||
| * @param count the total sample count for this snapshot. | ||
| * @param factor a factor to apply to histogram values. | ||
| */ | ||
| MetricFamilySamples fromSnapshotAndCount(String dropwizardName, Snapshot snapshot, long count, double factor, | ||
| String helpMessage) { | ||
| MetricName metricName = MetricUtils.stringToMetricName(dropwizardName); | ||
| Stat.HistogramType histogramType = Stat.HistogramType.valueOf(metricName.getType()); | ||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Stat.HistogramType.valueOf(metricName.getType()) throws IllegalArgumentException if the metric name's type field does not match a known enum constant. Since this is called inside collect() which iterates over ALL metrics in the registry, a single metric with an unrecognized type will crash the entire metrics collection, making the /metrics endpoint return an error for all metrics. Consider wrapping this in a try-catch that skips the individual metric and logs a warning, similar to how fromGauge handles invalid types. |
||
| List<MetricFamilySamples.Sample> samples = new ArrayList<>(); | ||
| switch (histogramType) { | ||
| case Avg: | ||
| samples = Arrays.asList(sampleBuilder.createSample(dropwizardName, "", new ArrayList<String>(), new ArrayList<String>(), snapshot.getMean() * factor)); | ||
| break; | ||
| case Min: | ||
| samples = Arrays.asList(sampleBuilder.createSample(dropwizardName, "", new ArrayList<String>(), new ArrayList<String>(), snapshot.getMin() * factor)); | ||
| break; | ||
| case Max: | ||
| samples = Arrays.asList(sampleBuilder.createSample(dropwizardName, "", new ArrayList<String>(), new ArrayList<String>(), snapshot.getMax() * factor)); | ||
| break; | ||
| case Percentile_75th: | ||
| samples = Arrays.asList(sampleBuilder.createSample(dropwizardName, "", Arrays.asList("quantile"), Arrays.asList("0.75"), snapshot.get75thPercentile() * factor)); | ||
| break; | ||
| case Percentile_95th: | ||
| samples = Arrays.asList(sampleBuilder.createSample(dropwizardName, "", Arrays.asList("quantile"), Arrays.asList("0.95"), snapshot.get95thPercentile() * factor)); | ||
| break; | ||
| case Percentile_98th: | ||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. The |
||
| samples = Arrays.asList(sampleBuilder.createSample(dropwizardName, "", Arrays.asList("quantile"), Arrays.asList("0.98"), snapshot.get98thPercentile() * factor)); | ||
| break; | ||
| case Percentile_99th: | ||
| samples = Arrays.asList(sampleBuilder.createSample(dropwizardName, "", Arrays.asList("quantile"), Arrays.asList("0.99"), snapshot.get99thPercentile() * factor)); | ||
| break; | ||
| case Percentile_999th: | ||
| samples = Arrays.asList(sampleBuilder.createSample(dropwizardName, "", Arrays.asList("quantile"), Arrays.asList("0.999"), snapshot.get999thPercentile() * factor)); | ||
| break; | ||
| default: | ||
| samples = Arrays.asList(sampleBuilder.createSample(dropwizardName, "", Arrays.asList("quantile"), Arrays.asList("0.5"), snapshot.getMedian() * factor), sampleBuilder.createSample(dropwizardName, "", Arrays.asList("quantile"), Arrays.asList("0.5"), snapshot.getMedian() * factor), sampleBuilder.createSample(dropwizardName, "", Arrays.asList("quantile"), Arrays.asList("0.75"), snapshot.get75thPercentile() * factor), sampleBuilder.createSample(dropwizardName, "", Arrays.asList("quantile"), Arrays.asList("0.95"), snapshot.get95thPercentile() * factor), sampleBuilder.createSample(dropwizardName, "", Arrays.asList("quantile"), Arrays.asList("0.98"), snapshot.get98thPercentile() * factor), sampleBuilder.createSample(dropwizardName, "", Arrays.asList("quantile"), Arrays.asList("0.99"), snapshot.get99thPercentile() * factor), sampleBuilder.createSample(dropwizardName, "", Arrays.asList("quantile"), Arrays.asList("0.999"), snapshot.get999thPercentile() * factor), sampleBuilder.createSample(dropwizardName, "_count", new ArrayList<String>(), new ArrayList<String>(), count)); | ||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. The default case of the switch in fromSnapshotAndCount creates a duplicate sample: two samples both with quantile="0.5" and snapshot.getMedian(). The original Prometheus DropwizardExports only includes the median sample once. This duplicate should be removed — the second createSample call with Arrays.asList("0.5") and snapshot.getMedian() is redundant. |
||
|
|
||
| } | ||
| return new MetricFamilySamples(samples.get(0).name, Type.SUMMARY, helpMessage, samples); | ||
| } | ||
|
|
||
| /** | ||
| * Convert histogram snapshot. | ||
| */ | ||
| MetricFamilySamples fromHistogram(String dropwizardName, Histogram histogram) { | ||
| return fromSnapshotAndCount(dropwizardName, histogram.getSnapshot(), histogram.getCount(), 1.0, getHelpMessage(dropwizardName, histogram)); | ||
| } | ||
|
|
||
| /** | ||
| * Export Dropwizard Timer as a histogram. Use TIME_UNIT as time unit. | ||
| */ | ||
| MetricFamilySamples fromTimer(String dropwizardName, Timer timer) { | ||
| return fromSnapshotAndCount(dropwizardName, timer.getSnapshot(), timer.getCount(), 1.0D / TimeUnit.SECONDS.toNanos(1L), getHelpMessage(dropwizardName, timer)); | ||
| } | ||
|
|
||
| /** | ||
| * Export a Meter as as prometheus COUNTER. | ||
| */ | ||
| MetricFamilySamples fromMeter(String dropwizardName, Meter meter) { | ||
| MetricName metricName = MetricUtils.stringToMetricName(dropwizardName); | ||
| final MetricFamilySamples.Sample sample = sampleBuilder.createSample(dropwizardName, "", new ArrayList<String>(), new ArrayList<String>(), MetricUtils.getMeterValue(metricName, meter)); | ||
| return new MetricFamilySamples(sample.name, Type.COUNTER, getHelpMessage(dropwizardName, meter), Arrays.asList(sample)); | ||
| } | ||
|
|
||
| @Override | ||
| public List<MetricFamilySamples> collect() { | ||
| Map<String, MetricFamilySamples> mfSamplesMap = new HashMap<String, MetricFamilySamples>(); | ||
|
|
||
| for (SortedMap.Entry<String, Gauge> entry : registry.getGauges(metricFilter).entrySet()) { | ||
| addToMap(mfSamplesMap, fromGauge(entry.getKey(), entry.getValue())); | ||
| } | ||
| for (SortedMap.Entry<String, Counter> entry : registry.getCounters(metricFilter).entrySet()) { | ||
| addToMap(mfSamplesMap, fromCounter(entry.getKey(), entry.getValue())); | ||
| } | ||
| for (SortedMap.Entry<String, Histogram> entry : registry.getHistograms(metricFilter).entrySet()) { | ||
| addToMap(mfSamplesMap, fromHistogram(entry.getKey(), entry.getValue())); | ||
| } | ||
| for (SortedMap.Entry<String, Timer> entry : registry.getTimers(metricFilter).entrySet()) { | ||
| addToMap(mfSamplesMap, fromTimer(entry.getKey(), entry.getValue())); | ||
| } | ||
| for (SortedMap.Entry<String, Meter> entry : registry.getMeters(metricFilter).entrySet()) { | ||
| addToMap(mfSamplesMap, fromMeter(entry.getKey(), entry.getValue())); | ||
| } | ||
| return new ArrayList<MetricFamilySamples>(mfSamplesMap.values()); | ||
| } | ||
|
|
||
| private void addToMap(Map<String, MetricFamilySamples> mfSamplesMap, MetricFamilySamples newMfSamples) { | ||
| if (newMfSamples != null) { | ||
| MetricFamilySamples currentMfSamples = mfSamplesMap.get(newMfSamples.name); | ||
| if (currentMfSamples == null) { | ||
| mfSamplesMap.put(newMfSamples.name, newMfSamples); | ||
| } else { | ||
| Set<MetricFamilySamples.Sample> samples = new HashSet<MetricFamilySamples.Sample>(currentMfSamples.samples); | ||
| samples.addAll(newMfSamples.samples); | ||
| List<MetricFamilySamples.Sample> list = new ArrayList<>(samples); | ||
| mfSamplesMap.put(newMfSamples.name, new MetricFamilySamples(newMfSamples.name, currentMfSamples.type, currentMfSamples.help, list)); | ||
| } | ||
| } | ||
| } | ||
|
|
||
| @Override | ||
| public List<MetricFamilySamples> describe() { | ||
| return new ArrayList<MetricFamilySamples>(); | ||
| } | ||
| } | ||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Missing newline at end of file. Minor, but some tools and checkers flag this. |
||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,59 @@ | ||
| /* | ||
| * Licensed to the Apache Software Foundation (ASF) under one or more | ||
| * contributor license agreements. See the NOTICE file distributed with | ||
| * this work for additional information regarding copyright ownership. | ||
| * The ASF licenses this file to You under the Apache License, Version 2.0 | ||
| * (the "License"); you may not use this file except in compliance with | ||
| * the License. You may obtain a copy of the License at | ||
| * | ||
| * http://www.apache.org/licenses/LICENSE-2.0 | ||
| * | ||
| * Unless required by applicable law or agreed to in writing, software | ||
| * distributed under the License is distributed on an "AS IS" BASIS, | ||
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||
| * See the License for the specific language governing permissions and | ||
| * limitations under the License. | ||
| */ | ||
| package org.apache.rocketmq.connect.metrics; | ||
|
|
||
| import io.prometheus.client.Collector; | ||
| import io.prometheus.client.dropwizard.samplebuilder.SampleBuilder; | ||
| import java.util.Arrays; | ||
| import java.util.List; | ||
| import org.apache.commons.lang3.StringUtils; | ||
|
|
||
| public class PrometheusSampleBuilder implements SampleBuilder { | ||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. No test coverage is added for any of the new classes (DropwizardExports, PrometheusSampleBuilder, PrometheusMetricsServlet). Given the complex string-parsing logic in PrometheusSampleBuilder and the metric-type dispatch in DropwizardExports, unit tests are especially important to verify correct behavior with well-formed and malformed metric names, and to prevent regressions in the quantile label and suffix handling. |
||
| private static final List<String> SOURCE_TASK_LABEL_NAMES = Arrays.asList("metric_group", "data_type", "connector", "task"); | ||
|
|
||
| @Override | ||
| public Collector.MetricFamilySamples.Sample createSample(String dropwizardName, String nameSuffix, | ||
| List<String> additionalLabelNames, List<String> additionalLabelValues, double value) { | ||
| String suffix = nameSuffix == null ? "" : nameSuffix; | ||
| List<String> labelValues = sanitizeLabelValues(dropwizardName); | ||
| return new Collector.MetricFamilySamples.Sample(sanitizeMetricName(dropwizardName + suffix), SOURCE_TASK_LABEL_NAMES, labelValues, value); | ||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. The createSample method completely ignores the additionalLabelNames and additionalLabelValues parameters. These carry the 'quantile' label (e.g., name="quantile", value="0.75") that differentiates histogram percentiles in Prometheus SUMMARY metrics. By always using SOURCE_TASK_LABEL_NAMES and discarding the additional labels, all percentile samples for a histogram end up with an identical metric name and label set, making them indistinguishable and causing Prometheus to reject or arbitrarily deduplicate them. The method should merge additionalLabelNames/additionalLabelValues into the output sample's label names and values. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. sanitizeMetricName(dropwizardName + suffix) appends the suffix to the full dropwizardName string before parsing, but sanitizeMetricName extracts only the 2nd comma-separated field (split(":")[1].split(",")[1]). The suffix (e.g., "_count") lands on the last field and is silently lost. This means the histogram count sample (which uses nameSuffix="_count") gets the same metric name as the percentile samples, producing conflicting samples with the same name and label set. The suffix should be appended to the extracted metric name, not to the raw input string. |
||
| } | ||
|
|
||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
|
||
| public String sanitizeMetricName(String dropwizardName) { | ||
| return dropwizardName.split(":")[1].split(",")[1].replaceAll("-", "_"); | ||
| } | ||
|
|
||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
|
||
| public List<String> sanitizeLabelValues(String dropwizardName) { | ||
| String[] var = dropwizardName.split(":"); | ||
| String[] split = var[1].split(","); | ||
|
|
||
| String metricGroup = split[0]; | ||
| String metricName = split[1].replaceAll("-", "_"); | ||
| String dateType = split[2]; | ||
| String var3 = split[3]; | ||
| String connectorName = StringUtils.EMPTY; | ||
| if (!StringUtils.equals(var3, "")) { | ||
| connectorName = var3.substring(var3.indexOf("=") + 1); | ||
| } | ||
| String var4 = split[4]; | ||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. sanitizeLabelValues performs unchecked array indexing on split(":") and split(",") results, accessing indices 0 through 4 (split[4]) without any bounds validation. If any metric in the registry has a name that does not match the expected 'prefix:group,name,type,connector=X,task=Y' format (e.g., metrics registered by the framework itself or third-party libraries), this will throw ArrayIndexOutOfBoundsException, crashing the entire /metrics endpoint. sanitizeMetricName (line 37) has the same issue. Consider validating the split array length or wrapping in a try-catch that skips malformed metric names. |
||
| String taskid = StringUtils.EMPTY; | ||
| if (!StringUtils.equals(var4, "")) { | ||
| taskid = var4.substring(var4.indexOf("=") + 1); | ||
| } | ||
| return Arrays.asList(metricGroup, dateType, connectorName, taskid); | ||
| } | ||
| } | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -58,6 +58,8 @@ public class WorkerConfig { | |
| */ | ||
| private int httpPort = 8082; | ||
|
|
||
| private int exporterPort = 5557; | ||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. The |
||
|
|
||
| /** | ||
| * plugin paths config; | ||
| * Multiple use ',' split | ||
|
|
@@ -591,6 +593,14 @@ public void setStateManagementService(String stateManagementService) { | |
| this.stateManagementService = stateManagementService; | ||
| } | ||
|
|
||
| public int getExporterPort() { | ||
| return exporterPort; | ||
| } | ||
|
|
||
| public void setExporterPort(int exporterPort) { | ||
| this.exporterPort = exporterPort; | ||
| } | ||
|
|
||
| @Override | ||
| public String toString() { | ||
| return "WorkerConfig{" + | ||
|
|
@@ -638,6 +648,7 @@ public String toString() { | |
| ", configManagementService='" + configManagementService + '\'' + | ||
| ", positionManagementService='" + positionManagementService + '\'' + | ||
| ", stateManagementService='" + stateManagementService + '\'' + | ||
| ", exporterPort=" + exporterPort + | ||
| '}'; | ||
| } | ||
| } | ||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
No test changes detected alongside source modifications. Consider adding tests to cover the changes.