<!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.3.4 文档< / title >
< link rel = "shortcut icon" href = "_static/favicon.ico" / >
< 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" / >
< 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 = "下载" href = "download.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" >
< / 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.3.4
< / 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://mp.weixin.qq.com/s/677GO-3kYx5ygG9rlOlfQg" > 招聘信息< / a > < / li >
< 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 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 > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "#dashboard" > 3. 查看dashboard< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "#threadarthas-demomain-class" > 4. 通过thread命令来获取到< code class = "docutils literal notranslate" > < span class = "pre" > arthas-demo< / span > < / code > 进程的Main Class< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "#jadmain-class" > 5. 通过jad来反编译Main Class< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "#watch" > 6. watch< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "#id2" > 7. 退出arthas< / 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 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 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 >
< li class = "toctree-l1" > < a class = "reference external" href = "https://arthas.gitee.io/" > 国内镜像站< / 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 = "id1" >
< h1 > 快速入门< a class = "headerlink" href = "#id1" title = "永久链接至标题" > ¶< / a > < / h1 >
< div class = "section" id = "demo" >
< h2 > 1. 启动Demo< a class = "headerlink" href = "#demo" title = "永久链接至标题" > ¶< / a > < / h2 >
< div class = "highlight-bash notranslate" > < div class = "highlight hljs" > < pre class = "bash" > curl -O https://alibaba.github.io/arthas/arthas-demo.jar
java -jar arthas-demo.jar< / pre > < / div >
< / div >
< p > < code class = "docutils literal notranslate" > < span class = "pre" > arthas-demo< / span > < / code > 是一个简单的程序,每隔一秒生成一个随机数,再执行质因数分解,并打印出分解结果。< / p >
< p > < code class = "docutils literal notranslate" > < span class = "pre" > arthas-demo< / span > < / code > 源代码:< a class = "reference external" href = "https://github.com/alibaba/arthas/blob/master/demo/src/main/java/demo/MathGame.java" > 查看< / a > < / p >
< / div >
< div class = "section" id = "arthas" >
< h2 > 2. 启动arthas< a class = "headerlink" href = "#arthas" title = "永久链接至标题" > ¶< / a > < / h2 >
< p > 在命令行下面执行( 使用和目标进程一致的用户启动, 否则可能attach失败) : < / p >
< div class = "highlight-bash notranslate" > < div class = "highlight hljs" > < pre class = "bash" > curl -O https://alibaba.github.io/arthas/arthas-boot.jar
java -jar arthas-boot.jar< / pre > < / div >
< / div >
< ul class = "simple" >
< li > < p > 执行该程序的用户需要和目标进程具有相同的权限。比如以< 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" > java< / span > < span class = "pre" > -jar< / span > < span class = "pre" > arthas-boot.jar< / 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" > java< / span > < span class = "pre" > -jar< / span > < span class = "pre" > arthas-boot.jar< / span > < / code > 。< / p > < / li >
< li > < p > 如果attach不上目标进程, 可以查看< code class = "docutils literal notranslate" > < span class = "pre" > ~/logs/arthas/< / span > < / code > 目录下的日志。< / p > < / li >
< li > < p > 如果下载速度比较慢, 可以使用aliyun的镜像: < code class = "docutils literal notranslate" > < span class = "pre" > java< / span > < span class = "pre" > -jar< / span > < span class = "pre" > arthas-boot.jar< / span > < span class = "pre" > --repo-mirror< / span > < span class = "pre" > aliyun< / span > < span class = "pre" > --use-http< / span > < / code > < / p > < / li >
< li > < p > < code class = "docutils literal notranslate" > < span class = "pre" > java< / span > < span class = "pre" > -jar< / span > < span class = "pre" > arthas-boot.jar< / span > < span class = "pre" > -h< / span > < / code > 打印更多参数信息。< / p > < / li >
< / ul >
< p > 选择应用java进程: < / p >
< div class = "highlight-bash notranslate" > < div class = "highlight hljs" > < pre class = "bash" > $ $ java -jar arthas-boot.jar
* [1]: 35542
[2]: 71560 arthas-demo.jar< / pre > < / div >
< / div >
< p > Demo进程是第2个, 则输入2, 再输入< code class = "docutils literal notranslate" > < span class = "pre" > 回车/enter< / span > < / code > 。Arthas会attach到目标进程上, 并输出日志: < / p >
< div class = "highlight-bash notranslate" > < div class = "highlight hljs" > < pre class = "bash" > [INFO] Try to attach process 71560
[INFO] Attach process 71560 success.
[INFO] arthas-client connect 127.0.0.1 3658
,---. ,------. ,--------.,--. ,--. ,---. ,---.
/ O \ | .--. ' ' --. .--' | ' --' | / O \ ' .-'
| .-. || ' --' .' | | | .--. || .-. |`. `-.
| | | || |\ \ | | | | | || | | |.-' |
`--' `--' `--' ' --' `--' `--' `--' `--' `--' `-----'
wiki: https://alibaba.github.io/arthas
version: 3.0.5.20181127201536
pid: 71560
time: 2018-11-28 19:16:24
$< / pre > < / div >
< / div >
< / div >
< div class = "section" id = "dashboard" >
< 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 > ,按< code class = "docutils literal notranslate" > < span class = "pre" > 回车/enter< / span > < / code > ,会展示当前进程的信息,按< code class = "docutils literal notranslate" > < span class = "pre" > ctrl+c< / span > < / code > 可以中断执行。< / p >
< div class = "highlight-bash notranslate" > < div class = "highlight hljs" > < pre class = "bash" > $ 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 = "threadarthas-demomain-class" >
< h2 > 4. 通过thread命令来获取到< code class = "docutils literal notranslate" > < span class = "pre" > arthas-demo< / span > < / code > 进程的Main Class< a class = "headerlink" href = "#threadarthas-demomain-class" title = "永久链接至标题" > ¶< / a > < / h2 >
< p > < code class = "docutils literal notranslate" > < span class = "pre" > thread< / span > < span class = "pre" > 1< / span > < / code > 会打印线程ID 1的栈, 通常是main函数的线程。< / p >
< div class = "highlight-bash notranslate" > < div class = "highlight hljs" > < pre class = "bash" > $ thread 1 | grep ' main('
at demo.MathGame.main(MathGame.java:17)< / pre > < / div >
< / div >
< / div >
< div class = "section" id = "jadmain-class" >
< h2 > 5. 通过jad来反编译Main Class< a class = "headerlink" href = "#jadmain-class" title = "永久链接至标题" > ¶< / a > < / h2 >
< div class = "highlight-java notranslate" > < div class = "highlight hljs" > < pre class = "java" > $ jad demo.MathGame
ClassLoader:
+-sun.misc.Launcher$AppClassLoader@3d4eac69
+-sun.misc.Launcher$ExtClassLoader@66350f69
Location:
/tmp/arthas-demo.jar
/*
* Decompiled with CFR 0_132.
*/
package demo;
import java.io.PrintStream;
import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;
import java.util.Random;
import java.util.concurrent.TimeUnit;
public class MathGame {
private static Random random = new Random();
private int illegalArgumentCount = 0;
public static void main(String[] args) throws InterruptedException {
MathGame game = new MathGame();
do {
game.run();
TimeUnit.SECONDS.sleep(1L);
} while (true);
}
public void run() throws InterruptedException {
try {
int number = random.nextInt();
List< Integer> primeFactors = this.primeFactors(number);
MathGame.print(number, primeFactors);
}
catch (Exception e) {
System.out.println(String.format(" illegalArgumentCount:%3d, " , this.illegalArgumentCount) + e.getMessage());
}
}
public static void print(int number, List< Integer> primeFactors) {
StringBuffer sb = new StringBuffer(" " + number + " =" );
Iterator< Integer> iterator = primeFactors.iterator();
while (iterator.hasNext()) {
int factor = iterator.next();
sb.append(factor).append(' *' );
}
if (sb.charAt(sb.length() - 1) == ' *' ) {
sb.deleteCharAt(sb.length() - 1);
}
System.out.println(sb);
}
public List< Integer> primeFactors(int number) {
if (number < 2) {
++this.illegalArgumentCount;
throw new IllegalArgumentException(" number is: " + number + " , need > = 2" );
}
ArrayList< Integer> result = new ArrayList< Integer> ();
int i = 2;
while (i < = number) {
if (number % i == 0) {
result.add(i);
number /= i;
i = 2;
continue;
}
++i;
}
return result;
}
}
Affect(row-cnt:1) cost in 970 ms.< / pre > < / div >
< / div >
< / div >
< div class = "section" id = "watch" >
< h2 > 6. 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" > demo.MathGame#primeFactors< / span > < / code > 函数的返回值:< / p >
< div class = "highlight-bash notranslate" > < div class = "highlight hljs" > < pre class = "bash" > $ watch demo.MathGame primeFactors returnObj
Press Ctrl+C to abort.
Affect(class-cnt:1 , method-cnt:1) cost in 107 ms.
ts=2018-11-28 19:22:30; [cost=1.715367ms] result=null
ts=2018-11-28 19:22:31; [cost=0.185203ms] result=null
ts=2018-11-28 19:22:32; [cost=19.012416ms] result=@ArrayList[
@Integer[5],
@Integer[47],
@Integer[2675531],
]
ts=2018-11-28 19:22:33; [cost=0.311395ms] result=@ArrayList[
@Integer[2],
@Integer[5],
@Integer[317],
@Integer[503],
@Integer[887],
]
ts=2018-11-28 19:22:34; [cost=10.136007ms] result=@ArrayList[
@Integer[2],
@Integer[2],
@Integer[3],
@Integer[3],
@Integer[31],
@Integer[717593],
]
ts=2018-11-28 19:22:35; [cost=29.969732ms] result=@ArrayList[
@Integer[5],
@Integer[29],
@Integer[7651739],
]< / pre > < / div >
< / div >
< p > 更多的功能可以查看< a class = "reference internal" href = "advanced-use.html" > < span class = "doc" > 进阶使用< / span > < / a > 。< / p >
< / div >
< div class = "section" id = "id2" >
< h2 > 7. 退出arthas< a class = "headerlink" href = "#id2" title = "永久链接至标题" > ¶< / a > < / h2 >
< p > 如果只是退出当前的连接,可以用< code class = "docutils literal notranslate" > < span class = "pre" > quit< / span > < / code > 或者< code class = "docutils literal notranslate" > < span class = "pre" > exit< / span > < / code > 命令。Attach到目标进程上的arthas还会继续运行, 端口会保持开放, 下次连接时可以直接连接上。< / p >
< p > 如果想完全退出arthas, 可以执行< code class = "docutils literal notranslate" > < span class = "pre" > stop< / span > < / code > 命令。< / 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 = "download.html" class = "btn btn-neutral float-left" title = "下载" accesskey = "p" rel = "prev" > < span class = "fa fa-arrow-circle-left" > < / span > Previous< / a >
< / div >
< hr / >
< div role = "contentinfo" >
< p >
© Copyright 2018-2020, 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" >
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 >
< / 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");
if (window.location.hostname == "arthas.gitee.io") {
hm.src = "https://hm.baidu.com/hm.js?ecc1b0d9aeb73da1671876133211d4d3";
} else { // https://alibaba.github.io/arthas/
hm.src = "https://hm.baidu.com/hm.js?d5c5e25b100f0eb51a4c35c8a86ea9b4";
}
var s = document.getElementsByTagName("script")[0];
s.parentNode.insertBefore(hm, s);
})();
< / script >
< / body >
< / html >