Prometheus 快速入门教程（七）：SpringBoot 实现自定义指标监控

文章首发于【陈树义】公众号，点击跳转到原文：https://mp.weixin.qq.com/s/iXLfa8w8H3Aq3wh39ADK1w

上篇文章我们已经可以在 Grafana 上看到对应的 SpringBoot 应用信息了，通过这些信息我们可以对 SpringBoot 应用有更全面的监控。但是如果我们需要对一些业务指标做监控，我们应该怎么做呢？这篇文章就带你一步步实现一个模拟的订单业务指标监控。

假设我们有一个订单系统，我们需要监控它的实时订单总额、10分钟内的下单失败率、请求失败数。那么我们应该怎么做呢？

添加业务监控指标

在 spring-web-prometheus-demo 项目的基础上，我们添加一个 PrometheusCustomMonitor 类。在这里面我们定义了三个业务指标：

• order_request_count：下单总次数
• order_amount_sum：下单总金额

@Component
public class PrometheusCustomMonitor {

    /**
     * 订单发起次数
     */
    private Counter orderCount;

    /**
     * 金额统计
     */
    private DistributionSummary amountSum;

    private final MeterRegistry registry;

    @Autowired
    public PrometheusCustomMonitor(MeterRegistry registry) {
        this.registry = registry;
    }

    @PostConstruct
    private void init() {
        orderCount = registry.counter("order_request_count", "order", "test-svc");
        amountSum = registry.summary("order_amount_sum", "orderAmount", "test-svc");
    }

    public Counter getOrderCount() {
        return orderCount;
    }

    public DistributionSummary getAmountSum() {
        return amountSum;
    }
}

模拟订单数据

文章首发于【陈树义】公众号，点击跳转到原文：https://mp.weixin.qq.com/s/iXLfa8w8H3Aq3wh39ADK1w

这里我们新增一个 TestController 类，去模拟现实的订单数据。

后续应用启动后，我们可以通过 localhost:8080/order 去模拟用户下单操作。

package com.chenshuyi.springwebprometheusdemo;

import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

import javax.annotation.Resource;
import java.util.Random;

@RestController
public class TestController {

    @Resource
    private PrometheusCustomMonitor monitor;

    @RequestMapping("/order")
    public String order() throws Exception {
        // 统计下单次数
        monitor.getOrderCount().increment();
        Random random = new Random();
        int amount = random.nextInt(100);
        // 统计金额
        monitor.getAmountSum().record(amount);
        return "下单成功, 金额: " + amount;
    }
}

实际项目中，我们一般使用 AOP 的方式去实现业务指标上报。这里为了简单，直接写在代码里了。

启动项目测试

现在我们启动应用，访问 localhost:8080/order 可以成功模拟下单，每次都会有一个随机的订单金额产生。

此时我们访问 localhost:8080/actuator/prometheus 就可以看到对应的指标已经存在。

后续我们在 Grafana 中配置好相应的图表就可以看到对应的业务指标变化了。

配置Grafana图表

这里我们一共配置四个图表，分别是：

• 订单总数
• 订单支付总额
• 订单数增长率
• 订单支付金额增长率

配置订单个数图表

我们在原有面板上新建一个图表（Panel），名称命名为「订单个数」，来统计所有的订单数量。

在「数据配置区」中数据源选择「Prometheus」，Metrics 填入「order_amount_sum_count」。

接着在「图表设置区」的「Visualization」中选择「Stat」类别，表示这是一个统计数值。

接着在「图表设置区」的「Display」中的 Value 设置为「Last」，表示其值是取最后一个数值（因为这个数值是已经统计好了的）。Fields 设置为「Numeric Fields」，表示其是一个数值字段。

配置订单总额图表

文章首发于【陈树义】公众号，点击跳转到原文：https://mp.weixin.qq.com/s/iXLfa8w8H3Aq3wh39ADK1w

我们同样在原有面板上新建一个图表（Panel），名称命名为「订单金额」，来统计所有订单的支付总金额。

在「数据配置区」中数据源选择「Prometheus」，Metrics 填入「order_amount_sum_sum」。

接着在「图表设置区」的「Visualization」中选择「Stat」类别，表示这是一个统计数值。

接着在「图表设置区」的「Display」中的 Value 设置为「Last」，表示其值是取最后一个数值（因为这个数值是已经统计好了的）。Fields 设置为「Numeric Fields」，表示其是一个数值字段。

配置订单增长率

这里我们配置一个订单数的增长率，同样在原有面板上新建一个图表（Panel），名称命名为「订单增长率」，来统计订单数的增长率。

在「数据配置区」中数据源选择「Prometheus」，Metrics 填入「rate(order_amount_sum_count[1m])」，Legend 填入「{{instance}}」。

接着在「图表设置区」的「Visualization」中选择「Graph」类别，表示这是一个图形。

在「图表设置区」的「Axes」中设置「Left Y」的「Unit」设置其单位为：percent(0.0-1.0)。

配置订单金额增长率

与配置订单增长率相似，只不过这里的 Metrics 需要填入「rate(order_amount_sum_sum[1m])」。

在「图表设置区」的「Axes」中设置「Left Y」的「Unit」设置其单位为：percent(0-100)。

设置完之后的监控界面如下图所示：

接下来我们模拟一下订单的增长，访问下 localhost:8080/order 模拟下单。多访问几次，以便看到更明显的增长效果。

我们可以看到各项指标都有明显的变化，这说明我们的监控生效了！

文章首发于【陈树义】公众号，点击跳转到原文：https://mp.weixin.qq.com/s/iXLfa8w8H3Aq3wh39ADK1w

总结

我们通过一个简单的订单业务，模拟了实际的订单数、订单金额变化情况。接着，我们通过配置订单总数、订单总金额、订单数增长率、订单金额增长率这几个图表来实现自定义指标的监控。

实现自定义指标监控，有利于我们监控关键的业务指标，从而在线上问题发生之前提前预支问题，最终减少线上问题带来的损失。