从 Pulsar Client 的原理到它的监控面板

背景

前段时间业务团队偶尔会碰到一些 Pulsar 使用的问题，比如消息阻塞不消费了、生产者消息发送缓慢等各种问题。

虽然我们有个监控页面可以根据 topic 维度查看他的发送状态，比如速率、流量、消费状态等信息。

但也有几个问题：

• 无法在应用维度查看他所依赖的所有 topic 的各种状态。
• 监控的信息还不够，比如发送/消费延迟、发送/消费失败等数据。

总之就是缺少一个全局的监控视角，通过这些指标可以很方便的分析出当时的运行情况。

基于这个需求经过一段时间的折腾，现在已经上线使用几个月，目前比较稳定，效果图如下：

现在就可以在每个应用的监控面板里看到自己使用了哪些 topic，分别的生产消费情况如何。

核心流程

要实现这些功能就得在应用的 metrics 中加入相关的监控信息，但官方的 Java client 是没有暴露出这些指标的。

但 pulsar-client-go 是自带了这些指标的

由于 SDK 不支持所以只能自己想办法实现了，为此其实有两种实现方案：

• 魔改 Java client，在需要监控的地方手动埋点指标。
• 由于我们使用了 SkyWalking，所以可以编写插件，以 agent 的方式获取数据、埋点指标。

不过第一种方案有以下一些问题：

• 需要自己维护一个代码分支，还需要定期和官方保持一致，难免会出现代码冲突。
• 需要推动业务方进行依赖升级，线上有着几百个应用，推动起来时间太慢。

第二种方案的好处就不言而喻了：

• 升级无感知，只需要在我们的基础镜像中加上插件即可。
• Java client 的版本也更容易统一。

Client 原理

但其实不管是哪种方案我们都得熟悉 Java Client 的实现原理，才能知道哪些数据是我们需要重点关注的，可以帮助我们更好的定位问题。

本文重点不在于此，具体代码就不仔细分析了。

从上图可以看出，如果我们想要监控消费是否存在阻塞的情况，这几个内部队列是需要重点监控的，一旦他们出现堆积，那就会出现消费阻塞。

其实这些数据都可以通过

org.apache.pulsar.client.api.ProducerStats
org.apache.pulsar.client.api.ConsumerStats

这两个接口获取到生产者和消费者的大部分指标，只是这里还有一个小插曲。

那就是在获取消费者队列大小的时候，获取到的数据一直为空。

最终经过源码排查，原来是我们大量使用的 messageListener 在获取队列大小时有 bug，导致获取到的数据一直都为 0.

相关的 issue 和 PR 可以在这两个链接查看，问题原因和修复过程都有具体描述：

https://github.com/apache/pulsar/issues/20076

https://github.com/apache/pulsar/pull/20245

但这个修复得在新版本才能使用，就导致我们现在的监控页面一直显示为空。

开发 SkyWalking 插件

然后就是开发一个 SkyWalking 的插件了，其实直接使用 SW 开发插件是上手 Java-Agent 比较快的方式。

SW 的 SDK 封装了许多 agent 原生接口，使得开发起来非常容易；当然缺点也有，就是得集成整个 SW 的 agent。

这里我简单介绍下这个插件的运行流程：

• 在创建和删除 consumer 的时候维护 consumerPool
• 启动一个定时任务，定期从这些 consumer 中获取指标数据。
  
  
  
  

当消费多分区 topic 时，为了能唯一标志一个 consumer，所以给每个消费者都加了一个 hashcode 的 label。

因为我们所有的 Java 技术栈都是使用的 Prometheus 的包来生成 metrics ，所以该插件也是使用该包生成的数据。

<dependency>
  <groupId>io.prometheus</groupId>
  <artifactId>simpleclient</artifactId>
  <version>0.12.0</version>
  <scope>provided</scope>
</dependency>

为了兼容一些特殊 Java 应用没有该包时会启动报错，所以在初始化插件的时候需要检测当前 classpath 下是否存在该依赖。

这些功能 SW 已经封装好了，对我们来说也是开箱即用。

其实 SW 插件自己也是支持 metrics 的，由于我们只是使用了它的 trace 功能，所以这里就没有使用它的 API。

关于开发一个 SW 插件的流程也比较简单，可以参考官方文档或者是一些现成的插件源码。

https://skywalking.apache.org/docs/skywalking-java/next/en/setup/service-agent/java-agent/java-plugin-development-guide/

总结

有了这个监控面板后，对于 Pulsar 客户端内部的一些运行情况就不再是黑盒了，还可以基于此做一些报警，比如消费堆积、发送延迟过大等。

当然仅仅只有这个面板依然是不够的，后续我们又开发了可以通过 messageId 查询它的整个生命周期，包括：

• 生产者、消费者信息
• 消息生产时间
• 推送时间
• ack 时间等

同时借助与 Pulsar-SQL 的能力，还能以列表的形式展示当前 topic 的消息列表。



当然在实现这两个功能的同时也踩了不少坑，提了几个 PR ，后面在抽时间做具体的分享。