|
|
|
|
|
<!DOCTYPE html>
|
|
|
|
|
|
<html lang="zh-CN">
|
|
|
|
|
|
<head>
|
|
|
|
|
|
<meta charset="utf-8">
|
|
|
|
|
|
<meta name="viewport" content="width=device-width,initial-scale=1">
|
|
|
|
|
|
<meta name="generator" content="VuePress 2.0.0-beta.51">
|
|
|
|
|
|
<style>
|
|
|
|
|
|
:root {
|
|
|
|
|
|
--c-bg: #fff;
|
|
|
|
|
|
}
|
|
|
|
|
|
html.dark {
|
|
|
|
|
|
--c-bg: #22272e;
|
|
|
|
|
|
}
|
|
|
|
|
|
html, body {
|
|
|
|
|
|
background-color: var(--c-bg);
|
|
|
|
|
|
}
|
|
|
|
|
|
</style>
|
|
|
|
|
|
<script>
|
|
|
|
|
|
const userMode = localStorage.getItem('vuepress-color-scheme');
|
|
|
|
|
|
const systemDarkMode = window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches;
|
|
|
|
|
|
if (userMode === 'dark' || (userMode !== 'light' && systemDarkMode)) {
|
|
|
|
|
|
document.documentElement.classList.toggle('dark', true);
|
|
|
|
|
|
}
|
|
|
|
|
|
</script>
|
|
|
|
|
|
<link rel="icon" href="/images/favicon.ico"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta property="og:title" content="Arthas"><meta property="og:image:alt" content="Alibaba Java Diagnostic Tool Arthas/Alibaba Java诊断利器Arthas - alibaba/arthas: Alibaba Java Diagnostic Tool Arthas/Alibaba Java诊断利器Arthas"><meta property="og:image" content="/images/arthas_mate_image.png"><meta property="og:description" content="Alibaba Java Diagnostic Tool Arthas/Alibaba Java诊断利器Arthas - alibaba/arthas: Alibaba Java Diagnostic Tool Arthas/Alibaba Java诊断利器Arthas"><meta property="og:image:width" content="1200"><meta property="og:image:height" content="600"><meta property="twitter:image:src" content="/images/arthas_mate_image.png"><meta property="twitter:image:alt" content="Alibaba Java Diagnostic Tool Arthas/Alibaba Java诊断利器Arthas - alibaba/arthas: Alibaba Java Diagnostic Tool Arthas/Alibaba Java诊断利器Arthas"><meta itemprop="name" content="Arthas"><meta itemprop="image" content="/images/arthas_mate_image.png"><meta itemprop="description" content="Alibaba Java Diagnostic Tool Arthas/Alibaba Java诊断利器Arthas - alibaba/arthas: Alibaba Java Diagnostic Tool Arthas/Alibaba Java诊断利器Arthas"><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><meta name="aes-config" content="pid=xux-opensource&user_type=101&uid=&username="><script src="//g.alicdn.com/alilog/mlog/aplus_v2.js" id="beacon-aplus" exparams="clog=o&aplus&sidx=aplusSidx&ckx=aplusCkx"></script><script src="//g.alicdn.com/aes/??tracker/1.0.34/index.js,tracker-plugin-pv/2.4.5/index.js,tracker-plugin-event/1.2.5/index.js,tracker-plugin-jserror/1.0.13/index.js,tracker-plugin-api/1.1.14/index.js,tracker-plugin-perf/1.1.8/index.js,tracker-plugin-eventTiming/1.0.4/index.js"></script><title>手动安装 Arthas | arthas</title><meta name="description" content="arthas 使用文档">
|
|
|
|
|
|
<link rel="modulepreload" href="/assets/app.a799ec6e.js"><link rel="modulepreload" href="/assets/manual-install.html.28c47a10.js"><link rel="modulepreload" href="/assets/manual-install.html.9f2269f2.js"><link rel="prefetch" href="/assets/index.html.fc6fe773.js"><link rel="prefetch" href="/assets/index.html.303ae9ec.js"><link rel="prefetch" href="/assets/index.html.ad417e2a.js"><link rel="prefetch" href="/assets/advanced-use.html.11577830.js"><link rel="prefetch" href="/assets/advice-class.html.30be8b5c.js"><link rel="prefetch" href="/assets/agent.html.478e63bb.js"><link rel="prefetch" href="/assets/arthas-properties.html.e3240fdd.js"><link rel="prefetch" href="/assets/arthas3.html.76d57c12.js"><link rel="prefetch" href="/assets/async.html.45f0f3b0.js"><link rel="prefetch" href="/assets/auth.html.f3cff3ae.js"><link rel="prefetch" href="/assets/base64.html.4ec57369.js"><link rel="prefetch" href="/assets/batch-support.html.b4aede0e.js"><link rel="prefetch" href="/assets/cat.html.8fd88644.js"><link rel="prefetch" href="/assets/classloader.html.7186247e.js"><link rel="prefetch" href="/assets/cls.html.3d057407.js"><link rel="prefetch" href="/assets/commands.html.693fbebe.js"><link rel="prefetch" href="/assets/contact-us.html.20195493.js"><link rel="prefetch" href="/assets/dashboard.html.209e0bb6.js"><link rel="prefetch" href="/assets/docker.html.a0eb05f5.js"><link rel="prefetch" href="/assets/download.html.2deec3fd.js"><link rel="prefetch" href="/assets/dump.html.50ddfd6c.js"><link rel="prefetch" href="/assets/echo.html.a1f5ce8f.js"><link rel="prefetch" href="/assets/faq.html.3fd76b41.js"><link rel="prefetch" href="/assets/getstatic.html.27112680.js"><link rel="prefetch" href="/assets/grep.html.dacb4fa0.js"><link rel="prefetch" href="/assets/groovy.html.f09fc852.js"><link rel="prefetch" href="/assets/heapdump.html.9a327e6e.js"><link rel="prefetch" href="/assets/help.html.e5e91b23.js"><link rel="prefetch" href="/assets/history.html.c2319956.js"><link rel="prefetch" href="/assets/http-api.html.340272fb.js"><link rel="prefetch" href="/assets/idea-plugin.html.fa691dc4.js"><link rel="prefetch" href="/assets/install-detail.html.3ad5b48c.js"><link rel="prefetch" href="/assets/jad.html.b439ea1a.js"><link rel="prefetch" href="/assets/jfr.html.a3b2ba6e.js"><link rel="prefetch" href="/assets/jvm.html.cf096739.js"><link rel="prefetch" href="/assets/keymap.html.a01789a5.js"><link rel="prefetch" href="/assets/logger.html.d03a8f0c.js"><link rel="prefetch" href="/assets/mbean.html.6c96833e.js"><link rel="prefetch" href="/assets/mc.html.255cc69c.js"><link rel="prefetch" href="/assets/memory.html.e3662077.js"><link rel="prefetch" href="/assets/monitor.html.bbbe19cc.js"><link rel="prefetch" href="/assets/ognl.html.3a3047a0.js"><link rel="prefetch" href="/assets/options.html.cd16814d.js"><link rel="prefetch" href="/assets/perfcounter.html.0a700f02.js"><link rel="prefetch" href="/assets/profiler.html.936fa1a4.js"><link rel="prefetch" href="/assets/pwd.html.ba33c545.js"><link rel="prefetch" href="/assets/quick-start.html.198ba0e7.js"><link rel="prefetch" href="/assets/quit.html.7ac530c1.js"><link rel="prefetch" href="/assets/redefine.html.ffb1192e.js"><link rel="prefetch" href="/assets/release-notes.html.1d8a3dd4.js"><link rel="prefetch" href="/assets/reset.html.a5e22012.js"><link rel="prefetch" href="/assets/retransform.html.c64149ae.js"><link rel="prefetch" href="/assets/save-log.html.2afe45b4.js"><link rel="prefetch" href="/assets/sc.html.247dcf9f.js"><link rel="prefetch" href="/assets/session.html.c7900924.js"><link rel="prefetch" href="/assets/sm.html.41f4be43.js"><link rel="prefetch" href="/assets/spring-boot-starter.html.55ed5500.js"><link rel="prefetch" href="/assets/stack.html.4879f051.js"><link rel="prefetch" href="/assets/start-arthas.html.f76a5b27.js"><link rel="prefetch" href="/assets/stop.html.b66bc06b.js"><link rel="prefetch" href="/assets/sysenv.html.cdb5ad58.js"><link rel="prefetch" href="/assets/sysprop.html.cf8f14e1.js"><link rel="prefetch" href="/assets/tee.html.7417e879.js"><link rel="prefetch" href="/assets/thread.html.26
|
|
|
|
|
|
<link rel="stylesheet" href="/assets/style.da1934a3.css">
|
|
|
|
|
|
</head>
|
|
|
|
|
|
<body>
|
|
|
|
|
|
<div id="app"><!--[--><div class="theme-container"><!--[--><header class="navbar"><div class="toggle-sidebar-button" title="切换侧边栏" aria-expanded="false" role="button" tabindex="0"><div class="icon" aria-hidden="true"><span></span><span></span><span></span></div></div><span><a href="/" class="" data-v-61144abc><!----><span class="site-name can-hide" data-v-61144abc>arthas</span><span class="navbar-version" data-v-61144abc>v3.6.5</span></a></span><div class="navbar-items-wrapper" style=""><!--[--><!--]--><nav class="navbar-items can-hide"><!--[--><div class="navbar-item"><a href="/" class="" aria-label="首页"><!--[--><!--]--> 首页 <!--[--><!--]--></a></div><div class="navbar-item"><a class="external-link" href="/doc/arthas-tutorials.html?language=cn&id=arthas-basics" rel="noopener noreferrer" target="_blank" aria-label="在线教程"><!--[--><!--]--><span>在线教程</span><span><svg class="external-link-icon" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewbox="0 0 100 100" width="15" height="15"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg><span class="external-link-icon-sr-only">在新窗口打开</span></span><!--[--><!--]--></a></div><div class="navbar-item"><a href="/doc/" class="router-link-active" aria-label="文档"><!--[--><!--]--> 文档 <!--[--><!--]--></a></div><div class="navbar-item"><a href="/doc/commands.md" class="" aria-label="命令列表"><!--[--><!--]--> 命令列表 <!--[--><!--]--></a></div><div class="navbar-item"><a href="/doc/download.md" class="" aria-label="下载"><!--[--><!--]--> 下载 <!--[--><!--]--></a></div><div class="navbar-item"><div class="navbar-dropdown-wrapper"><button class="navbar-dropdown-title" type="button" aria-label="解决方案"><span class="title">解决方案</span><span class="arrow down"></span></button><button class="navbar-dropdown-title-mobile" type="button" aria-label="解决方案"><span class="title">解决方案</span><span class="right arrow"></span></button><ul style="display:none;" class="navbar-dropdown"><!--[--><li class="navbar-dropdown-item"><a class="external-link" href="https://cn.aliyun.com/product/aliware/mse?spm=arthas.topbar.0.0.0" rel="noopener noreferrer" target="_blank" aria-label="微服务解决方案"><!--[--><!--]--><span>微服务解决方案</span><span><svg class="external-link-icon" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewbox="0 0 100 100" width="15" height="15"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg><span class="external-link-icon-sr-only">在新窗口打开</span></span><!--[--><!--]--></a></li><li class="navbar-dropdown-item"><a class="external-link" href="https://www.aliyun.com/aliware/txc?spm=arthas.topbar.0.0.0" rel="noopener noreferrer" target="_blank" aria-label="分布式事务解决方案"><!--[--><!--]--><span>分布式事务解决方案</span><span><svg class="external-link-icon" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewbox="0 0 100 100" width="15" height="15"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg><span class="external-link-icon-sr-only">在新窗口打开</span></span><!--[--><!--]--></a></li><li class="navbar-dropdown-item"><a class="external-link" href="https://www.aliyun.com/product/ahas?spm=artha
|
|
|
|
|
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div></div></div></li><li><p>安装 Arthas</p><p>安装之前最好把所有老版本的 Arthas 全都删掉</p><div class="language-text ext-text line-numbers-mode"><pre class="language-text"><code>sudo su admin
|
|
|
|
|
|
rm -rf /home/admin/.arthas/lib/*
|
|
|
|
|
|
cd arthas
|
|
|
|
|
|
./install-local.sh
|
|
|
|
|
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><div class="custom-container warning"><p class="custom-container-title">注意</p><p>注意，这里根据你需要诊断的 Java 进程的所属用户进行切换</p></div></li><li><p>启动 Arthas</p><p>启动之前，请确保老版本的 Arthas 已经<code>stop</code>.</p><div class="language-text ext-text line-numbers-mode"><pre class="language-text"><code>./as.sh
|
|
|
|
|
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div></div></div></li></ol><h2 id="以脚本的方式启动-as-sh-as-bat" tabindex="-1"><a class="header-anchor" href="#以脚本的方式启动-as-sh-as-bat" aria-hidden="true">#</a> 以脚本的方式启动 as.sh/as.bat</h2><h3 id="linux-unix-mac" tabindex="-1"><a class="header-anchor" href="#linux-unix-mac" aria-hidden="true">#</a> Linux/Unix/Mac</h3><p>Arthas 支持在 Linux/Unix/Mac 等平台上一键安装，请复制以下内容，并粘贴到命令行中，敲 <code>回车</code> 执行即可：</p><div class="language-bash ext-sh line-numbers-mode"><pre class="language-bash"><code><span class="token function">curl</span> <span class="token parameter variable">-L</span> https://arthas.aliyun.com/install.sh <span class="token operator">|</span> <span class="token function">sh</span>
|
|
|
|
|
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div></div></div><p>上述命令会下载启动脚本文件 <code>as.sh</code> 到当前目录，你可以放在任何地方或将其加入到 <code>$PATH</code> 中。</p><p>直接在 shell 下面执行<code>./as.sh</code>，就会进入交互界面。</p><p>也可以执行<code>./as.sh -h</code>来获取更多参数信息。</p><h3 id="windows" tabindex="-1"><a class="header-anchor" href="#windows" aria-hidden="true">#</a> Windows</h3><p>最新版本，点击下载：<a href="https://arthas.aliyun.com/download/latest_version?mirror=aliyun" target="_blank" rel="noopener noreferrer"><img src="https://img.shields.io/maven-central/v/com.taobao.arthas/arthas-packaging.svg?style=flat-square" alt="" title="Arthas"><span><svg class="external-link-icon" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewbox="0 0 100 100" width="15" height="15"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg><span class="external-link-icon-sr-only">在新窗口打开</span></span></a></p><p>下载解压后在 bin 目录有 <code>as.bat</code>。此脚本暂时只接受一个参数 pid，即只能诊断本机上的 Java 进程。（欢迎精通 bat 脚本的开发者改进）</p><div class="language-text ext-text line-numbers-mode"><pre class="language-text"><code>as.bat <pid>
|
|
|
|
|
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div></div></div><p>使用以下命令诊断 windows 服务模式运行的 Java 进程 (--interact 打开服务 UI 交互模式，方便诊断问题)：</p><div class="language-text ext-text line-numbers-mode"><pre class="language-text"><code>as-service.bat -port <port>
|
|
|
|
|
|
as-service.bat -pid <pid>
|
|
|
|
|
|
as-service.bat -pid <pid> --interact
|
|
|
|
|
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><p>清理 arthas windows 服务执行以下命令：</p><div class="language-text ext-text line-numbers-mode"><pre class="language-text"><code>as-service.bat -remove
|
|
|
|
|
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div></div></div><h2 id="手动拼接命令行启动" tabindex="-1"><a class="header-anchor" href="#手动拼接命令行启动" aria-hidden="true">#</a> 手动拼接命令行启动</h2><p>如果启动遇到问题，可以尝试手动拼接出命令行参数来启动。</p><ol><li><p>查找目录 jvm 的 java 文件路径。</p><p>在 linux/mac 上执行<code>ps aux | grep java</code>，在 windows 上可以通过进程管理器来查看。假设是<code>/opt/jdk1.8/bin/java</code>。</p></li><li><p>拼接出命令行</p><div class="language-bash ext-sh line-numbers-mode"><pre class="language-bash"><code>/opt/jdk1.8/bin/java -Xbootclasspath/a:/opt/jdk1.8/lib/tools.jar <span class="token punctuation">\</span>
|
|
|
|
|
|
<span class="token parameter variable">-jar</span> /tmp/arthas-packaging/arthas-core.jar <span class="token punctuation">\</span>
|
|
|
|
|
|
<span class="token parameter variable">-pid</span> <span class="token number">15146</span> <span class="token punctuation">\</span>
|
|
|
|
|
|
-target-ip <span class="token number">127.0</span>.0.1 -telnet-port <span class="token number">3658</span> -http-port <span class="token number">8563</span> <span class="token punctuation">\</span>
|
|
|
|
|
|
<span class="token parameter variable">-core</span> /tmp/arthas-packaging/arthas-core.jar <span class="token punctuation">\</span>
|
|
|
|
|
|
<span class="token parameter variable">-agent</span> /tmp/arthas-packaging/arthas/arthas-agent.jar
|
|
|
|
|
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><p>命令行分几部分组成：</p><ul><li><code>-Xbootclasspath</code> 增加 tools.jar</li><li><code>-jar /tmp/arthas-packaging/arthas-core.jar</code> 指定 main 函数入口</li><li><code>-pid 15146</code> 指定目标 java 进程 ID</li><li><code>-target-ip 127.0.0.1</code> 指定 IP</li><li><code>-telnet-port 3658 -http-port 8563</code> 指定 telnet 和 http 端口</li><li><code>-core /tmp/arthas-packaging/arthas-core.jar -agent /tmp/arthas-packaging/arthas/arthas-agent.jar</code> 指定 core/agent jar 包</li></ul><p>如果是<code>jdk > 9</code>，即 9/10/11 以上的版本，不需要指定<code>tools.jar</code>，直接去掉<code>-Xbootclasspath</code> 的配置即可。</p><p>启动目志输出在<code>~/logs/arthas/arthas.log</code>里。</p></li><li><p>attach 成功之后，使用 telnet 连接</p><div class="language-bash ext-sh line-numbers-mode"><pre class="language-bash"><code>telnet <span class="token number">127.0</span>.0.1 <span class="token number">3658</span>
|
|
|
|
|
|
</code></pre><div class="line-numbers" aria-hidden="true"><div class="line-number"></div></div></div></li></ol></div><!--[--><!--]--></div><footer class="page-meta right-menu-padding" data-v-fdd717e0><div class="meta-item edit-link"><a class="external-link meta-item-label" href="https://github.com/alibaba/arthas/edit/master/site/docs/doc/manual-install.md" rel="noopener noreferrer" target="_blank" aria-label="在 GitHub 上编辑此页"><!--[--><!--]--><span>在 GitHub 上编辑此页</span><span><svg class="external-link-icon" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewbox="0 0 100 100" width="15" height="15"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg><span class="external-link-icon-sr-only">在新窗口打开</span></span><!--[--><!--]--></a></div><div class="meta-item last-updated"><span class="meta-item-label">Last Updated: </span><!----></div><div class="meta-item contributors"><span class="meta-item-label">贡献者: </span><span class="meta-item-info"><!--[--><!--[--><span class="contributor" title="email: hengyunabc@gmail.com">hengyunabc</span><!--[-->, <!--]--><!--]--><!--[--><span class="contributor" title="email: kylixs@qq.com">gongdewei</span><!----><!--]--><!--]--></span></div></footer><!----><!--[--><!--]--></main><!--]--></div><!----><!--]--></div>
|
|
|
|
|
|
<script type="module" src="/assets/app.a799ec6e.js" defer></script>
|
|
|
|
|
|
</body>
|
|
|
|
|
|
</html>
|
