<!DOCTYPE html>
<!-- [if IE 8]><html class="no - js lt - ie9" lang="zh - CN" > <![endif] -->
<!-- [if gt IE 8]><! --> < html class = "no-js" lang = "zh-CN" > <!-- <![endif] -->
< head >
< meta charset = "utf-8" >
< meta name = "viewport" content = "width=device-width, initial-scale=1.0" >
< title > trace — Arthas 3.0.5 文档< / title >
< link rel = "shortcut icon" href = "_static/favicon.ico" / >
< 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" / >
< link rel = "index" title = "索引" href = "genindex.html" / >
< link rel = "search" title = "搜索" href = "search.html" / >
< link rel = "next" title = "stack" href = "stack.html" / >
< link rel = "prev" title = "watch" href = "watch.html" / >
< script src = "_static/center_page.js" > < / script >
< 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" >
< a href = "index.html" class = "icon icon-home" > Arthas
< / a >
< div class = "version" >
3.0.5
< / div >
< div role = "search" >
< form id = "rtd-search-form" class = "wy-form" action = "search.html" method = "get" >
< input type = "text" name = "q" placeholder = "Search docs" / >
< input type = "hidden" name = "check_keywords" value = "yes" / >
< input type = "hidden" name = "area" value = "default" / >
< / form >
< / div >
< / div >
< div class = "wy-menu wy-menu-vertical" data-spy = "affix" role = "navigation" aria-label = "main navigation" >
< ul class = "current" >
< 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 internal" href = "install-detail.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 current" > < a class = "reference internal" href = "commands.html" > 命令列表< / a > < ul class = "current" >
< li class = "toctree-l2" > < a class = "reference internal" href = "dashboard.html" > dashboard< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "thread.html" > thread< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "jvm.html" > jvm< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "sysprop.html" > sysprop< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "sysenv.html" > sysenv< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "getstatic.html" > getstatic< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "ognl.html" > ognl< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "sc.html" > sc< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "sm.html" > sm< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "dump.html" > dump< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "jad.html" > jad< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "classloader.html" > classloader< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "redefine.html" > redefine< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "monitor.html" > monitor< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "watch.html" > watch< / a > < / li >
< li class = "toctree-l2 current" > < a class = "current reference internal" href = "#" > trace< / a > < ul >
< li class = "toctree-l3" > < a class = "reference internal" href = "#" > 参数说明< / a > < / li >
< li class = "toctree-l3" > < a class = "reference internal" href = "#" > 注意事项< / a > < / li >
< li class = "toctree-l3" > < a class = "reference internal" href = "#" > 使用参考< / a > < ul >
< li class = "toctree-l4" > < a class = "reference internal" href = "#demo" > 启动 Demo< / a > < / li >
< li class = "toctree-l4" > < a class = "reference internal" href = "#trace" > trace函数< / a > < / li >
< li class = "toctree-l4" > < a class = "reference internal" href = "#jdk" > 过滤掉jdk的函数< / a > < / li >
< li class = "toctree-l4" > < a class = "reference internal" href = "#" > 据调用耗时过滤< / a > < / li >
< / ul >
< / li >
< / ul >
< / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "stack.html" > stack< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "tt.html" > tt< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "options.html" > options< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "commands.html#arthas" > Arthas 基础命令< / a > < / li >
< / ul >
< / 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 internal" href = "contact-us.html" > QQ群/钉钉群< / a > < / li >
< / ul >
< / div >
< / div >
< / nav >
< section data-toggle = "wy-nav-shift" class = "wy-nav-content-wrap" >
< nav class = "wy-nav-top" aria-label = "top navigation" >
< i data-toggle = "wy-nav-top" class = "fa fa-bars" > < / i >
< a href = "index.html" > Arthas< / a >
< / nav >
< div class = "wy-nav-content" >
< div class = "rst-content" >
< div role = "navigation" aria-label = "breadcrumbs navigation" >
< ul class = "wy-breadcrumbs" >
< li > < a href = "index.html" > Docs< / a > » < / li >
< li > < a href = "commands.html" > 命令列表< / a > » < / li >
< li > trace< / li >
< li class = "wy-breadcrumbs-aside" >
< a href = "https://github.com/alibaba/arthas/blob/master/site/src/site/sphinx/trace.md" class = "fa fa-github" > Edit on GitHub< / a >
< / li >
< / ul >
< hr / >
< / div >
< div role = "main" class = "document" itemscope = "itemscope" itemtype = "http://schema.org/Article" >
< div itemprop = "articleBody" >
< div class = "section" id = "trace" >
< span id = "trace" > < / span > < h1 > trace< a class = "headerlink" href = "#trace" title = "永久链接至标题" > ¶< / a > < / h1 >
< blockquote >
< div > 方法内部调用路径，并输出方法路径上的每个节点上耗时< / div > < / blockquote >
< p > < tt class = "docutils literal" > trace< / tt > 命令能主动搜索 < tt class = "docutils literal" > class-pattern< / tt > ／ < tt class = "docutils literal" > method-pattern< / tt > 对应的方法调用路径，渲染和统计整个调用链路上的所有性能开销和追踪调用链路。< / p >
< div class = "section" id = "" >
< span id = "id1" > < / span > < h2 > 参数说明< a class = "headerlink" href = "#" title = "永久链接至标题" > ¶< / a > < / h2 >
< table border = "1" class = "docutils" >
< thead >
< tr >
< th align = "right" > 参数名称< / th >
< th align = "left" > 参数说明< / th >
< / tr >
< / thead >
< tbody >
< tr >
< td align = "right" > < em > class-pattern< / em > < / td >
< td align = "left" > 类名表达式匹配< / td >
< / tr >
< tr >
< td align = "right" > < em > method-pattern< / em > < / td >
< td align = "left" > 方法名表达式匹配< / td >
< / tr >
< tr >
< td align = "right" > < em > condition-express< / em > < / td >
< td align = "left" > 条件表达式< / td >
< / tr >
< tr >
< td align = "right" > [E]< / td >
< td align = "left" > 开启正则表达式匹配，默认为通配符匹配< / td >
< / tr >
< tr >
< td align = "right" > < code > [n:]< / code > < / td >
< td align = "left" > 命令执行次数< / td >
< / tr >
< tr >
< td align = "right" > < code > #cost< / code > < / td >
< td align = "left" > 方法执行耗时< / td >
< / tr >
< / tbody >
< / table > < p > 这里重点要说明的是观察表达式，观察表达式的构成主要由 < tt class = "docutils literal" > "{params,returnObj}"< / tt > ，只要是一个合法的 ognl 表达式，都能被正常支持。< / p >
< p > 观察的维度也比较多，主要体现在参数 < tt class = "docutils literal" > advice< / tt > 的数据结构上。< tt class = "docutils literal" > Advice< / tt > 参数最主要是封装了通知节点的所有信息。< / p >
< p > 请参考< a class = "reference internal" href = "advice-class.html" > < span class = "doc" > 表达式核心变量< / span > < / a > 中关于该节点的描述。< / p >
< ul class = "simple" >
< li > 特殊用法请参考：< a class = "reference external" href = "https://github.com/alibaba/arthas/issues/71" > https://github.com/alibaba/arthas/issues/71< / a > < / li >
< li > OGNL表达式官网： < a class = "reference external" href = "https://commons.apache.org/proper/commons-ognl/language-guide.html" > https://commons.apache.org/proper/commons-ognl/language-guide.html< / a > < / li >
< / ul >
< p > 很多时候我们只想看到某个方法的rt大于某个时间之后的trace结果， ， < tt class = "docutils literal" > trace *StringUtils isBlank '#cost>100'< / tt > 表示当执行时间超过100ms的时候， < / p >
< blockquote >
< div > watch/stack/trace这个三个命令都支持< tt class = "docutils literal" > #cost< / tt > < / div > < / blockquote >
< / div >
< div class = "section" id = "" >
< span id = "id2" > < / span > < h2 > 注意事项< a class = "headerlink" href = "#" title = "永久链接至标题" > ¶< / a > < / h2 >
< p > < tt class = "docutils literal" > trace< / tt > 能方便的帮助你定位和发现因 RT 高而导致的性能问题缺陷，但其每次只能跟踪一级方法的调用链路。< / p >
< / div >
< div class = "section" id = "" >
< span id = "id3" > < / span > < h2 > 使用参考< a class = "headerlink" href = "#" title = "永久链接至标题" > ¶< / a > < / h2 >
< div class = "section" id = "demo" >
< span id = "demo" > < / span > < h3 > 启动 Demo< a class = "headerlink" href = "#demo" title = "永久链接至标题" > ¶< / a > < / h3 >
< p > 启动< a class = "reference internal" href = "quick-start.html" > < span class = "doc" > 快速入门< / span > < / a > 里的< tt class = "docutils literal" > arthas-demo< / tt > 。< / p >
< / div >
< div class = "section" id = "trace" >
< span id = "id4" > < / span > < h3 > trace函数< a class = "headerlink" href = "#trace" title = "永久链接至标题" > ¶< / a > < / h3 >
< div class = "highlight-bash notranslate" > < div class = "highlight hljs" > < pre class = "bash" > $ trace demo.MathGame run
Press Ctrl+C to abort.
Affect(class-cnt:1 , method-cnt:1) cost in 42 ms.
`---ts=2018-12-04 00:44:17;thread_name=main;id=1;is_daemon=false;priority=5;TCCL=sun.misc.Launcher$AppClassLoader@3d4eac69
`---[10.611029ms] demo.MathGame:run()
+---[0.05638ms] java.util.Random:nextInt()
+---[10.036885ms] demo.MathGame:primeFactors()
`---[0.170316ms] demo.MathGame:print()
< / pre > < / div >
< / div >
< / div >
< div class = "section" id = "jdk" >
< span id = "jdk" > < / span > < h3 > 过滤掉jdk的函数< a class = "headerlink" href = "#jdk" title = "永久链接至标题" > ¶< / a > < / h3 >
< div class = "highlight-bash notranslate" > < div class = "highlight hljs" > < pre class = "bash" > $ trace -j demo.MathGame run
Press Ctrl+C to abort.
Affect(class-cnt:1 , method-cnt:1) cost in 31 ms.
`---ts=2018-12-04 01:09:14;thread_name=main;id=1;is_daemon=false;priority=5;TCCL=sun.misc.Launcher$AppClassLoader@3d4eac69
`---[5.190646ms] demo.MathGame:run()
+---[4.465779ms] demo.MathGame:primeFactors()
`---[0.375324ms] demo.MathGame:print()
< / pre > < / div >
< / div >
< ul class = "simple" >
< li > < tt class = "docutils literal" > -j< / tt > : jdkMethodSkip, skip jdk method trace< / li >
< / ul >
< / div >
< div class = "section" id = "" >
< span id = "id5" > < / span > < h3 > 据调用耗时过滤< a class = "headerlink" href = "#" title = "永久链接至标题" > ¶< / a > < / h3 >
< div class = "highlight-bash notranslate" > < div class = "highlight hljs" > < pre class = "bash" > $ trace demo.MathGame run ' #cost > 10'
Press Ctrl+C to abort.
Affect(class-cnt:1 , method-cnt:1) cost in 41 ms.
`---ts=2018-12-04 01:12:02;thread_name=main;id=1;is_daemon=false;priority=5;TCCL=sun.misc.Launcher$AppClassLoader@3d4eac69
`---[12.033735ms] demo.MathGame:run()
+---[0.006783ms] java.util.Random:nextInt()
+---[11.852594ms] demo.MathGame:primeFactors()
`---[0.05447ms] demo.MathGame:print()
< / pre > < / div >
< / div >
< blockquote >
< div > 只会展示耗时大于4ms的调用路径， ， < / div > < / blockquote >
< ul class = "simple" >
< li > 是不是很眼熟，没错，在 JProfiler 等收费软件中你曾经见识类似的功能，这里你将可以通过命令就能打印出指定调用路径。 友情提醒下，< tt class = "docutils literal" > trace< / tt > 在执行的过程中本身是会有一定的性能开销，在统计的报告中并未像 JProfiler 一样预先减去其自身的统计开销。所以这统计出来有些许的不准，渲染路径上调用的类、方法越多，性能偏差越大。但还是能让你看清一些事情的。< / li >
< li > [12.033735ms] 的含义，< tt class = "docutils literal" > 12.033735< / tt > 的含义是：当前节点在当前步骤的耗时，单位为毫秒< / li >
< li > [0,0,0ms,11]xxx:yyy() [throws Exception]，对该方法中相同的方法调用进行了合并，< tt class = "docutils literal" > 0,0,0ms,11< / tt > 表示方法调用耗时，< tt class = "docutils literal" > min,max,total,count< / tt > ； < tt class = "docutils literal" > throws Exception< / tt > 表明该方法调用中存在异常返回< / li >
< li > 这里存在一个统计不准确的问题，就是所有方法耗时加起来可能会小于该监测方法的总耗时，这个是由于 Arthas 本身的逻辑会有一定的耗时< / li >
< / ul >
< / div >
< / div >
< / div >
< / div >
< / div >
< footer >
< div class = "rst-footer-buttons" role = "navigation" aria-label = "footer navigation" >
< a href = "stack.html" class = "btn btn-neutral float-right" title = "stack" accesskey = "n" rel = "next" > Next < span class = "fa fa-arrow-circle-right" > < / span > < / a >
< a href = "watch.html" class = "btn btn-neutral" title = "watch" accesskey = "p" rel = "prev" > < span class = "fa fa-arrow-circle-left" > < / span > Previous< / a >
< / div >
< hr / >
< div role = "contentinfo" >
< p >
© Copyright 2018, Alibaba Middleware Group, and contributors.
< / p >
< / div >
Built with < a href = "http://sphinx-doc.org/" > Sphinx< / a > using a < a href = "https://github.com/rtfd/sphinx_rtd_theme" > theme< / a > provided by < a href = "https://readthedocs.org" > Read the Docs< / a > .
< / footer >
< / div >
< / div >
< / section >
< / div >
< script type = "text/javascript" >
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'3.0.5',
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" > Fork me at GitHub< / a >
< / div >
< / div >
< script type = "text/javascript" src = "_static/add_badges.js" > < / script >
< script src = "https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.13.1/highlight.min.js" > < / script >
< script src = "https://cdnjs.cloudflare.com/ajax/libs/highlightjs-line-numbers.js/2.5.0/highlightjs-line-numbers.min.js" > < / script >
< script >
document.querySelectorAll('div.hljs > pre').forEach(function(block) {
hljs.highlightBlock(block);
hljs.lineNumbersBlock(block);
});
< / script >
< script >
var _hmt = _hmt || [];
(function() {
var hm = document.createElement("script");
hm.src = "https://hm.baidu.com/hm.js?d5c5e25b100f0eb51a4c35c8a86ea9b4";
var s = document.getElementsByTagName("script")[0];
s.parentNode.insertBefore(hm, s);
})();
< / script >
< / body >
< / html >
