update watch doc

pull/340/head
hengyunabc 6 years ago
parent f9ba6b05bc
commit e4723bf8bf

@ -14,13 +14,13 @@ import com.taobao.middleware.cli.annotations.Summary;
@Name("watch") @Name("watch")
@Summary("Display the input/output parameter, return object, and thrown exception of specified method invocation") @Summary("Display the input/output parameter, return object, and thrown exception of specified method invocation")
@Description(Constants.EXPRESS_DESCRIPTION + "\nExamples:\n" + @Description(Constants.EXPRESS_DESCRIPTION + "\nExamples:\n" +
" watch -Eb org\\.apache\\.commons\\.lang\\.StringUtils isBlank params[0]\n" +
" watch -b org.apache.commons.lang.StringUtils isBlank params[0]\n" + " watch -b org.apache.commons.lang.StringUtils isBlank params[0]\n" +
" watch -f org.apache.commons.lang.StringUtils isBlank returnObj\n" + " watch -f org.apache.commons.lang.StringUtils isBlank returnObj\n" +
" watch -bf *StringUtils isBlank params[0]\n" + " watch -bf *StringUtils isBlank params[0]\n" +
" watch *StringUtils isBlank params[0]\n" + " watch *StringUtils isBlank params[0]\n" +
" watch *StringUtils isBlank params[0] params[0].length==1\n" + " watch *StringUtils isBlank params[0] params[0].length==1\n" +
" watch *StringUtils isBlank '#cost>100'\n" + " watch *StringUtils isBlank '#cost>100'\n" +
" watch -E -b org\\.apache\\.commons\\.lang\\.StringUtils isBlank params[0]\n" +
Constants.WIKI + Constants.WIKI_HOME + "watch") Constants.WIKI + Constants.WIKI_HOME + "watch")
public class WatchCommand extends EnhancerCommand { public class WatchCommand extends EnhancerCommand {

@ -37,264 +37,196 @@ Advanced:
### Usage ### Usage
A demo: Start `arthas-demo` in [Quick Start](quick-start.md).
```java
public void execute() {
List<String> list = new ArrayList<String>();
list.add("a");
list.add("b");
List<String> list2 = new ArrayList<String>();
list2.add("c");
list2.add("d");
int len = add(list, list2);
}
private static int add(List<String> list, List<String> list2) {
list.addAll(list2);
return list.size();
}
```
#### Check the `out parameters` and `return value` #### Check the `out parameters` and `return value`
```shell ```bash
$ watch com.alibaba.sample.petstore.web.store.module.screen.ItemList add "{params,returnObj}" -x 2 $ watch demo.MathGame primeFactors "{params,returnObj}" -x 2
Press Ctrl+C to abort. Press Ctrl+C to abort.
Affect(class-cnt:1 , method-cnt:1) cost in 44 ms. Affect(class-cnt:1 , method-cnt:1) cost in 44 ms.
@ArrayList[ ts=2018-12-03 19:16:51; [cost=1.280502ms] result=@ArrayList[
@Object[][ @Object[][
@ArrayList[isEmpty=false;size=4], @Integer[535629513],
@ArrayList[isEmpty=false;size=2], ],
@ArrayList[
@Integer[3],
@Integer[19],
@Integer[191],
@Integer[49199],
], ],
@Integer[4],
] ]
``` ```
#### Check `in parameters` #### Check `in parameters`
```shell ```bash
$ watch com.alibaba.sample.petstore.web.store.module.screen.ItemList add "{params,returnObj}" -x 2 -b $ watch demo.MathGame primeFactors "{params,returnObj}" -x 2 -b
Press Ctrl+C to abort. Press Ctrl+C to abort.
Affect(class-cnt:1 , method-cnt:1) cost in 48 ms. Affect(class-cnt:1 , method-cnt:1) cost in 50 ms.
@ArrayList[ ts=2018-12-03 19:23:23; [cost=0.0353ms] result=@ArrayList[
@Object[][ @Object[][
@ArrayList[isEmpty=false;size=2], @Integer[-1077465243],
@ArrayList[isEmpty=false;size=2],
], ],
null, null,
] ]
``` ```
Compared to the previous *check*, there are two differences: Compared to the previous *check*:
1. size of `params[0]` is `2` instead of `4`;
2. `return value` is `null` since it's `-b`. * `return value` is `null` since it's `-b`.
#### Check *before* and *after* at the same time #### Check *before* and *after* at the same time
```shell
$ watch com.alibaba.sample.petstore.web.store.module.screen.ItemList add "{params,returnObj}" -x 2 -b -s ```bash
$ watch demo.MathGame primeFactors "{params,target,returnObj}" -x 2 -b -s -n 2
Press Ctrl+C to abort. Press Ctrl+C to abort.
Affect(class-cnt:1 , method-cnt:1) cost in 59 ms. Affect(class-cnt:1 , method-cnt:1) cost in 46 ms.
@ArrayList[ ts=2018-12-03 19:29:54; [cost=0.01696ms] result=@ArrayList[
@Object[][ @Object[][
@ArrayList[isEmpty=false;size=2], @Integer[1544665400],
@ArrayList[isEmpty=false;size=2], ],
@MathGame[
random=@Random[java.util.Random@522b408a],
illegalArgumentCount=@Integer[13038],
], ],
null, null,
] ]
@ArrayList[ ts=2018-12-03 19:29:54; [cost=4.277392ms] result=@ArrayList[
@Object[][ @Object[][
@ArrayList[isEmpty=false;size=4], @Integer[1544665400],
@ArrayList[isEmpty=false;size=2], ],
@MathGame[
random=@Random[java.util.Random@522b408a],
illegalArgumentCount=@Integer[13038],
],
@ArrayList[
@Integer[2],
@Integer[2],
@Integer[2],
@Integer[5],
@Integer[5],
@Integer[73],
@Integer[241],
@Integer[439],
], ],
@Integer[4],
] ]
``` ```
F.Y.I F.Y.I
1. the first block of output is the *before watching* point;
2. the order of the output determined by the *watching* order itself (nothing to do with the order of the options `-b -s`). * `-n 2`: threshold of execution times is 2.
* the first block of output is the *before watching* point;
* *the order of the output determined by the *watching* order itself (nothing to do with the order of the options `-b -s`).
#### Use `-x` to check more details #### Use `-x` to check more details
```shell ```bash
$ watch com.alibaba.sample.petstore.web.store.module.screen.ItemList add "{params,returnObj}" -x 3 $ watch demo.MathGame primeFactors "{params,target}" -x 3
Press Ctrl+C to abort. Press Ctrl+C to abort.
Affect(class-cnt:1 , method-cnt:1) cost in 59 ms. Affect(class-cnt:1 , method-cnt:1) cost in 58 ms.
@ArrayList[ ts=2018-12-03 19:34:19; [cost=0.587833ms] result=@ArrayList[
@Object[][ @Object[][
@ArrayList[ @Integer[47816758],
@String[a], ],
@MathGame[
@String[b], random=@Random[
serialVersionUID=@Long[3905348978240129619],
@String[c], seed=@AtomicLong[3133719055989],
multiplier=@Long[25214903917],
@String[d], addend=@Long[11],
], mask=@Long[281474976710655],
@ArrayList[ DOUBLE_UNIT=@Double[1.1102230246251565E-16],
@String[c], BadBound=@String[bound must be positive],
BadRange=@String[bound must be greater than origin],
@String[d], BadSize=@String[size must be non-negative],
seedUniquifier=@AtomicLong[-3282039941672302964],
nextNextGaussian=@Double[0.0],
haveNextNextGaussian=@Boolean[false],
serialPersistentFields=@ObjectStreamField[][isEmpty=false;size=3],
unsafe=@Unsafe[sun.misc.Unsafe@2eaa1027],
seedOffset=@Long[24],
], ],
illegalArgumentCount=@Integer[13159],
], ],
@Integer[4],
] ]
``` ```
* `-x`: Expand level of object (1 by default)
#### Use condition expressions to locate specific call #### Use condition expressions to locate specific call
```shell ```bash
$ watch com.alibaba.sample.petstore.biz.impl.UserManagerImpl testAdd "{params, returnObj}" "params[0].equals('aaa')" -x 2 $ watch demo.MathGame primeFactors "{params[0],target}" "params[0]<0"
Press Ctrl+C to abort. Press Ctrl+C to abort.
Affect(class-cnt:1 , method-cnt:1) cost in 29 ms. Affect(class-cnt:1 , method-cnt:1) cost in 68 ms.
@ArrayList[ ts=2018-12-03 19:36:04; [cost=0.530255ms] result=@ArrayList[
@Object[][ @Integer[-18178089],
@String[aaa], @MathGame[demo.MathGame@41cf53f9],
@String[bbb],
],
@Integer[6],
] ]
``` ```
#### Check `exceptions` #### Check `exceptions`
```shell ```bash
$ watch com.alibaba.sample.petstore.biz.impl.UserManagerImpl testAdd "{params, throwExp}" -e -x 2 $ watch demo.MathGame primeFactors "{params[0],throwExp}" -e -x 2
Press Ctrl+C to abort. Press Ctrl+C to abort.
Affect(class-cnt:1 , method-cnt:1) cost in 29 ms. Affect(class-cnt:1 , method-cnt:1) cost in 62 ms.
@ArrayList[ ts=2018-12-03 19:38:00; [cost=1.414993ms] result=@ArrayList[
@Object[][ @Integer[-1120397038],
@String[aaa], java.lang.IllegalArgumentException: number is: -1120397038, need >= 2
@String[bbb], at demo.MathGame.primeFactors(MathGame.java:46)
], at demo.MathGame.run(MathGame.java:24)
at demo.MathGame.main(MathGame.java:16)
java.lang.NullPointerException ,
at com.alibaba.sample.petstore.biz.impl.UserManagerImpl.testAdd(UserManagerImpl.java:75)
at com.alibaba.sample.petstore.biz.impl.UserManagerImpl.register(UserManagerImpl.java:60)
at com.alibaba.sample.petstore.web.user.module.action.RegisterAction.doRegister(RegisterAction.java:45)
at com.alibaba.sample.petstore.web.user.module.action.RegisterAction$$FastClassByCGLIB$$ad5428f1.invoke(<generated>)
at net.sf.cglib.reflect.FastMethod.invoke(FastMethod.java:53)
at com.alibaba.citrus.service.moduleloader.impl.adapter.MethodInvoker.invoke(MethodInvoker.java:70)
at com.alibaba.citrus.service.moduleloader.impl.adapter.AbstractModuleEventAdapter.executeAndReturn(AbstractModuleEventAdapter.java:100)
at com.alibaba.citrus.service.moduleloader.impl.adapter.AbstractModuleEventAdapter.execute(AbstractModuleEventAdapter.java:58)
at com.alibaba.citrus.turbine.pipeline.valve.PerformActionValve.invoke(PerformActionValve.java:63)
at com.alibaba.citrus.service.pipeline.impl.PipelineImpl$PipelineContextImpl.invokeNext(PipelineImpl.java:157)
at com.alibaba.citrus.service.pipeline.impl.PipelineImpl$PipelineContextImpl.invoke(PipelineImpl.java:210)
at com.alibaba.citrus.service.pipeline.impl.valve.ChooseValve.invoke(ChooseValve.java:98)
at com.alibaba.citrus.service.pipeline.impl.PipelineImpl$PipelineContextImpl.invokeNext(PipelineImpl.java:157)
at com.alibaba.citrus.service.pipeline.impl.PipelineImpl$PipelineContextImpl.invoke(PipelineImpl.java:210)
at com.alibaba.citrus.service.pipeline.impl.valve.LoopValve.invokeBody(LoopValve.java:105)
at com.alibaba.citrus.service.pipeline.impl.valve.LoopValve.invoke(LoopValve.java:83)
at com.alibaba.citrus.service.pipeline.impl.PipelineImpl$PipelineContextImpl.invokeNext(PipelineImpl.java:157)
at com.alibaba.citrus.turbine.pipeline.valve.PageAuthorizationValve.invoke(PageAuthorizationValve.java:105)
at com.alibaba.citrus.service.pipeline.impl.PipelineImpl$PipelineContextImpl.invokeNext(PipelineImpl.java:157)
at com.alibaba.citrus.turbine.pipeline.valve.CheckCsrfTokenValve.invoke(CheckCsrfTokenValve.java:123)
at com.alibaba.citrus.service.pipeline.impl.PipelineImpl$PipelineContextImpl.invokeNext(PipelineImpl.java:157)
at com.alibaba.citrus.turbine.pipeline.valve.AnalyzeURLValve.invoke(AnalyzeURLValve.java:126)
at com.alibaba.citrus.service.pipeline.impl.PipelineImpl$PipelineContextImpl.invokeNext(PipelineImpl.java:157)
at com.alibaba.citrus.turbine.pipeline.valve.SetLoggingContextValve.invoke(SetLoggingContextValve.java:66)
at com.alibaba.citrus.service.pipeline.impl.PipelineImpl$PipelineContextImpl.invokeNext(PipelineImpl.java:157)
at com.alibaba.citrus.turbine.pipeline.valve.PrepareForTurbineValve.invoke(PrepareForTurbineValve.java:52)
at com.alibaba.citrus.service.pipeline.impl.PipelineImpl$PipelineContextImpl.invokeNext(PipelineImpl.java:157)
at com.alibaba.citrus.service.pipeline.impl.PipelineImpl$PipelineContextImpl.invoke(PipelineImpl.java:210)
at com.alibaba.citrus.webx.impl.WebxControllerImpl.service(WebxControllerImpl.java:43)
at com.alibaba.citrus.webx.impl.WebxRootControllerImpl.handleRequest(WebxRootControllerImpl.java:53)
at com.alibaba.citrus.webx.support.AbstractWebxRootController.service(AbstractWebxRootController.java:165)
at com.alibaba.citrus.webx.servlet.WebxFrameworkFilter.doFilter(WebxFrameworkFilter.java:152)
at com.alibaba.citrus.webx.servlet.FilterBean.doFilter(FilterBean.java:148)
at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:241)
at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:208)
at com.alibaba.citrus.webx.servlet.SetLoggingContextFilter.doFilter(SetLoggingContextFilter.java:61)
at com.alibaba.citrus.webx.servlet.FilterBean.doFilter(FilterBean.java:148)
at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:241)
at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:208)
at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:220)
at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:122)
at com.taobao.tomcat.valves.ContextLoadFilterValve.invoke(ContextLoadFilterValve.java:152)
at org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:170)
at org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:103)
at org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:116)
at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:429)
at org.apache.coyote.http11.AbstractHttp11Processor.process(AbstractHttp11Processor.java:1085)
at org.apache.coyote.AbstractProtocol$AbstractConnectionHandler.process(AbstractProtocol.java:625)
at org.apache.tomcat.util.net.NioEndpoint$SocketProcessor.doRun(NioEndpoint.java:1760)
at org.apache.tomcat.util.net.NioEndpoint$SocketProcessor.run(NioEndpoint.java:1719)
at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1142)
at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:617)
at org.apache.tomcat.util.threads.TaskThread$WrappingRunnable.run(TaskThread.java:61)
at java.lang.Thread.run(Thread.java:745),
] ]
``` ```
#### Filter based on time cost * `-e`: Trigger when an exception is thrown
* `throwExp`: the exception object
```shell #### Filter by time cost
$ watch com.alibaba.sample.petstore.web.store.module.screen.ItemList add "{params,returnObj}" #cost>200 -x 3
```bash
$ watch demo.MathGame primeFactors '{params, returnObj}' '#cost>200' -x 2
Press Ctrl+C to abort. Press Ctrl+C to abort.
Affect(class-cnt:1 , method-cnt:1) cost in 59 ms. Affect(class-cnt:1 , method-cnt:1) cost in 66 ms.
@ArrayList[ ts=2018-12-03 19:40:28; [cost=2112.168897ms] result=@ArrayList[
@Object[][ @Object[][
@ArrayList[ @Integer[2141897465],
@String[a], ],
@ArrayList[
@String[b], @Integer[5],
@Integer[428379493],
@String[c],
@String[d],
],
@ArrayList[
@String[c],
@String[d],
],
], ],
@Integer[4],
] ]
``` ```
F.Y.I * `#cost>200` (`ms`) filter out all invokings that take less than `200ms`.
`#cost>200` (`ms`) filter out all invokings that take less than `200ms`.
#### Check the global properties of the target object #### Check the field of the target object
`target` stands for the current object. * `target` is the `this` object in java.
``` ```bash
$ watch com.taobao.container.web.arthas.rest.MyAppsController myFavoriteApps 'target' $ watch demo.MathGame primeFactors 'target'
Press Ctrl+C to abort. Press Ctrl+C to abort.
Affect(class-cnt:1 , method-cnt:1) cost in 128 ms. Affect(class-cnt:1 , method-cnt:1) cost in 52 ms.
ts=2017-10-31 18:45:55;result=@MyAppsController[ ts=2018-12-03 19:41:52; [cost=0.477882ms] result=@MathGame[
myFavAppsMapper=@$Proxy131[org.apache.ibatis.binding.MapperProxy@563e97f3], random=@Random[java.util.Random@522b408a],
getAppNameAndIdByEmpId=@$Proxy135[HardCodedTarget(type=GetAppNameAndIdByEmpId, url=http://hello.com)], illegalArgumentCount=@Integer[13355],
enableWebConsoleAppsMapper=@$Proxy132[org.apache.ibatis.binding.MapperProxy@7d51e4a8],
] ]
``` ```
`target.field_name` stands for a global property of the current object. * `target.field_name`: the field of the current object.
``` ```
$ watch com.taobao.container.web.arthas.rest.MyAppsController myFavoriteApps 'target.myFavAppsMapper' $ watch demo.MathGame primeFactors 'target.illegalArgumentCount'
Press Ctrl+C to abort. Press Ctrl+C to abort.
Affect(class-cnt:1 , method-cnt:1) cost in 126 ms. Affect(class-cnt:1 , method-cnt:1) cost in 67 ms.
ts=2017-10-31 18:46:17;result=@$Proxy131[ ts=2018-12-03 20:04:34; [cost=131.303498ms] result=@Integer[8]
m1=@Method[public boolean java.lang.Object.equals(java.lang.Object)], ts=2018-12-03 20:04:35; [cost=0.961441ms] result=@Integer[8]
m2=@Method[public java.lang.String java.lang.Object.toString()],
m5=@Method[public abstract java.util.List com.taobao.container.dal.arthas.mapper.MyFavAppsMapper.listFavApps(java.util.Map)],
m3=@Method[public abstract int com.taobao.container.dal.arthas.mapper.MyFavAppsMapper.delete(java.lang.String,java.lang.String,java.lang.String)],
m4=@Method[public abstract long com.taobao.container.dal.arthas.mapper.MyFavAppsMapper.insert(com.taobao.container.dal.arthas.domain.MyFavAppsDO)],
m0=@Method[public native int java.lang.Object.hashCode()],
]
``` ```

@ -31,274 +31,202 @@ watch 的参数比较多,主要是因为它能在 4 个不同的场景观察
**特别说明** **特别说明**
* watch 命令定义了4个观察事件点`-b` 方法调用前,`-e` 方法异常后,`-s` 方法返回后`-f` 方法结束后 * watch 命令定义了4个观察事件点`-b` 方法调用前,`-e` 方法异常后,`-s` 方法返回后`-f` 方法结束后
* 4个观察事件点 `-b`、`-e`、`-s` 默认关闭,`-f` 默认打开,当指定观察点被打开后,在相应事件点会对观察表达式进行求值并输出 * 4个观察事件点 `-b`、`-e`、`-s` 默认关闭,`-f` 默认打开,当指定观察点被打开后,在相应事件点会对观察表达式进行求值并输出
* 这里要注意`方法入参`和`方法出参`的区别,有可能在中间被修改导致前后不一致,除了 `-b` 事件点 `params` 代表方法入参外,其余事件都代表方法出参 * 这里要注意`方法入参`和`方法出参`的区别,有可能在中间被修改导致前后不一致,除了 `-b` 事件点 `params` 代表方法入参外,其余事件都代表方法出参
* 当使用 `-b` 时,由于观察事件点是在方法调用前,此时返回值或异常均不存在 * 当使用 `-b` 时,由于观察事件点是在方法调用前,此时返回值或异常均不存在
### 使用参考 ### 使用参考
代码示例: 启动[快速入门](quick-start.md)里的`arthas-demo`。
```java
public void execute() {
List<String> list = new ArrayList<String>();
list.add("a");
list.add("b");
List<String> list2 = new ArrayList<String>();
list2.add("c");
list2.add("d");
int len = add(list, list2);
}
private static int add(List<String> list, List<String> list2) {
list.addAll(list2);
return list.size();
}
```
#### 观察方法出参和返回值 #### 观察方法出参和返回值
```shell ```bash
$ watch com.alibaba.sample.petstore.web.store.module.screen.ItemList add "{params,returnObj}" -x 2 $ watch demo.MathGame primeFactors "{params,returnObj}" -x 2
Press Ctrl+C to abort. Press Ctrl+C to abort.
Affect(class-cnt:1 , method-cnt:1) cost in 44 ms. Affect(class-cnt:1 , method-cnt:1) cost in 44 ms.
@ArrayList[ ts=2018-12-03 19:16:51; [cost=1.280502ms] result=@ArrayList[
@Object[][ @Object[][
@ArrayList[isEmpty=false;size=4], @Integer[535629513],
@ArrayList[isEmpty=false;size=2], ],
@ArrayList[
@Integer[3],
@Integer[19],
@Integer[191],
@Integer[49199],
], ],
@Integer[4],
] ]
``` ```
#### 观察方法入参 #### 观察方法入参
```shell ```bash
$ watch com.alibaba.sample.petstore.web.store.module.screen.ItemList add "{params,returnObj}" -x 2 -b $ watch demo.MathGame primeFactors "{params,returnObj}" -x 2 -b
Press Ctrl+C to abort. Press Ctrl+C to abort.
Affect(class-cnt:1 , method-cnt:1) cost in 48 ms. Affect(class-cnt:1 , method-cnt:1) cost in 50 ms.
@ArrayList[ ts=2018-12-03 19:23:23; [cost=0.0353ms] result=@ArrayList[
@Object[][ @Object[][
@ArrayList[isEmpty=false;size=2], @Integer[-1077465243],
@ArrayList[isEmpty=false;size=2],
], ],
null, null,
] ]
``` ```
> 对比前一个例子params[0] 其size为2入参,返回值为空(事件点为方法执行前,因此获取不到返回值) * 对比前一个例子,返回值为空(事件点为方法执行前,因此获取不到返回值)
#### 同时观察方法调用前和方法返回后 #### 同时观察方法调用前和方法返回后
```shell ```bash
$ watch com.alibaba.sample.petstore.web.store.module.screen.ItemList add "{params,returnObj}" -x 2 -b -s $ watch demo.MathGame primeFactors "{params,target,returnObj}" -x 2 -b -s -n 2
Press Ctrl+C to abort. Press Ctrl+C to abort.
Affect(class-cnt:1 , method-cnt:1) cost in 59 ms. Affect(class-cnt:1 , method-cnt:1) cost in 46 ms.
@ArrayList[ ts=2018-12-03 19:29:54; [cost=0.01696ms] result=@ArrayList[
@Object[][ @Object[][
@ArrayList[isEmpty=false;size=2], @Integer[1544665400],
@ArrayList[isEmpty=false;size=2], ],
@MathGame[
random=@Random[java.util.Random@522b408a],
illegalArgumentCount=@Integer[13038],
], ],
null, null,
] ]
@ArrayList[ ts=2018-12-03 19:29:54; [cost=4.277392ms] result=@ArrayList[
@Object[][ @Object[][
@ArrayList[isEmpty=false;size=4], @Integer[1544665400],
@ArrayList[isEmpty=false;size=2], ],
@MathGame[
random=@Random[java.util.Random@522b408a],
illegalArgumentCount=@Integer[13038],
],
@ArrayList[
@Integer[2],
@Integer[2],
@Integer[2],
@Integer[5],
@Integer[5],
@Integer[73],
@Integer[241],
@Integer[439],
], ],
@Integer[4],
] ]
``` ```
>这里输出结果中,第一次输出的是方法调用前的观察表达式的结果,第二次输出的是方法返回后的表达式的结果 * 参数里`-n 2`,表示只执行两次
>结果的顺序和命令中 `-s -b` 的顺序没有关系,只与事件本身的先后顺序有关 * 这里输出结果中,第一次输出的是方法调用前的观察表达式的结果,第二次输出的是方法返回后的表达式的结果
* 结果的顺序和命令中 `-s -b` 的顺序没有关系,只与事件本身的先后顺序有关
#### 调整`-x`的值,观察具体的方法参数值 #### 调整`-x`的值,观察具体的方法参数值
```shell ```bash
$ watch com.alibaba.sample.petstore.web.store.module.screen.ItemList add "{params,returnObj}" -x 3 $ watch demo.MathGame primeFactors "{params,target}" -x 3
Press Ctrl+C to abort. Press Ctrl+C to abort.
Affect(class-cnt:1 , method-cnt:1) cost in 59 ms. Affect(class-cnt:1 , method-cnt:1) cost in 58 ms.
@ArrayList[ ts=2018-12-03 19:34:19; [cost=0.587833ms] result=@ArrayList[
@Object[][ @Object[][
@ArrayList[ @Integer[47816758],
@String[a], ],
@MathGame[
@String[b], random=@Random[
serialVersionUID=@Long[3905348978240129619],
@String[c], seed=@AtomicLong[3133719055989],
multiplier=@Long[25214903917],
@String[d], addend=@Long[11],
], mask=@Long[281474976710655],
@ArrayList[ DOUBLE_UNIT=@Double[1.1102230246251565E-16],
@String[c], BadBound=@String[bound must be positive],
BadRange=@String[bound must be greater than origin],
@String[d], BadSize=@String[size must be non-negative],
seedUniquifier=@AtomicLong[-3282039941672302964],
nextNextGaussian=@Double[0.0],
haveNextNextGaussian=@Boolean[false],
serialPersistentFields=@ObjectStreamField[][isEmpty=false;size=3],
unsafe=@Unsafe[sun.misc.Unsafe@2eaa1027],
seedOffset=@Long[24],
], ],
illegalArgumentCount=@Integer[13159],
], ],
@Integer[4],
] ]
``` ```
>`-x`表示遍历深度,可以调整来打印具体的参数和结果内容。 * `-x`表示遍历深度,可以调整来打印具体的参数和结果内容默认值是1
#### 条件表达式的例子 #### 条件表达式的例子
```shell ```bash
$ watch com.alibaba.sample.petstore.biz.impl.UserManagerImpl testAdd "{params, returnObj}" "params[0].equals('aaa')" -x 2 $ watch demo.MathGame primeFactors "{params[0],target}" "params[0]<0"
Press Ctrl+C to abort. Press Ctrl+C to abort.
Affect(class-cnt:1 , method-cnt:1) cost in 29 ms. Affect(class-cnt:1 , method-cnt:1) cost in 68 ms.
@ArrayList[ ts=2018-12-03 19:36:04; [cost=0.530255ms] result=@ArrayList[
@Object[][ @Integer[-18178089],
@String[aaa], @MathGame[demo.MathGame@41cf53f9],
@String[bbb],
],
@Integer[6],
] ]
``` ```
>只有满足条件的调用,才会有响应。 * 只有满足条件的调用,才会有响应。
#### 观察异常信息的例子 #### 观察异常信息的例子
```shell ```bash
$ watch com.alibaba.sample.petstore.biz.impl.UserManagerImpl testAdd "{params, throwExp}" -e -x 2 $ watch demo.MathGame primeFactors "{params[0],throwExp}" -e -x 2
Press Ctrl+C to abort. Press Ctrl+C to abort.
Affect(class-cnt:1 , method-cnt:1) cost in 29 ms. Affect(class-cnt:1 , method-cnt:1) cost in 62 ms.
@ArrayList[ ts=2018-12-03 19:38:00; [cost=1.414993ms] result=@ArrayList[
@Object[][ @Integer[-1120397038],
@String[aaa], java.lang.IllegalArgumentException: number is: -1120397038, need >= 2
@String[bbb], at demo.MathGame.primeFactors(MathGame.java:46)
], at demo.MathGame.run(MathGame.java:24)
at demo.MathGame.main(MathGame.java:16)
java.lang.NullPointerException ,
at com.alibaba.sample.petstore.biz.impl.UserManagerImpl.testAdd(UserManagerImpl.java:75)
at com.alibaba.sample.petstore.biz.impl.UserManagerImpl.register(UserManagerImpl.java:60)
at com.alibaba.sample.petstore.web.user.module.action.RegisterAction.doRegister(RegisterAction.java:45)
at com.alibaba.sample.petstore.web.user.module.action.RegisterAction$$FastClassByCGLIB$$ad5428f1.invoke(<generated>)
at net.sf.cglib.reflect.FastMethod.invoke(FastMethod.java:53)
at com.alibaba.citrus.service.moduleloader.impl.adapter.MethodInvoker.invoke(MethodInvoker.java:70)
at com.alibaba.citrus.service.moduleloader.impl.adapter.AbstractModuleEventAdapter.executeAndReturn(AbstractModuleEventAdapter.java:100)
at com.alibaba.citrus.service.moduleloader.impl.adapter.AbstractModuleEventAdapter.execute(AbstractModuleEventAdapter.java:58)
at com.alibaba.citrus.turbine.pipeline.valve.PerformActionValve.invoke(PerformActionValve.java:63)
at com.alibaba.citrus.service.pipeline.impl.PipelineImpl$PipelineContextImpl.invokeNext(PipelineImpl.java:157)
at com.alibaba.citrus.service.pipeline.impl.PipelineImpl$PipelineContextImpl.invoke(PipelineImpl.java:210)
at com.alibaba.citrus.service.pipeline.impl.valve.ChooseValve.invoke(ChooseValve.java:98)
at com.alibaba.citrus.service.pipeline.impl.PipelineImpl$PipelineContextImpl.invokeNext(PipelineImpl.java:157)
at com.alibaba.citrus.service.pipeline.impl.PipelineImpl$PipelineContextImpl.invoke(PipelineImpl.java:210)
at com.alibaba.citrus.service.pipeline.impl.valve.LoopValve.invokeBody(LoopValve.java:105)
at com.alibaba.citrus.service.pipeline.impl.valve.LoopValve.invoke(LoopValve.java:83)
at com.alibaba.citrus.service.pipeline.impl.PipelineImpl$PipelineContextImpl.invokeNext(PipelineImpl.java:157)
at com.alibaba.citrus.turbine.pipeline.valve.PageAuthorizationValve.invoke(PageAuthorizationValve.java:105)
at com.alibaba.citrus.service.pipeline.impl.PipelineImpl$PipelineContextImpl.invokeNext(PipelineImpl.java:157)
at com.alibaba.citrus.turbine.pipeline.valve.CheckCsrfTokenValve.invoke(CheckCsrfTokenValve.java:123)
at com.alibaba.citrus.service.pipeline.impl.PipelineImpl$PipelineContextImpl.invokeNext(PipelineImpl.java:157)
at com.alibaba.citrus.turbine.pipeline.valve.AnalyzeURLValve.invoke(AnalyzeURLValve.java:126)
at com.alibaba.citrus.service.pipeline.impl.PipelineImpl$PipelineContextImpl.invokeNext(PipelineImpl.java:157)
at com.alibaba.citrus.turbine.pipeline.valve.SetLoggingContextValve.invoke(SetLoggingContextValve.java:66)
at com.alibaba.citrus.service.pipeline.impl.PipelineImpl$PipelineContextImpl.invokeNext(PipelineImpl.java:157)
at com.alibaba.citrus.turbine.pipeline.valve.PrepareForTurbineValve.invoke(PrepareForTurbineValve.java:52)
at com.alibaba.citrus.service.pipeline.impl.PipelineImpl$PipelineContextImpl.invokeNext(PipelineImpl.java:157)
at com.alibaba.citrus.service.pipeline.impl.PipelineImpl$PipelineContextImpl.invoke(PipelineImpl.java:210)
at com.alibaba.citrus.webx.impl.WebxControllerImpl.service(WebxControllerImpl.java:43)
at com.alibaba.citrus.webx.impl.WebxRootControllerImpl.handleRequest(WebxRootControllerImpl.java:53)
at com.alibaba.citrus.webx.support.AbstractWebxRootController.service(AbstractWebxRootController.java:165)
at com.alibaba.citrus.webx.servlet.WebxFrameworkFilter.doFilter(WebxFrameworkFilter.java:152)
at com.alibaba.citrus.webx.servlet.FilterBean.doFilter(FilterBean.java:148)
at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:241)
at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:208)
at com.alibaba.citrus.webx.servlet.SetLoggingContextFilter.doFilter(SetLoggingContextFilter.java:61)
at com.alibaba.citrus.webx.servlet.FilterBean.doFilter(FilterBean.java:148)
at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:241)
at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:208)
at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:220)
at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:122)
at com.taobao.tomcat.valves.ContextLoadFilterValve.invoke(ContextLoadFilterValve.java:152)
at org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:170)
at org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:103)
at org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:116)
at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:429)
at org.apache.coyote.http11.AbstractHttp11Processor.process(AbstractHttp11Processor.java:1085)
at org.apache.coyote.AbstractProtocol$AbstractConnectionHandler.process(AbstractProtocol.java:625)
at org.apache.tomcat.util.net.NioEndpoint$SocketProcessor.doRun(NioEndpoint.java:1760)
at org.apache.tomcat.util.net.NioEndpoint$SocketProcessor.run(NioEndpoint.java:1719)
at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1142)
at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:617)
at org.apache.tomcat.util.threads.TaskThread$WrappingRunnable.run(TaskThread.java:61)
at java.lang.Thread.run(Thread.java:745),
] ]
``` ```
>express中表示异常信息的变量是`throwExp` * `-e`表示抛出异常时才触发
* express中表示异常信息的变量是`throwExp`
#### 按照耗时进行过滤 #### 按照耗时进行过滤
```shell ```bash
$ watch com.alibaba.sample.petstore.web.store.module.screen.ItemList add "{params,returnObj}" #cost>200 -x 3 $ watch demo.MathGame primeFactors '{params, returnObj}' '#cost>200' -x 2
Press Ctrl+C to abort. Press Ctrl+C to abort.
Affect(class-cnt:1 , method-cnt:1) cost in 59 ms. Affect(class-cnt:1 , method-cnt:1) cost in 66 ms.
@ArrayList[ ts=2018-12-03 19:40:28; [cost=2112.168897ms] result=@ArrayList[
@Object[][ @Object[][
@ArrayList[ @Integer[2141897465],
@String[a], ],
@ArrayList[
@String[b], @Integer[5],
@Integer[428379493],
@String[c],
@String[d],
],
@ArrayList[
@String[c],
@String[d],
],
], ],
@Integer[4],
] ]
``` ```
>#cost>200(单位是`ms`)表示只有当耗时大于200ms时才会输出过滤掉执行时间小于200ms的调用 * `#cost>200`(单位是`ms`)表示只有当耗时大于200ms时才会输出过滤掉执行时间小于200ms的调用
#### 观察当前对象中的全局属性 #### 观察当前对象中的属性
如果想查看方法运行前后,当前对象中的全局属性,可以使用`target`关键字,代表当前对象 如果想查看方法运行前后,当前对象中的属性,可以使用`target`关键字,代表当前对象
``` ```bash
$ watch com.taobao.container.web.arthas.rest.MyAppsController myFavoriteApps 'target' $ watch demo.MathGame primeFactors 'target'
Press Ctrl+C to abort. Press Ctrl+C to abort.
Affect(class-cnt:1 , method-cnt:1) cost in 128 ms. Affect(class-cnt:1 , method-cnt:1) cost in 52 ms.
ts=2017-10-31 18:45:55;result=@MyAppsController[ ts=2018-12-03 19:41:52; [cost=0.477882ms] result=@MathGame[
myFavAppsMapper=@$Proxy131[org.apache.ibatis.binding.MapperProxy@563e97f3], random=@Random[java.util.Random@522b408a],
getAppNameAndIdByEmpId=@$Proxy135[HardCodedTarget(type=GetAppNameAndIdByEmpId, url=http://hello.com)], illegalArgumentCount=@Integer[13355],
enableWebConsoleAppsMapper=@$Proxy132[org.apache.ibatis.binding.MapperProxy@7d51e4a8],
] ]
``` ```
然后使用`target.field_name`访问当前对象的某个全局属性 然后使用`target.field_name`访问当前对象的某个属性
``` ```
$ watch com.taobao.container.web.arthas.rest.MyAppsController myFavoriteApps 'target.myFavAppsMapper' $ watch demo.MathGame primeFactors 'target.illegalArgumentCount'
Press Ctrl+C to abort. Press Ctrl+C to abort.
Affect(class-cnt:1 , method-cnt:1) cost in 126 ms. Affect(class-cnt:1 , method-cnt:1) cost in 67 ms.
ts=2017-10-31 18:46:17;result=@$Proxy131[ ts=2018-12-03 20:04:34; [cost=131.303498ms] result=@Integer[8]
m1=@Method[public boolean java.lang.Object.equals(java.lang.Object)], ts=2018-12-03 20:04:35; [cost=0.961441ms] result=@Integer[8]
m2=@Method[public java.lang.String java.lang.Object.toString()],
m5=@Method[public abstract java.util.List com.taobao.container.dal.arthas.mapper.MyFavAppsMapper.listFavApps(java.util.Map)],
m3=@Method[public abstract int com.taobao.container.dal.arthas.mapper.MyFavAppsMapper.delete(java.lang.String,java.lang.String,java.lang.String)],
m4=@Method[public abstract long com.taobao.container.dal.arthas.mapper.MyFavAppsMapper.insert(com.taobao.container.dal.arthas.domain.MyFavAppsDO)],
m0=@Method[public native int java.lang.Object.hashCode()],
]
``` ```
Loading…
Cancel
Save