mirror of
https://github.com/alibaba/arthas.git
synced 2026-11-18 22:59:20 +00:00
update doc 3.1.2
This commit is contained in:
1 parent
1afcb5035d
commit
39091052c1
206 files changed
+8994
-6117
No files matched your search
+52
-67
@@ -8,7 +8,7 @@
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>Arthas 3.0新特性介绍 — Arthas 3.1.1 文档</title>
|
||||
<title>Arthas 3.0新特性介绍 — Arthas 3.1.2 文档</title>
|
||||
|
||||
|
||||
|
||||
@@ -19,13 +19,21 @@
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
|
||||
|
||||
|
||||
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
|
||||
<script type="text/javascript" src="../_static/jquery.js"></script>
|
||||
<script type="text/javascript" src="../_static/underscore.js"></script>
|
||||
<script type="text/javascript" src="../_static/doctools.js"></script>
|
||||
<script type="text/javascript" src="../_static/language_data.js"></script>
|
||||
<script type="text/javascript" src="../_static/translations.js"></script>
|
||||
|
||||
<script type="text/javascript" src="../_static/js/theme.js"></script>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
|
||||
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
|
||||
<link rel="stylesheet" href="../_static/overrides.css" type="text/css" />
|
||||
@@ -35,21 +43,16 @@
|
||||
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.13.1/styles/github.min.css">
|
||||
|
||||
|
||||
|
||||
|
||||
<script src="../_static/js/modernizr.min.js"></script>
|
||||
|
||||
</head>
|
||||
|
||||
<body class="wy-body-for-nav">
|
||||
|
||||
|
||||
<div class="wy-grid-for-nav">
|
||||
|
||||
|
||||
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
|
||||
<div class="wy-side-scroll">
|
||||
<div class="wy-side-nav-search">
|
||||
<div class="wy-side-nav-search" >
|
||||
|
||||
|
||||
|
||||
@@ -63,7 +66,7 @@
|
||||
|
||||
|
||||
<div class="version">
|
||||
3.1.1
|
||||
3.1.2
|
||||
</div>
|
||||
|
||||
|
||||
@@ -91,15 +94,17 @@
|
||||
<li class="toctree-l1"><a class="reference external" href="https://alibaba.github.io/arthas/en/">English Docs</a></li>
|
||||
<li class="toctree-l1"><a class="reference external" href="https://alibaba.github.io/arthas/arthas-tutorials?language=cn">在线教程(推荐)</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../install-detail.html">安装</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../download.html">下载</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../quick-start.html">快速入门</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../advanced-use.html">进阶使用</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../commands.html">命令列表</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../web-console.html">WebConsole</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../docker.html">Docker</a></li>
|
||||
<li class="toctree-l1"><a class="reference external" href="https://github.com/alibaba/arthas/issues?q=label%3Auser-case">用户案例</a></li>
|
||||
<li class="toctree-l1"><a class="reference external" href="https://github.com/alibaba/arthas/issues?q=label%3Aquestion-answered">常见问题</a></li>
|
||||
<li class="toctree-l1"><a class="reference external" href="https://github.com/alibaba/arthas">Fork me at GitHub</a></li>
|
||||
<li class="toctree-l1"><a class="reference external" href="https://github.com/alibaba/arthas/blob/master/CONTRIBUTING.md">参与贡献</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../release-notes.html">Release Notes</a></li>
|
||||
<li class="toctree-l1"><a class="reference external" href="https://github.com/alibaba/arthas/blob/master/CONTRIBUTING">编译调试/参与贡献</a></li>
|
||||
<li class="toctree-l1"><a class="reference external" href="https://github.com/alibaba/arthas/releases">Release Notes</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../contact-us.html">QQ群/钉钉群</a></li>
|
||||
</ul>
|
||||
|
||||
@@ -168,17 +173,17 @@
|
||||
<div itemprop="articleBody">
|
||||
|
||||
<div class="section" id="arthas-3-0">
|
||||
<span id="arthas-3-0"></span><h1>Arthas 3.0新特性介绍<a class="headerlink" href="#arthas-3-0" title="永久链接至标题">¶</a></h1>
|
||||
<p>Arthas 3.0在架构上做了重大改造,通过引入<tt class="docutils literal">termd</tt>完整的支持了telnet协议,并基于websocket封装了telnet协议实现了<tt class="docutils literal">Telnet over HTTP</tt>,使得在线诊断成为了可能,并且保证了本地启动,telnet远程访问,在线诊断三种方式的体验完全一致。都支持自动补全,高亮显示等功能。并且支持<tt class="docutils literal">多人同时在线诊断</tt>。</p>
|
||||
<div class="section" id="">
|
||||
<span id="id1"></span><h2>在线诊断<a class="headerlink" href="#" title="永久链接至标题">¶</a></h2>
|
||||
<h1>Arthas 3.0新特性介绍<a class="headerlink" href="#arthas-3-0" title="永久链接至标题">¶</a></h1>
|
||||
<p>Arthas 3.0在架构上做了重大改造,通过引入<code class="docutils literal notranslate"><span class="pre">termd</span></code>完整的支持了telnet协议,并基于websocket封装了telnet协议实现了<code class="docutils literal notranslate"><span class="pre">Telnet</span> <span class="pre">over</span> <span class="pre">HTTP</span></code>,使得在线诊断成为了可能,并且保证了本地启动,telnet远程访问,在线诊断三种方式的体验完全一致。都支持自动补全,高亮显示等功能。并且支持<code class="docutils literal notranslate"><span class="pre">多人同时在线诊断</span></code>。</p>
|
||||
<div class="section" id="id1">
|
||||
<h2>在线诊断<a class="headerlink" href="#id1" title="永久链接至标题">¶</a></h2>
|
||||
<p>Arthas 3.0最重要的特性,通过Arthas在线诊断平台,无需再登陆目标机器,一键启动Arthas并开启诊断!</p>
|
||||
<p></p>
|
||||
<p>具体使用方法请参见<a class="reference external" href="https://github.com/alibaba/arthas/wiki/arthas_3_0/home">在线诊断使用说明</a></p>
|
||||
</div>
|
||||
<div class="section" id="">
|
||||
<span id="id2"></span><h2>管道支持<a class="headerlink" href="#" title="永久链接至标题">¶</a></h2>
|
||||
<p>Arthas 3.0开始支持管道, 率先提供了<tt class="docutils literal">grep</tt>,<tt class="docutils literal">wc</tt>,<tt class="docutils literal">plaintext</tt>的支持。</p>
|
||||
<div class="section" id="id2">
|
||||
<h2>管道支持<a class="headerlink" href="#id2" title="永久链接至标题">¶</a></h2>
|
||||
<p>Arthas 3.0开始支持管道, 率先提供了<code class="docutils literal notranslate"><span class="pre">grep</span></code>,<code class="docutils literal notranslate"><span class="pre">wc</span></code>,<code class="docutils literal notranslate"><span class="pre">plaintext</span></code>的支持。</p>
|
||||
<div class="highlight-bash notranslate"><div class="highlight hljs"><pre class="bash"> java.vendor.url http://java.oracle.com/
|
||||
java.vm.vendor Oracle Corporation
|
||||
java.runtime.name Java(TM) SE Runtime Environment
|
||||
@@ -195,12 +200,11 @@
|
||||
java.vm.name Java HotSpot(TM) 64-Bit Server VM
|
||||
java.specification.version 1.8
|
||||
$ sysprop | grep java | wc -l
|
||||
36
|
||||
</pre></div>
|
||||
36</pre></div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="section" id="">
|
||||
<span id="id3"></span><h2>启动自检<a class="headerlink" href="#" title="永久链接至标题">¶</a></h2>
|
||||
<div class="section" id="id3">
|
||||
<h2>启动自检<a class="headerlink" href="#id3" title="永久链接至标题">¶</a></h2>
|
||||
<p>针对启动时经常出现的权限问题,在启动脚本中增加了自检逻辑,脚本会自动判断目标进程是否具备attach权限,并给出进一步的提示。</p>
|
||||
<div class="highlight-default notranslate"><pre class="literal-block">[huxing.zhx@v125056161.bja /home/huxing.zhx]
|
||||
$./as.sh 32260
|
||||
@@ -211,18 +215,17 @@ To solve this, choose one of the following command:
|
||||
</div>
|
||||
</div>
|
||||
<div class="section" id="groovy">
|
||||
<span id="groovy"></span><h2>去groovy依赖<a class="headerlink" href="#groovy" title="永久链接至标题">¶</a></h2>
|
||||
<h2>去groovy依赖<a class="headerlink" href="#groovy" title="永久链接至标题">¶</a></h2>
|
||||
<p>groovy表达式在arthas2.0中大量使用,例如watch表达式</p>
|
||||
<div class="highlight-bash notranslate"><div class="highlight hljs"><pre class="bash">watch com.alibaba.sample.petstore.web.store.module.screen.ItemList add "params + ' ' + returnObj" params.size()==2
|
||||
</pre></div>
|
||||
<div class="highlight-bash notranslate"><div class="highlight hljs"><pre class="bash">watch com.alibaba.sample.petstore.web.store.module.screen.ItemList add "params + ' ' + returnObj" params.size()==2</pre></div>
|
||||
</div>
|
||||
<p>其中<tt class="docutils literal">"params + ' ' + returnObj"</tt>以及<tt class="docutils literal">params.size()==2</tt>背后其实都使用了groovy来进行表达式求值,如果反复大量的运行这些表达式,groovy会创建大量的classloader,打满perm区从而触发FGC。</p>
|
||||
<p>其中<code class="docutils literal notranslate"><span class="pre">"params</span> <span class="pre">+</span> <span class="pre">'</span> <span class="pre">'</span> <span class="pre">+</span> <span class="pre">returnObj"</span></code>以及<code class="docutils literal notranslate"><span class="pre">params.size()==2</span></code>背后其实都使用了groovy来进行表达式求值,如果反复大量的运行这些表达式,groovy会创建大量的classloader,打满perm区从而触发FGC。</p>
|
||||
<p>为了避免这个问题,Arthas 3.0中使用了ognl这个更加轻量的表达式求值库来代替groovy,彻底解决了groovy引起的FGC风险。但由于这个替换,导致原来使用groovy脚本编写的自定义脚本失效。这个问题留待后续解决。</p>
|
||||
<p>在3.0中,watch命令的表达式部分的书写有了一些改变,详见<a class="reference external" href="https://alibaba.github.io/arthas/watch">这里</a></p>
|
||||
</div>
|
||||
<div class="section" id="rt">
|
||||
<span id="rt"></span><h2>提升rt统计精度<a class="headerlink" href="#rt" title="永久链接至标题">¶</a></h2>
|
||||
<p>Arthas 2.0中,统计rt都是以<tt class="docutils literal">ms</tt>为单位,对于某些比较小的方法调用,耗时在毫秒以下的都会被认为是0ms,造成trace总时间和各方法的时间相加不一致等问题(虽然这里面确实会有误差,主要Arthas自身的开销)。Arthas 3.0中所有rt的单位统一改为使用<tt class="docutils literal">ns</tt>来统计,精准捕获你的方法耗时,让0ms这样无意义的统计数据不再出现!</p>
|
||||
<h2>提升rt统计精度<a class="headerlink" href="#rt" title="永久链接至标题">¶</a></h2>
|
||||
<p>Arthas 2.0中,统计rt都是以<code class="docutils literal notranslate"><span class="pre">ms</span></code>为单位,对于某些比较小的方法调用,耗时在毫秒以下的都会被认为是0ms,造成trace总时间和各方法的时间相加不一致等问题(虽然这里面确实会有误差,主要Arthas自身的开销)。Arthas 3.0中所有rt的单位统一改为使用<code class="docutils literal notranslate"><span class="pre">ns</span></code>来统计,精准捕获你的方法耗时,让0ms这样无意义的统计数据不再出现!</p>
|
||||
<div class="highlight-default notranslate"><pre class="literal-block">$ tt -l
|
||||
INDEX TIMESTAMP COST(ms) IS-RET IS-EXP OBJECT CLASS METHOD
|
||||
------------------------------------------------------------------------------------------------------------------------------------------------------------
|
||||
@@ -235,8 +238,8 @@ To solve this, choose one of the following command:
|
||||
</div>
|
||||
</div>
|
||||
<div class="section" id="watch-stack-trace">
|
||||
<span id="watch-stack-trace"></span><h2>watch/stack/trace命令支持按耗时过滤<a class="headerlink" href="#watch-stack-trace" title="永久链接至标题">¶</a></h2>
|
||||
<p>我们在trace的时候,经常会出现某个方法间隙性的rt飙高,但是我们只想知道rt高的时候,是哪里慢了,对于正常rt的方法我们并不关心,Arthas 3.0支持了按<tt class="docutils literal">#cost</tt>(方法执行耗时,单位为<tt class="docutils literal">ms</tt>)进行过滤,只输出符合条件的trace路径。</p>
|
||||
<h2>watch/stack/trace命令支持按耗时过滤<a class="headerlink" href="#watch-stack-trace" title="永久链接至标题">¶</a></h2>
|
||||
<p>我们在trace的时候,经常会出现某个方法间隙性的rt飙高,但是我们只想知道rt高的时候,是哪里慢了,对于正常rt的方法我们并不关心,Arthas 3.0支持了按<code class="docutils literal notranslate"><span class="pre">#cost</span></code>(方法执行耗时,单位为<code class="docutils literal notranslate"><span class="pre">ms</span></code>)进行过滤,只输出符合条件的trace路径。</p>
|
||||
<p>具体用法为:</p>
|
||||
<div class="highlight-default notranslate"><pre class="literal-block">trace/watch/stack class_name method cost_expression</pre>
|
||||
</div>
|
||||
@@ -265,29 +268,29 @@ trace test.arthas.TestTraceServlet doGet #cost>800
|
||||
+---[0.018255ms] java.lang.StringBuilder:toString()
|
||||
`---[0.028812ms] java.io.PrintWriter:write()</pre>
|
||||
</div>
|
||||
<p>上述命令只有当<tt class="docutils literal">test.arthas.TestTraceServlet#doGet</tt>方法执行耗时大于800ms时才会输出。</p>
|
||||
<p>上述命令只有当<code class="docutils literal notranslate"><span class="pre">test.arthas.TestTraceServlet#doGet</span></code>方法执行耗时大于800ms时才会输出。</p>
|
||||
</div>
|
||||
<div class="section" id="trace">
|
||||
<span id="trace"></span><h2>trace命令优化<a class="headerlink" href="#trace" title="永久链接至标题">¶</a></h2>
|
||||
<div class="section" id="">
|
||||
<span id="id4"></span><h3>自动高亮显示最耗时方法调用<a class="headerlink" href="#" title="永久链接至标题">¶</a></h3>
|
||||
<h2>trace命令优化<a class="headerlink" href="#trace" title="永久链接至标题">¶</a></h2>
|
||||
<div class="section" id="id4">
|
||||
<h3>自动高亮显示最耗时方法调用<a class="headerlink" href="#id4" title="永久链接至标题">¶</a></h3>
|
||||
<p>trace命令现在会自动显示</p>
|
||||
<p><img alt="image" src="arthas_3_0/TODO/image.png" /></p>
|
||||
<p><img alt="arthas_3_0/TODO/image.png" src="arthas_3_0/TODO/image.png" />image</p>
|
||||
</div>
|
||||
<div class="section" id="trace">
|
||||
<span id="id5"></span><h3>带条件过滤的多级trace<a class="headerlink" href="#trace" title="永久链接至标题">¶</a></h3>
|
||||
<div class="section" id="id5">
|
||||
<h3>带条件过滤的多级trace<a class="headerlink" href="#id5" title="永久链接至标题">¶</a></h3>
|
||||
<p>目前trace默认只输出一级方法调用耗时,有时候并不能完全看出问题。但是如果展开多级的话,每一个方法的耗时都统计,会造成方法数量迅速膨胀,大大增加trace的开销。</p>
|
||||
<p>TODO</p>
|
||||
</div>
|
||||
<div class="section" id="eagleeyetraceid">
|
||||
<span id="eagleeyetraceid"></span><h3>显示当前线程的信息及eagleeye的traceId<a class="headerlink" href="#eagleeyetraceid" title="永久链接至标题">¶</a></h3>
|
||||
<h3>显示当前线程的信息及eagleeye的traceId<a class="headerlink" href="#eagleeyetraceid" title="永久链接至标题">¶</a></h3>
|
||||
<div class="highlight-default notranslate"><pre class="literal-block">trace test.arthas.TestTraceServlet doGet
|
||||
`---thread_name=http-bio-8080-exec-10;id=da;is_daemon=true;priority=5;TCCL=org.apache.catalina.loader.WebappClassLoader;trace_id=1e09489014879085429791006d969d</pre>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="section" id="syspropsystemproperty">
|
||||
<span id="syspropsystemproperty"></span><h2>sysprop命令操作SystemProperty<a class="headerlink" href="#syspropsystemproperty" title="永久链接至标题">¶</a></h2>
|
||||
<h2>sysprop命令操作SystemProperty<a class="headerlink" href="#syspropsystemproperty" title="永久链接至标题">¶</a></h2>
|
||||
<p>sysprop命令支持查看所有的系统属性,以及针对特定属性进行查看和修改。</p>
|
||||
<div class="highlight-default notranslate"><pre class="literal-block">$ sysprop
|
||||
...
|
||||
@@ -313,8 +316,8 @@ production.mode=true</pre>
|
||||
</div>
|
||||
</div>
|
||||
<div class="section" id="thread">
|
||||
<span id="thread"></span><h2>thread命令支持指定采样时间<a class="headerlink" href="#thread" title="永久链接至标题">¶</a></h2>
|
||||
<p>thread命令计算线程cpu占用的逻辑,默认是采样100ms内各个线程的cpu使用情况并计算cpu消耗占比。有时候100ms的时间间隔太短,看不出问题所在,Arthas3.0中thread命令支持设置采样间隔(以<tt class="docutils literal">ms</tt>为单位),可以观察任意时间段内的cpu消耗占比情况。</p>
|
||||
<h2>thread命令支持指定采样时间<a class="headerlink" href="#thread" title="永久链接至标题">¶</a></h2>
|
||||
<p>thread命令计算线程cpu占用的逻辑,默认是采样100ms内各个线程的cpu使用情况并计算cpu消耗占比。有时候100ms的时间间隔太短,看不出问题所在,Arthas3.0中thread命令支持设置采样间隔(以<code class="docutils literal notranslate"><span class="pre">ms</span></code>为单位),可以观察任意时间段内的cpu消耗占比情况。</p>
|
||||
<div class="highlight-default notranslate"><pre class="literal-block">$ thread -i 1000
|
||||
Threads Total: 74, NEW: 0, RUNNABLE: 17, BLOCKED: 0, WAITING: 15, TIMED_WAITING: 42, TERMINATED: 0
|
||||
ID NAME GROUP PRIORITY STATE %CPU TIME INTERRUPTED DAEMON
|
||||
@@ -347,7 +350,7 @@ ID NAME GROU
|
||||
|
||||
<div role="contentinfo">
|
||||
<p>
|
||||
© Copyright 2018-2019, Alibaba Middleware Group, and contributors.
|
||||
© Copyright 2018-2019, Alibaba Middleware Group, and contributors
|
||||
|
||||
</p>
|
||||
</div>
|
||||
@@ -364,34 +367,16 @@ ID NAME GROU
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'../',
|
||||
VERSION:'3.1.1',
|
||||
LANGUAGE:'zh_CN',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'.html',
|
||||
HAS_SOURCE: true,
|
||||
SOURCELINK_SUFFIX: '.txt'
|
||||
};
|
||||
</script>
|
||||
<script type="text/javascript" src="../_static/jquery.js"></script>
|
||||
<script type="text/javascript" src="../_static/underscore.js"></script>
|
||||
<script type="text/javascript" src="../_static/doctools.js"></script>
|
||||
<script type="text/javascript" src="../_static/translations.js"></script>
|
||||
<script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript" src="../_static/js/theme.js"></script>
|
||||
|
||||
<script type="text/javascript">
|
||||
jQuery(function () {
|
||||
SphinxRtdTheme.Navigation.enable(true);
|
||||
});
|
||||
</script>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<div class="github-fork-ribbon-wrapper right">
|
||||
<div class="github-fork-ribbon">
|
||||
<a href="https://github.com/alibaba/arthas" target="_blank">Fork me at GitHub</a>
|
||||
|
||||
Reference in new issue
Block a user