如何注册千分尺定时器与SLA和标签？

Question

我正试图将普罗米修斯的度量标准迁移到千分尺，但现在我只能做一件事。。。

目前，我有一个普罗米修斯直方图配置如下：

private static final Histogram REQUEST_DURATION = Histogram
        .build("http_request_duration_milliseconds", "Duration in milliseconds for processing a request.")
        .labelNames("http_method", "http_status", "java_class", "java_method")
        .buckets(10, 25, 50, 100, 500, 1000)
        .register();

因此，为了切换到测微计，我将其替换为：

Timer.builder("http.request.duration")
            .description("Duration in seconds for processing a request.")
            .sla(Duration.ofMillis(10), Duration.ofMillis(25), Duration.ofMillis(50), Duration.ofMillis(100), Duration.ofMillis(500), Duration.ofMillis(1000), Duration.ofMillis(5000))
            .register(registry);

好啊让我们看看我想如何使用它。。。此刻我只是打电话

REQUEST_DURATION.labels(httpMethod, httpStatus, javaClass, javaMethod).observe(milliseconds);

所以我把这个换成了

Metrics.timer("http.request.duration",
            "http.method", httpMethod,
            "http.status", httpStatus,
            "java.class", javaClass,
            "java.method", javaMethod)
            .record(Duration.ofNanos(nanoseconds));

但现在的问题是，测微计抱怨我之前配置的度量没有这些标签。我当然知道，因为我不知道当时的值。以下是例外情况：

java.lang.IllegalArgumentExcema： Prometheus要求所有具有相同名称的仪表具有相同的标记密钥集。已经有一个包含标记键[]的现有仪表。您试图注册的计费器有键[http.method，http.status，java.class，java.method]。

好啊所以我想，然后让我们用指标指定bucket。定时器呼叫。但这不起作用，因为没有传递这些值的方法。

所以...如何为我的指标设置sla桶和标记？

Answer 1

匿名用户

首先，最好在名称部分之间使用点分隔符。这使得度量供应商保持中立，所以如果您决定向普罗米修斯以外的公司发货，它会起作用！换句话说，最好将其记录为http.request.duration。当应用Prometheus命名约定时，它将显示为http_request_duration_seconds。

如果这是Spring Boot应用程序，则可以在基于属性的仪表筛选器中声明SLA：

management.metrics.distribution.sla.http.request.duration=10ns,25ns,50ns,100ns,500ns,1000ns,5000ns

如果您使用的是Spring靴1。x、 你必须转义这里记录的名字。

另一方面，Spring已经使用名为http\u server\u requests的度量自动记录了请求持续时间。它上面没有Java类和Java方法，但是有方法和状态，还有一些其他的东西，这里没有。您有机会重写WebMvcTagsProvider，以提供其他标记（包括Java类和方法）：

@Bean
WebMvcTagsProvider requestTags() {
   return customProvider; // can be extended from DefaultWebMvcTagsProvider
}

WebMvcTagsProvider#httpRequestTags有一个handler参数，您可以从中推断类型和方法。

Answer 2

我在千分尺松弛频道得到了答案。解决这个问题的千分尺方法不是注册度量本身，而是注册一个过滤器，如下所示：

registry.config().meterFilter(new MeterFilter() {
    @Override
    public DistributionStatisticConfig configure(Meter.Id id, DistributionStatisticConfig config) {
        if (id.getName().equals("http.request.duration")) {
            return DistributionStatisticConfig.builder()
                    .sla(Duration.ofMillis(10).toNanos(),
                         Duration.ofMillis(25).toNanos(),
                         Duration.ofMillis(50).toNanos(), 
                         Duration.ofMillis(100).toNanos(),
                         Duration.ofMillis(500).toNanos(),
                         Duration.ofMillis(1000).toNanos(), 
                         Duration.ofMillis(5000).toNanos())
                    .build()
                    .merge(config);
        }
        return config;
    }
});

使用度量值推送度量值时。计时器（…） 如上所述，测微计将调用此过滤器并应用此处指定的所有配置。此过滤器仅在仪表初始化时调用，即度量时。计时器（…） 名称和标记第一次调用code>。所以我们不必担心这里的性能。