<!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 > 快速入门 — Arthas 3.0.1-RC-SNAPSHOT 文档< / title >
< 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 = "进阶使用" href = "advanced-use.html" / >
< link rel = "prev" title = "Arthas Install" href = "install-detail.html" / >
< script src = "_static/center_page.js" > < / script >
< 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.1-RC-SNAPSHOT
< / 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 internal" href = "install-detail.html" > 安装< / a > < / li >
< li class = "toctree-l1 current" > < a class = "current reference internal" href = "#" > 快速入门< / a > < ul >
< li class = "toctree-l2" > < a class = "reference internal" href = "#demo" > 1. 启动Demo< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "#arthas" > 2. 启动arthas< / a > < ul >
< li class = "toctree-l3" > < a class = "reference internal" href = "#linux-unix-mac" > Linux/Unix/Mac< / a > < / li >
< li class = "toctree-l3" > < a class = "reference internal" href = "#windows" > Windows< / a > < / li >
< / ul >
< / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "#dashboard" > 3. 查看dashboard< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "#watch" > 4. watch< / a > < / li >
< / ul >
< / 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 external" href = "https://github.com/alibaba/arthas/labels/user-case" > 用户案例< / 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/labels/question-answered" > Questions and answers< / 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 >
< / 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 > 快速入门< / li >
< li class = "wy-breadcrumbs-aside" >
< a href = "https://github.com/alibaba/arthas/blob/master/site/src/site/sphinx/quick-start.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 = "" >
< span id = "id1" > < / span > < h1 > 快速入门< a class = "headerlink" href = "#" title = "永久链接至标题" > ¶< / a > < / h1 >
< div class = "section" id = "demo" >
< span id = "demo" > < / span > < h2 > 1. 启动Demo< a class = "headerlink" href = "#demo" title = "永久链接至标题" > ¶< / a > < / h2 >
< div class = "highlight-java notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "kn" > import< / span > < span class = "nn" > java.util.concurrent.TimeUnit< / span > < span class = "o" > ;< / span >
< span class = "kn" > import< / span > < span class = "nn" > java.util.concurrent.atomic.AtomicInteger< / span > < span class = "o" > ;< / span >
< span class = "kd" > public< / span > < span class = "kd" > class< / span > < span class = "nc" > Demo< / span > < span class = "o" > {< / span >
< span class = "kd" > static< / span > < span class = "kd" > class< / span > < span class = "nc" > Counter< / span > < span class = "o" > {< / span >
< span class = "kd" > private< / span > < span class = "kd" > static< / span > < span class = "n" > AtomicInteger< / span > < span class = "n" > count< / span > < span class = "o" > =< / span > < span class = "k" > new< / span > < span class = "n" > AtomicInteger< / span > < span class = "o" > (< / span > < span class = "mi" > 0< / span > < span class = "o" > );< / span >
< span class = "kd" > public< / span > < span class = "kd" > static< / span > < span class = "kt" > void< / span > < span class = "nf" > increment< / span > < span class = "o" > ()< / span > < span class = "o" > {< / span >
< span class = "n" > count< / span > < span class = "o" > .< / span > < span class = "na" > incrementAndGet< / span > < span class = "o" > ();< / span >
< span class = "o" > }< / span >
< span class = "kd" > public< / span > < span class = "kd" > static< / span > < span class = "kt" > int< / span > < span class = "nf" > value< / span > < span class = "o" > ()< / span > < span class = "o" > {< / span >
< span class = "k" > return< / span > < span class = "n" > count< / span > < span class = "o" > .< / span > < span class = "na" > get< / span > < span class = "o" > ();< / span >
< span class = "o" > }< / span >
< span class = "o" > }< / span >
< span class = "kd" > public< / span > < span class = "kd" > static< / span > < span class = "kt" > void< / span > < span class = "nf" > main< / span > < span class = "o" > (< / span > < span class = "n" > String< / span > < span class = "o" > []< / span > < span class = "n" > args< / span > < span class = "o" > )< / span > < span class = "kd" > throws< / span > < span class = "n" > InterruptedException< / span > < span class = "o" > {< / span >
< span class = "k" > while< / span > < span class = "o" > (< / span > < span class = "kc" > true< / span > < span class = "o" > )< / span > < span class = "o" > {< / span >
< span class = "n" > Counter< / span > < span class = "o" > .< / span > < span class = "na" > increment< / span > < span class = "o" > ();< / span >
< span class = "n" > System< / span > < span class = "o" > .< / span > < span class = "na" > out< / span > < span class = "o" > .< / span > < span class = "na" > println< / span > < span class = "o" > (< / span > < span class = "s" > " counter: " < / span > < span class = "o" > +< / span > < span class = "n" > Counter< / span > < span class = "o" > .< / span > < span class = "na" > value< / span > < span class = "o" > ());< / span >
< span class = "n" > TimeUnit< / span > < span class = "o" > .< / span > < span class = "na" > SECONDS< / span > < span class = "o" > .< / span > < span class = "na" > sleep< / span > < span class = "o" > (< / span > < span class = "mi" > 1< / span > < span class = "o" > );< / span >
< span class = "o" > }< / span >
< span class = "o" > }< / span >
< span class = "o" > }< / span >
< / pre > < / div >
< / div >
< p > 把上面的内容保存到< code class = "docutils literal notranslate" > < span class = "pre" > Demo.java< / span > < / code > 里,然后在命令行下编绎启动:< / p >
< div class = "highlight-bash notranslate" > < div class = "highlight" > < pre > < span > < / span > javac Demo.java
java Demo
< / pre > < / div >
< / div >
< p > 也可以把代码保存到IDE里, 然后启动。< / p >
< / div >
< div class = "section" id = "arthas" >
< span id = "arthas" > < / span > < h2 > 2. 启动arthas< a class = "headerlink" href = "#arthas" title = "永久链接至标题" > ¶< / a > < / h2 >
< div class = "section" id = "linux-unix-mac" >
< span id = "linux-unix-mac" > < / span > < h3 > Linux/Unix/Mac< a class = "headerlink" href = "#linux-unix-mac" title = "永久链接至标题" > ¶< / a > < / h3 >
< p > 在命令行下面执行:< / p >
< div class = "highlight-bash notranslate" > < div class = "highlight" > < pre > < span > < / span > ./as.sh
< / pre > < / div >
< / div >
< blockquote >
< div > 执行该脚本的用户需要和目标进程具有相同的权限。比如以< code class = "docutils literal notranslate" > < span class = "pre" > admin< / span > < / code > 用户来执行:
< code class = "docutils literal notranslate" > < span class = "pre" > sudo< / span > < span class = "pre" > su< / span > < span class = "pre" > admin< / span > < span class = "pre" > & & < / span > < span class = "pre" > ./as.sh< / span > < / code > 或 < code class = "docutils literal notranslate" > < span class = "pre" > sudo< / span > < span class = "pre" > -u< / span > < span class = "pre" > admin< / span > < span class = "pre" > -EH< / span > < span class = "pre" > ./as.sh< / span > < / code > 。
详细的启动脚本说明,请参考< a class = "reference internal" href = "start-arthas.html" > < span class = "doc" > 这里< / span > < / a > 。
如果attatch不上目标进程, 可以查看< code class = "docutils literal notranslate" > < span class = "pre" > ~/logs/arthas/< / span > < / code > 目录下的日志。< / div > < / blockquote >
< p > 选择应用java进程: < / p >
< div class = "highlight-default notranslate" > < div class = "highlight" > < pre > < span > < / span > $ ./as.sh
Arthas script version: 3.0.2
Found existing java process, please choose one and hit RETURN.
* [1]: 95428
[2]: 22647 org.jetbrains.jps.cmdline.Launcher
[3]: 21736
[4]: 13560 Demo
< / pre > < / div >
< / div >
< p > Demo进程是第4个, 则输入4, 再输入回车/enter。Arthas会attach到目标进程上, 并输出日志: < / p >
< div class = "highlight-default notranslate" > < div class = "highlight" > < pre > < span > < / span > Connecting to arthas server... current timestamp is 1536656867
Trying 127.0.0.1...
Connected to 127.0.0.1.
Escape character is ' ^]' .
,---. ,------. ,--------.,--. ,--. ,---. ,---.
/ O \ | .--. ' ' --. .--' | ' --' | / O \ ' .-'
| .-. || ' --' .' | | | .--. || .-. |`. `-.
| | | || |\ \ | | | | | || | | |.-' |
`--' `--' `--' ' --' `--' `--' `--' `--' `--' `-----'
wiki: https://alibaba.github.io/arthas
version: 3.0.1-RC-SNAPSHOT
pid: 13560
timestamp: 1536656867894
< / pre > < / div >
< / div >
< / div >
< div class = "section" id = "windows" >
< span id = "windows" > < / span > < h3 > Windows< a class = "headerlink" href = "#windows" title = "永久链接至标题" > ¶< / a > < / h3 >
< p > 打开Dos命令行窗口, 在解压的arthas目录下执行< code class = "docutils literal notranslate" > < span class = "pre" > as.bat< / span > < / code > 。< / p >
< / div >
< / div >
< div class = "section" id = "dashboard" >
< span id = "dashboard" > < / span > < h2 > 3. 查看dashboard< a class = "headerlink" href = "#dashboard" title = "永久链接至标题" > ¶< / a > < / h2 >
< p > 输入< a class = "reference internal" href = "dashboard.html" > < span class = "doc" > dashboard< / span > < / a > , 按enter/回车,会展示当前进程的信息,按< code class = "docutils literal notranslate" > < span class = "pre" > ctrl+c< / span > < / code > 可以中断执行。< / p >
< div class = "highlight-default notranslate" > < div class = "highlight" > < pre > < span > < / span > $ dashboard
ID NAME GROUP PRIORI STATE %CPU TIME INTERRU DAEMON
17 pool-2-thread-1 system 5 WAITIN 67 0:0 false false
27 Timer-for-arthas-dashb system 10 RUNNAB 32 0:0 false true
11 AsyncAppender-Worker-a system 9 WAITIN 0 0:0 false true
9 Attach Listener system 9 RUNNAB 0 0:0 false true
3 Finalizer system 8 WAITIN 0 0:0 false true
2 Reference Handler system 10 WAITIN 0 0:0 false true
4 Signal Dispatcher system 9 RUNNAB 0 0:0 false true
26 as-command-execute-dae system 10 TIMED_ 0 0:0 false true
13 job-timeout system 9 TIMED_ 0 0:0 false true
1 main main 5 TIMED_ 0 0:0 false false
14 nioEventLoopGroup-2-1 system 10 RUNNAB 0 0:0 false false
18 nioEventLoopGroup-2-2 system 10 RUNNAB 0 0:0 false false
23 nioEventLoopGroup-2-3 system 10 RUNNAB 0 0:0 false false
15 nioEventLoopGroup-3-1 system 10 RUNNAB 0 0:0 false false
Memory used total max usage GC
heap 32M 155M 1820M 1.77% gc.ps_scavenge.count 4
ps_eden_space 14M 65M 672M 2.21% gc.ps_scavenge.time(m 166
ps_survivor_space 4M 5M 5M s)
ps_old_gen 12M 85M 1365M 0.91% gc.ps_marksweep.count 0
nonheap 20M 23M -1 gc.ps_marksweep.time( 0
code_cache 3M 5M 240M 1.32% ms)
Runtime
os.name Mac OS X
os.version 10.13.4
java.version 1.8.0_162
java.home /Library/Java/JavaVir
tualMachines/jdk1.8.0
_162.jdk/Contents/Hom
e/jre
< / pre > < / div >
< / div >
< / div >
< div class = "section" id = "watch" >
< span id = "watch" > < / span > < h2 > 4. watch< a class = "headerlink" href = "#watch" title = "永久链接至标题" > ¶< / a > < / h2 >
< p > 通过< a class = "reference internal" href = "watch.html" > < span class = "doc" > watch< / span > < / a > 命令来查看< code class = "docutils literal notranslate" > < span class = "pre" > Counter.value()< / span > < / code > 函数的返回值:< / p >
< div class = "highlight-default notranslate" > < div class = "highlight" > < pre > < span > < / span > $ watch Demo$Counter value returnObj
Press Ctrl+C to abort.
Affect(class-cnt:1 , method-cnt:1) cost in 29 ms.
ts=2018-09-10 17:53:11;result=@Integer[621]
ts=2018-09-10 17:53:12;result=@Integer[622]
ts=2018-09-10 17:53:13;result=@Integer[623]
ts=2018-09-10 17:53:14;result=@Integer[624]
ts=2018-09-10 17:53:15;result=@Integer[625]
< / pre > < / div >
< / div >
< p > 更多的功能可以查看< a class = "reference internal" href = "advanced-use.html" > < span class = "doc" > 进阶使用< / span > < / a > 。< / p >
< / div >
< / div >
< / div >
< / div >
< footer >
< div class = "rst-footer-buttons" role = "navigation" aria-label = "footer navigation" >
< a href = "advanced-use.html" class = "btn btn-neutral float-right" title = "进阶使用" accesskey = "n" rel = "next" > Next < span class = "fa fa-arrow-circle-right" > < / span > < / a >
< a href = "install-detail.html" class = "btn btn-neutral" title = "Arthas Install" 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.1-RC-SNAPSHOT',
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 >
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 >