【greys使用】阿里greys在线诊断工具
Greys是一个Java进程的异常诊断工具，可以在不停止程序的前提下，对一些问题进行检测。这个框架主要是采用Java的探针技术，可以做到动态修改java的字节码技术。前提是Jdk版本6+。（premain是Java SE5开始就提供的代理方式，由于其必须在命令行指定代理jar，并且代理类必须在main方法前启动。因此，要求开发者在应用前就必须确认代理的处理逻辑和参数内容等等。在有些场合下，premain代理方式不能满足需求。为解决运行时启动代理类的问题，Java SE6开始提供了在应用程序的VM启动后在动态添加代理的方式，即agentmain方式。 ）
一、我的经历
我是一个Java开发人员，第一次使用greys是2年前，当时开发的项目是一个大型系统，开发人员比较多。但是，开发和测试环境都只有一套。这样就有一个问题，那就是每个人代码提交，编译部署的时候，频率需要得到控制。因为大家使用的都是同一套系统，不能因为你一个人去重启相关的服务，从而影响到其他服务。当时，我就迫切地想开发一套工具，可以在程序运行的时候，直接对程序已有的功能进行调试。后面，我在百度上看到greys的介绍，虽然资料偏少，但是这已经成功引起了我的注意。于是，我就从github上寻找这个工具的相关代码。后面，自己在空闲时间试用了一段时间。经过验证，这是一个值得使用的好工具！所以，我想今天空闲时间把这个工具分享给大家。
二、安装使用
1.下载安装
下载代码：
git clone https://github.com/oldmanpushcart/greys-anatomy.git
切换到bin目录：
cd greys-anatomy/bin/
执行打包命令：
./greys-packages.sh
2.开始使用
2.1 目录介绍
bin目录下有以下这些脚本文件：
ga.sh（greys-attach，我看着就检测是否可以对程序进行在线诊断）
greys.sh（这个是我最经常使用的脚本，检测全靠这个，内嵌gs.sh）
greys-packages.sh（本地编译打包安装，内嵌install-local.sh）
gs.sh（greys-shell，主要是通过一些程序的命令行完成一些操作）
install.sh（程序远程安装的一种方式）
install-local.sh（本地安装）
2.2 正式使用
2.2.1 直接运行 ./greys.sh 【进程号】，就可以对程序进行一些诊断了
2.2.2 支持的命令
2.2.2 具体命令介绍
注意：
1.所有的命令都可以使用【help 命令】获得所有配置信息，比如【help sc】就可以获得sc的用法
2.命令阻塞的时候，可以使用ctrl+d键取消执行
【sc】Search-Class的简写，可以展示所有已加载的Class信息
【用法】sc
class-pattern 类名表达式匹配
method-pattern 方法名表达式匹配
[d] 输出当前类的详细信息，包括这个类所加载的原始文件来源、类的声明、类加载器等详细信息。
[f] 输出当前类的成员变量信息
[E] 支持正则表达式匹配
【例子】
搜索类：
查看类明细：
【sm】Search-Method的简写，可以展示所有已经加载Class下的方法信息
【用法】sm
class-pattern 类名表达式匹配
method-pattern 方法名表达式匹配
[d] 展示每个方法的详细信息
[E] 支持正则表达式匹配
【例子】
搜索方法：
查看方法明细：
【monitor】可以对方法进行监控
【用法】monitor
c统计周期（单位：秒），默认值为120秒
【说明】
Affect(class-cnt:1 , method-cnt:1) cost in 24 ms. == 这句说明有对我们程序的类和方法进行增强。如果cnt=0，说明增强失败了。
结果信息有：
timestamp 时间戳
class Java类
method 方法（构造方法、普通方法）
total 调用次数
success 成功次数
fail 失败次数
rt 平均RT
fail-rate 失败率
【例子】
监控成功/失败次数：
【watch】可以查看方法的输入、输出、异常情况
【用法】watch
class-pattern类名表达式匹配
method-pattern方法名表达式匹配
condition-express条件表达式
express观察表达式
[b]在**方法调用之前**观察
[e]在**方法异常之后**观察
[s]在**方法返回之后**观察
[f]在**方法结束之后**(正常返回和异常返回)观察
【例子】
查看输入参数：
查看输出结果：
【tt】记录时间，方法耗时，是否返回，是否异常等信息
【用法】tt
class-pattern类名表达式匹配
method-pattern方法名表达式匹配
condition-express条件表达式
n 执行次数
【说明】
INDEX时间片段记录编号，每一个编号代表着一次调用，后续tt还有很多命令都是基于此编号指定记录操作，非常重要。
PROCESS-ID过程编号，我们认为同一个线程的一次同步调用为一个过程
TIMESTAMP方法执行的本机时间，记录了这个时间片段所发生的本机时间
COST(ms)方法执行的耗时
IS-RET方法是否以正常返回的形式结束
IS-EXP方法是否以抛异常的形式结束
OBJECT执行对象的hashCode()，注意，曾经有人误认为是对象在JVM中的无力内存地址，但很遗憾他不是。但他能帮助你简单的标记当前执行方法的类实体
CLASS执行的类名
METHOD执行的方法名
【例子】
统计方法耗时：
【stack】打印调用的堆栈信息
【用法】stack
class-pattern类名表达式匹配
method-pattern方法名表达式匹配
condition-express条件表达式
[n:]命令执行次数
[E]支持正则表达式匹配
【例子】
打印方法的堆栈信息
p
【ptrace】打印方法的详细执行过程
【用法】ptrace
class-pattern类名表达式匹配
method-pattern方法名表达式匹配
condition-express条件表达式
[t]记录下渲染路径上所有方法的入参与返回值，记录下的返回值可以与tt命令联动
[n:]命令执行次数
[E]支持正则表达式匹配
[path:]渲染路径表达式匹配，该参数可多次使用
[Epath:]正则表达式渲染路径表达式匹配，该参数可多次使用
【例子】
打印方法的详细执行过程：
【trace】打印方法的详细执行过程
【用法】trace
class-pattern类名表达式匹配
method-pattern方法名表达式匹配
condition-express条件表达式
[n:]命令执行次数
[E]支持正则表达式匹配
...
【例子】
打印概要执行过程：
【session】查看会话信息
【用法】session
【例子】
查看会话信息：
【version】查看版本信息
【用法】version
【例子】
查看版本信息：
【jvm】查看JVM信息
【用法】jvm
【例子】
查看JVM信息
【top】查看线程占用的cpu信息
【用法】top
【例子】
查看线程占用的cpu信息：
【reset】重置增强类
【用法】reset
【例子】
重置增强类：
【quit】退出控制台【shutdown】删除并退出控制台
【用法】quit/shutdown
【例子】
退出控制台：
关闭并退出控制台：
3 使用不足之处
3.1 回格键（Backspace）无法识别，经常输入错误，无法回删命令；
3.2 方向键使用上一条命令还不够人性化，经常很多命令杂在一起显示；
3.3 如果一个类被增强，则会出现多个诊断结果（类本身+增强后的类）。
以上是我的使用介绍，谢谢观看。下次出一篇源码解析，欢迎继续关注！
