<!DOCTYPE html>
<!-- [if IE 8]><html class="no - js lt - ie9" lang="en" > <![endif] -->
<!-- [if gt IE 8]><! --> < html class = "no-js" lang = "en" > <!-- <![endif] -->
< head >
< meta charset = "utf-8" >
< meta name = "viewport" content = "width=device-width, initial-scale=1.0" >
< title > Quick Start — Arthas 3.0.6-SNAPSHOT documentation< / 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 = "Index" href = "genindex.html" / >
< link rel = "search" title = "Search" href = "search.html" / >
< link rel = "next" title = "Advanced Usage" href = "advanced-use.html" / >
< link rel = "prev" title = "Install Arthas" 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.6-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" > Installation< / a > < / li >
< li class = "toctree-l1 current" > < a class = "current reference internal" href = "#" > Quick start< / a > < ul >
< li class = "toctree-l2" > < a class = "reference internal" href = "#start-demo-application" > 1. Start Demo Application< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "#start-arthas" > 2. Start Arthas< / a > < ul >
< li class = "toctree-l3" > < a class = "reference internal" href = "#linux-unix-mac" > Linux/Unix/Mac< / a > < / li >
< / ul >
< / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "#check-the-dashboard" > 3. Check the Dashboard< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "#get-the-main-class-of-the-process-with-the-thread-command" > 4. Get the Main Class of the process with the thread command< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "#decompile-main-class-with-jad-command" > 5. Decompile Main Class with jad command< / 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 = "#exit-arthas" > 7. Exit Arthas< / a > < / li >
< / ul >
< / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "advanced-use.html" > Advanced usage< / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "commands.html" > Commands< / a > < / li >
< li class = "toctree-l1" > < a class = "reference external" href = "https://github.com/alibaba/arthas/issues?q=label%3Auser-case" > User cases< / a > < / li >
< li class = "toctree-l1" > < a class = "reference external" href = "https://github.com/alibaba/arthas/issues?q=label%3Aquestion-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" > CONTRIBUTING< / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "release-notes.html" > Release Notes< / 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 > Quick Start< / li >
< li class = "wy-breadcrumbs-aside" >
< a href = "https://github.com/alibaba/arthas/blob/master/site/src/site/sphinx/en/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 = "quick-start" >
< span id = "quick-start" > < / span > < h1 > Quick Start< a class = "headerlink" href = "#quick-start" title = "Permalink to this headline" > ¶< / a > < / h1 >
< div class = "section" id = "start-demo-application" >
< span id = "start-demo-application" > < / span > < h2 > 1. Start Demo Application< a class = "headerlink" href = "#start-demo-application" title = "Permalink to this headline" > ¶< / a > < / h2 >
< div class = "highlight-bash notranslate" > < div class = "highlight" > < pre > < span > < / span > $ wget 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 > is a simple program that generates a random number every second, then find all prime factors of the number.< / p >
< p > The source code of < 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" > View< / a > < / p >
< / div >
< div class = "section" id = "start-arthas" >
< span id = "start-arthas" > < / span > < h2 > 2. Start Arthas< a class = "headerlink" href = "#start-arthas" title = "Permalink to this headline" > ¶< / 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 = "Permalink to this headline" > ¶< / a > < / h3 >
< p > Execute the following command in the command line:< / p >
< div class = "highlight-bash notranslate" > < div class = "highlight" > < pre > < span > < / span > $ wget https://alibaba.github.io/arthas/arthas-boot.jar
$ java -jar arthas-boot.jar
< / pre > < / div >
< / div >
< ul class = "simple" >
< li > The user to run this command < em > MUST< / em > have the same privilege as the owner of the target process, as a simple example you can try the following command if the target process is managed by user < 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 > or < 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 > < / li >
< li > .If you cannot be able to attach to the target process, please check the logs under < code class = "docutils literal notranslate" > < span class = "pre" > ~/logs/arthas< / span > < / code > for troubleshooting.< / li >
< li > < 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 > print usage.< / li >
< / ul >
< p > Select the target Java process to attach:< / p >
< div class = "highlight-bash notranslate" > < div class = "highlight" > < pre > < span > < / span > $ $ java -jar arthas-boot.jar
* < span class = "o" > [< / span > < span class = "m" > 1< / span > < span class = "o" > ]< / span > : < span class = "m" > 35542< / span >
< span class = "o" > [< / span > < span class = "m" > 2< / span > < span class = "o" > ]< / span > : < span class = "m" > 71560< / span > arthas-demo.jar
< / pre > < / div >
< / div >
< p > The ‘ ’ ‘ ’ ‘ ’ < / p >
< div class = "highlight-bash notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "o" > [< / span > INFO< span class = "o" > ]< / span > Try to attach process < span class = "m" > 71560< / span >
< span class = "o" > [< / span > INFO< span class = "o" > ]< / span > Attach process < span class = "m" > 71560< / span > success.
< span class = "o" > [< / span > INFO< span class = "o" > ]< / span > arthas-client connect < span class = "m" > 127< / span > .0.0.1 < span class = "m" > 3658< / span >
,---. ,------. ,--------.,--. ,--. ,---. ,---.
/ O < span class = "se" > \ < / span > < span class = "p" > |< / span > .--. < span class = "s1" > ' ' < / span > --. .--< span class = "s1" > ' | ' < / span > --< span class = "s1" > ' | / O \ ' < / span > .-< span class = "s1" > ' < / span >
< span class = "s1" > | .-. || ' < / span > --< span class = "s1" > ' .' < / span > < span class = "p" > |< / span > < span class = "p" > |< / span > < span class = "p" > |< / span > .--. < span class = "o" > ||< / span > .-. < span class = "p" > |< / span > < span class = "sb" > `< / span > . < span class = "sb" > `< / span > -.
< span class = "p" > |< / span > < span class = "p" > |< / span > < span class = "p" > |< / span > < span class = "o" > ||< / span > < span class = "p" > |< / span > < span class = "se" > \ < / span > < span class = "se" > \ < / span > < span class = "p" > |< / span > < span class = "p" > |< / span > < span class = "p" > |< / span > < span class = "p" > |< / span > < span class = "p" > |< / span > < span class = "o" > ||< / span > < span class = "p" > |< / span > < span class = "p" > |< / span > < span class = "p" > |< / span > .-< span class = "s1" > ' |< / span >
< span class = "s1" > `--' < / span > < span class = "sb" > `< / span > --< span class = "s1" > ' `--' < / span > < span class = "s1" > ' --' < / span > < span class = "sb" > `< / span > --< span class = "s1" > ' `--' < / span > < span class = "sb" > `< / span > --< span class = "s1" > ' `--' < / span > < span class = "sb" > `< / span > --< span class = "s1" > ' `-----' < / span >
wiki: https://alibaba.github.io/arthas
version: < span class = "m" > 3< / span > .0.5.20181127201536
pid: < span class = "m" > 71560< / span >
time: < span class = "m" > 2018< / span > -11-28 < span class = "m" > 19< / span > :16:24
$
< / pre > < / div >
< / div >
< / div >
< / div >
< div class = "section" id = "check-the-dashboard" >
< span id = "check-the-dashboard" > < / span > < h2 > 3. Check the Dashboard< a class = "headerlink" href = "#check-the-dashboard" title = "Permalink to this headline" > ¶< / a > < / h2 >
< p > Type ‘ < a class = "reference internal" href = "dashboard.html" > < span class = "doc" > dashboard< / span > < / a > ’ ‘ ’ < code class = "docutils literal notranslate" > < span class = "pre" > Ctrl+C< / span > < / code > to stop:< / 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 = "get-the-main-class-of-the-process-with-the-thread-command" >
< span id = "get-the-main-class-of-the-process-with-the-thread-command" > < / span > < h2 > 4. Get the Main Class of the process with the thread command< a class = "headerlink" href = "#get-the-main-class-of-the-process-with-the-thread-command" title = "Permalink to this headline" > ¶< / a > < / h2 >
< div class = "highlight-default notranslate" > < div class = "highlight" > < pre > < span > < / span > $ thread -n -1 | grep ' main('
at demo.MathGame.main(MathGame.java:17)
< / pre > < / div >
< / div >
< / div >
< div class = "section" id = "decompile-main-class-with-jad-command" >
< span id = "decompile-main-class-with-jad-command" > < / span > < h2 > 5. Decompile Main Class with jad command< a class = "headerlink" href = "#decompile-main-class-with-jad-command" title = "Permalink to this headline" > ¶< / a > < / h2 >
< div class = "highlight-java notranslate" > < div class = "highlight" > < pre > < span > < / span > $ 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" >
< span id = "watch" > < / span > < h2 > 6. watch< a class = "headerlink" href = "#watch" title = "Permalink to this headline" > ¶< / a > < / h2 >
< p > Use ‘ < 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-default notranslate" > < div class = "highlight" > < pre > < span > < / span > $ 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 > Pls. refer to < a class = "reference internal" href = "advanced-use.html" > < span class = "doc" > advanced usages< / span > < / a > for more information.< / p >
< / div >
< div class = "section" id = "exit-arthas" >
< span id = "exit-arthas" > < / span > < h2 > 7. Exit Arthas< a class = "headerlink" href = "#exit-arthas" title = "Permalink to this headline" > ¶< / a > < / h2 >
< p > Use < code class = "docutils literal notranslate" > < span class = "pre" > quit< / span > < / code > or < code class = "docutils literal notranslate" > < span class = "pre" > exit< / span > < / code > to disconnect from the current process. The Arthas instance attached to the target process continues to live inside the process, and its port is standby for further connection.< / p >
< p > Use < code class = "docutils literal notranslate" > < span class = "pre" > shutdown< / span > < / code > to have Arthas completely quit from the target process.< / 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 = "Advanced Usage" accesskey = "n" rel = "next" > Next < span class = "fa fa-arrow-circle-right" > < / span > < / a >
< a href = "install-detail.html" class = "btn btn-neutral" title = "Install Arthas" 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.6-SNAPSHOT',
LANGUAGE:'en',
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 = "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 >
