You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
arthas/en/monitor.html

412 lines
16 KiB
HTML

6 years ago
<!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">
5 years ago
<title>monitor &mdash; Arthas 3.3.3 documentation</title>
6 years ago
<link rel="shortcut icon" href="_static/favicon.ico"/>
5 years ago
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
6 years ago
5 years ago
<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/js/theme.js"></script>
6 years ago
5 years ago
6 years ago
5 years ago
6 years ago
<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" />
6 years ago
<link rel="next" title="watch" href="watch.html" />
6 years ago
<link rel="prev" title="redefine" href="redefine.html" />
<script src="_static/center_page.js"></script>
6 years ago
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.13.1/styles/github.min.css">
6 years ago
</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">
5 years ago
<div class="wy-side-nav-search" >
6 years ago
<a href="index.html" class="icon icon-home"> Arthas
</a>
<div class="version">
5 years ago
3.3.3
6 years ago
</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">
6 years ago
<li class="toctree-l1"><a class="reference external" href="https://alibaba.github.io/arthas/arthas-tutorials?language=en">Online tutorials(Recommend)</a></li>
6 years ago
<li class="toctree-l1"><a class="reference internal" href="install-detail.html">Installation</a></li>
5 years ago
<li class="toctree-l1"><a class="reference internal" href="download.html">Download</a></li>
6 years ago
<li class="toctree-l1"><a class="reference internal" href="quick-start.html">Quick start</a></li>
<li class="toctree-l1"><a class="reference internal" href="advanced-use.html">Advanced usage</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="commands.html">Commands</a><ul class="current">
6 years ago
<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>
5 years ago
<li class="toctree-l2"><a class="reference internal" href="vmoption.html">vmoption</a></li>
5 years ago
<li class="toctree-l2"><a class="reference internal" href="perfcounter.html">perfcounter</a></li>
5 years ago
<li class="toctree-l2"><a class="reference internal" href="logger.html">logger</a></li>
6 years ago
<li class="toctree-l2"><a class="reference internal" href="mbean.html">mbean</a></li>
6 years ago
<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>
6 years ago
<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>
5 years ago
<li class="toctree-l2"><a class="reference internal" href="heapdump.html">heapdump</a></li>
6 years ago
<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>
6 years ago
<li class="toctree-l2"><a class="reference internal" href="mc.html">mc</a></li>
6 years ago
<li class="toctree-l2"><a class="reference internal" href="redefine.html">redefine</a></li>
<li class="toctree-l2 current"><a class="current reference internal" href="#">monitor</a><ul>
6 years ago
<li class="toctree-l3"><a class="reference internal" href="#items-to-monitor">Items to monitor</a></li>
6 years ago
<li class="toctree-l3"><a class="reference internal" href="#parameters">Parameters</a></li>
<li class="toctree-l3"><a class="reference internal" href="#usage">Usage</a></li>
6 years ago
</ul>
</li>
6 years ago
<li class="toctree-l2"><a class="reference internal" href="watch.html">watch</a></li>
<li class="toctree-l2"><a class="reference internal" href="trace.html">trace</a></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>
5 years ago
<li class="toctree-l2"><a class="reference internal" href="profiler.html">profiler</a></li>
6 years ago
<li class="toctree-l2"><a class="reference internal" href="cat.html">cat</a></li>
5 years ago
<li class="toctree-l2"><a class="reference internal" href="echo.html">echo</a></li>
5 years ago
<li class="toctree-l2"><a class="reference internal" href="grep.html">grep</a></li>
5 years ago
<li class="toctree-l2"><a class="reference internal" href="tee.html">tee</a></li>
6 years ago
<li class="toctree-l2"><a class="reference internal" href="pwd.html">pwd</a></li>
6 years ago
<li class="toctree-l2"><a class="reference internal" href="options.html">options</a></li>
6 years ago
<li class="toctree-l2"><a class="reference internal" href="commands.html#basic-arthas-commands">Basic Arthas Commands</a></li>
6 years ago
</ul>
</li>
5 years ago
<li class="toctree-l1"><a class="reference internal" href="web-console.html">WebConsole</a></li>
6 years ago
<li class="toctree-l1"><a class="reference internal" href="docker.html">Docker</a></li>
6 years ago
<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>
5 years ago
<li class="toctree-l1"><a class="reference external" href="https://github.com/alibaba/arthas/blob/master/CONTRIBUTING.md#">Compile and debug/CONTRIBUTING</a></li>
5 years ago
<li class="toctree-l1"><a class="reference external" href="https://github.com/alibaba/arthas/releases">Release Notes</a></li>
5 years ago
<li class="toctree-l1"><a class="reference internal" href="contact-us.html">Contact us</a></li>
6 years ago
</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> &raquo;</li>
6 years ago
<li><a href="commands.html">All Commands</a> &raquo;</li>
6 years ago
<li>monitor</li>
<li class="wy-breadcrumbs-aside">
6 years ago
<a href="https://github.com/alibaba/arthas/blob/master/site/src/site/sphinx/en/monitor.md" class="fa fa-github"> Edit on GitHub</a>
6 years ago
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<div class="section" id="monitor">
5 years ago
<h1>monitor<a class="headerlink" href="#monitor" title="Permalink to this headline"></a></h1>
6 years ago
<blockquote>
5 years ago
<div><p>Monitor method invocation.</p>
</div></blockquote>
<p>Monitor invocation for the method matched with <code class="docutils literal notranslate"><span class="pre">class-pattern</span></code> and <code class="docutils literal notranslate"><span class="pre">method-pattern</span></code>.</p>
<p><code class="docutils literal notranslate"><span class="pre">monitor</span></code> is not a command returning immediately.</p>
<p>A command returning immediately is a command immediately returns with the result after the command is input, while a non-immediate returning command will keep outputting the information from the target JVM process until user presses <code class="docutils literal notranslate"><span class="pre">Ctrl+C</span></code>.</p>
6 years ago
<p>On Arthass server side, the command is running as a background job, but the weaved code will not take further effect once the job is terminated, therefore, it will not impact the performance after the job quits. Furthermore, Arthas is designed to have no side effect to the business logic.</p>
<div class="section" id="items-to-monitor">
5 years ago
<h2>Items to monitor<a class="headerlink" href="#items-to-monitor" title="Permalink to this headline"></a></h2>
6 years ago
<table border="1" class="docutils">
<thead>
<tr>
6 years ago
<th align="right">Item</th>
6 years ago
<th align="left">Specification</th>
</tr>
</thead>
<tbody>
<tr>
<td align="right">timestamp</td>
<td align="left">timestamp</td>
</tr>
<tr>
<td align="right">class</td>
<td align="left">Java class</td>
</tr>
<tr>
<td align="right">method</td>
6 years ago
<td align="left">method (constructor and regular methods)</td>
6 years ago
</tr>
<tr>
<td align="right">total</td>
<td align="left">calling times</td>
</tr>
<tr>
<td align="right">success</td>
<td align="left">success count</td>
</tr>
<tr>
<td align="right">fail</td>
<td align="left">failure count</td>
</tr>
<tr>
<td align="right">rt</td>
<td align="left">average RT</td>
</tr>
<tr>
<td align="right">fail-rate</td>
<td align="left">failure ratio</td>
</tr>
</tbody>
</table></div>
<div class="section" id="parameters">
5 years ago
<h2>Parameters<a class="headerlink" href="#parameters" title="Permalink to this headline"></a></h2>
<p>Parameter <code class="docutils literal notranslate"><span class="pre">[c:]</span></code> stands for cycles of statistics. Its value is an integer value in seconds.</p>
6 years ago
<table border="1" class="docutils">
<thead>
<tr>
<th align="right">Name</th>
<th align="left">Specification</th>
</tr>
</thead>
<tbody>
<tr>
<td align="right"><em>class-pattern</em></td>
<td align="left">pattern for the class name</td>
</tr>
<tr>
<td align="right"><em>method-pattern</em></td>
<td align="left">pattern for the method name</td>
</tr>
<tr>
6 years ago
<td align="right"><code>[E]</code></td>
6 years ago
<td align="left">turn on regex matching while the default is wildcard matching</td>
6 years ago
</tr>
<tr>
6 years ago
<td align="right"><code>[c:]</code></td>
<td align="left">cycle of statistics, the default value: <code>120</code>s</td>
6 years ago
</tr>
</tbody>
</table></div>
<div class="section" id="usage">
5 years ago
<h2>Usage<a class="headerlink" href="#usage" title="Permalink to this headline"></a></h2>
6 years ago
<div class="highlight-bash notranslate"><div class="highlight hljs"><pre class="bash">$ monitor -c 5 demo.MathGame primeFactors
6 years ago
Press Ctrl+C to abort.
6 years ago
Affect(class-cnt:1 , method-cnt:1) cost in 94 ms.
timestamp class method total success fail avg-rt(ms) fail-rate
6 years ago
-----------------------------------------------------------------------------------------------
6 years ago
2018-12-03 19:06:38 demo.MathGame primeFactors 5 1 4 1.15 80.00%
6 years ago
6 years ago
timestamp class method total success fail avg-rt(ms) fail-rate
6 years ago
-----------------------------------------------------------------------------------------------
6 years ago
2018-12-03 19:06:43 demo.MathGame primeFactors 5 3 2 42.29 40.00%
6 years ago
6 years ago
timestamp class method total success fail avg-rt(ms) fail-rate
6 years ago
-----------------------------------------------------------------------------------------------
6 years ago
2018-12-03 19:06:48 demo.MathGame primeFactors 5 3 2 67.92 40.00%
6 years ago
6 years ago
timestamp class method total success fail avg-rt(ms) fail-rate
6 years ago
-----------------------------------------------------------------------------------------------
6 years ago
2018-12-03 19:06:53 demo.MathGame primeFactors 5 2 3 0.25 60.00%
6 years ago
6 years ago
timestamp class method total success fail avg-rt(ms) fail-rate
6 years ago
-----------------------------------------------------------------------------------------------
6 years ago
2018-12-03 19:06:58 demo.MathGame primeFactors 1 1 0 0.45 0.00%
6 years ago
6 years ago
timestamp class method total success fail avg-rt(ms) fail-rate
6 years ago
-----------------------------------------------------------------------------------------------
5 years ago
2018-12-03 19:07:03 demo.MathGame primeFactors 2 2 0 3182.72 0.00%</pre></div>
6 years ago
</div>
</div>
</div>
</div>
</div>
<footer>
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
6 years ago
<a href="watch.html" class="btn btn-neutral float-right" title="watch" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
6 years ago
5 years ago
<a href="redefine.html" class="btn btn-neutral float-left" title="redefine" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
6 years ago
</div>
<hr/>
<div role="contentinfo">
<p>
5 years ago
&copy; Copyright 2018-2020, Alibaba Middleware Group, and contributors
6 years ago
</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>
5 years ago
6 years ago
<div class="github-fork-ribbon-wrapper right">
<div class="github-fork-ribbon">
6 years ago
<a href="https://github.com/alibaba/arthas" target="_blank">Fork me at GitHub</a>
6 years ago
</div>
</div>
<script type="text/javascript" src="_static/add_badges.js"></script>
6 years ago
<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>
6 years ago
<script>
var _hmt = _hmt || [];
(function() {
var hm = document.createElement("script");
5 years ago
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";
}
6 years ago
var s = document.getElementsByTagName("script")[0];
s.parentNode.insertBefore(hm, s);
})();
</script>
</body>
</html>