前言

Arthas 的 watch 指令一直是我排查线上问题时使用最多的指令，没有之一。而按照条件进行 watch 也是很常见的一个需求，例如线上一个方法会有大量的调用，而我们可以按照指定的条件，watch 到我们希望观察的那一次调用。

说实话，我对 Arthas 也没有什么研究，一开始还真不清楚原来 Arthas watch 可以按条件过滤，翻看一下官方文档：https://arthas.aliyun.com/doc/watch#id6

条件表达式的例子

$ watch demo.MathGame primeFactors "{params[0],target}" "params[0]<0"
Press Ctrl+C to abort.
Affect(class-cnt:1 , method-cnt:1) cost in 68 ms.
ts=2018-12-03 19:36:04; [cost=0.530255ms] result=@ArrayList[
    @Integer[-18178089],
    @MathGame[demo.MathGame@41cf53f9],
]

喏，这不是这么明显的例子吗？但是上面的例子，貌似只给出了一些简单的讯息

• 可以直接用 watch 命令的参数项中增加条件表达式进行过滤
• 可以进行数值类型的过滤

但是，这个简单的示例，并没有解答我内心其他的疑惑：

• 我可以进行字符串、集合等复杂类型的判断吗？
• 这个表达式是 el、ognl 或者其他类型的表达式吗？

带着这些疑问，我记录下了这篇文章，给不了解 Arthas watch 条件表达式的读者们一些参考。

一些条件表达式的示例

有一些读者可能仅仅是想知道“我该怎么实现使用 Arthas 条件 Watch”，为此，我在本文的第二节先介绍下我平时积累的一些实践命令。

示例方法

public void methodForWatch(int id, User user) {
}

User 结构

@Data
public class User {
    private String name;
    private int age;
    private List<String> hobbies;
}

另外准备一些请求，我会在每个示例中执行相同的调用。示例请求：

1, new User("hanmeimei", 16, Arrays.asList("pubg", "lol"));
2, new User("liming", 17, Collections.singletonList("pubg"));
3, new User("tom", 18, Collections.singletonList("running"));
4, new User("jacky", 19, Collections.singletonList("food"));

示例 1：过滤 int 类型；过滤 id > 0 的请求

这其实就是官方的示例，我拿过来再贴一遍

watch moe.cnkirito.arthas.WatchDemo methodForWatch "{params,returnObj}" "params[0]>0" -x 2

示例 2：过滤对象中的字符串类型；过滤 User 中 name = haimeimei 的请求

watch moe.cnkirito.arthas.WatchDemo methodForWatch "{params,returnObj}" "params[1].getName().equals('liming')" -x 2

这里有三个注意点

• 使用 params[1] 这种数组访问的方式，对应到 methodForWatch 方法的第二个参数 User user
• 使用 getName() 这种方法调用的方式拿到 name 字段，并且使用 String 的 equals 方法进行字符串比对
• 由于 condition 表达式整体使用了双引号 ""，在 hanmeimei 该字面量上需要使用单引号 ''

示例 3：过滤集合中的元素;过滤对 pubg 感兴趣的 User 相关的请求

watch moe.cnkirito.arthas.WatchDemo methodForWatch {params,returnObj} "params[1].getHobbies().contains('pubg')" -x 2

示例 4：多个条件表达式

增加请求示例

5, new User("kirito", 20, null);

按照示例 3 的 watch 语句执行，会发现 Arthas 直接抛了一个空指针：

watch failed, condition is: params[1].getHobbies().contains('pubg'), express is: {params,returnObj}, java.lang.NullPointerException: target is null for method contains, visit /Users/xujingfeng/logs/arthas/arthas.log for more details.

需要增加空指针的判断：

watch moe.cnkirito.actuator.demo.HelloController methodForWatch {params,returnObj} "params[1].getHobbies() != null && params[1].getHobbies().contains('pubg')" -x 2

呐，很简单，可以直接使用 && 增加判断条件。

ognl 实现条件过滤

可能有人要说了，Kirito 啊！你的公众号最近是不是广告发的太多了，深感愧疚，写了一篇没啥深度的原创文章来充数啊！那我当然要反驳啦，其实我看 Arthas 文档的时候也是踩了坑的，索性我将这个过程也分享一下。

可能大家看了上面的示例会觉得这个 condition 表达式不就是跟 Java 里面的表达式差不多吗？但其实我作为一个不太了解 Arthas 的弱鸡，上面的用法纯粹是我摸索出来的，在最开始的时候，参考 github 中的 issue，我使用的其实是其他的方式来实现的条件查询，参考 issue：https://github.com/alibaba/arthas/issues/71。

看下 github 中的 Arthas 开源作者提供的按条件过滤的示例，可以发现跟上文中我介绍的过滤方式好像，有那么一点点的不同。注意上文的示例

$ watch demo.MathGame primeFactors "{params[0],target}" "params[0]<0"

watch 后的参数是由 4 部分组成的，分别是类名表达式，方法名表达式，观察表达式，条件表达式。

而 issue 中给出的表达式

$ watch com.taobao.container.Test test "params[0].{? #this.name == null }" -x 2

没有第四部分：条件表达式。过滤条件被放到了观察表达式的对象后，并且不是 Java 里面的表达式，而是 ognl 表达式。

ognl 表达式官方参考文档：https://commons.apache.org/proper/commons-ognl/language-guide.html

例如使用 ognl 表达式实现上面的示例 2，需要这么写

示例 5：使用 ognl 表达式过滤对象中的字符串类型；过滤 User 中 name = haimeimei 的请求

watch moe.cnkirito.actuator.demo.HelloController methodForWatch "params[1].{? #this.name == 'hanmeimei'}" -x 2

示例 2 和示例 5 的对比

聊到这里，如果你对 Arthas 比较熟悉，应该已经意识到示例 5 ognl 过滤和示例 2 直接使用条件过滤表达式的区别了。ognl 这种过滤的方式，是针对对象的属性的过滤，无论是否匹配，都会被算进 watch 的匹配次数中，只不过没有匹配到的对象没有输出；而示例 2 中直接使用条件过滤表达式这种方式，更匹配我文首提出的需求，只有被条件表示式命中的请求，才会被算进 watch 次数中。你可以使用 -n 1 来限定 watch 匹配次数，直观地观察到这两个匹配方式的差异。

总结

本文简单介绍了使用 Arthas 条件表达式使用中可能踩到的一些坑，示例 1~4 可以参考，用于过滤一些指定的请求，让线上问题的定位变得更加高效。

Kirito 对 Arthas 的研究并不是特别深，如果还有其他关于条件表达式的问题或者本文存在的问题，欢迎留言交流~