目录

手动安装 Arthas

1. 下载最新版本

   最新版本，点击下载：

2. 解压缩 arthas 的压缩包

   unzip arthas-packaging-bin.zip
   

3. 安装 Arthas

   安装之前最好把所有老版本的 Arthas 全都删掉

   sudo su admin
   rm -rf /home/admin/.arthas/lib/*
   cd arthas
   ./install-local.sh
   

   注意

   注意，这里根据你需要诊断的 Java 进程的所属用户进行切换

4. 启动 Arthas

   启动之前，请确保老版本的 Arthas 已经stop.

   ./as.sh
   

以脚本的方式启动 as.sh/as.bat

Linux/Unix/Mac

Arthas 支持在 Linux/Unix/Mac 等平台上一键安装，请复制以下内容，并粘贴到命令行中，敲 回车 执行即可：

curl -L https://arthas.aliyun.com/install.sh | sh

上述命令会下载启动脚本文件 as.sh 到当前目录，你可以放在任何地方或将其加入到 $PATH 中。

直接在 shell 下面执行./as.sh，就会进入交互界面。

也可以执行./as.sh -h来获取更多参数信息。

Windows

最新版本，点击下载：

下载解压后在 bin 目录有 as.bat。此脚本暂时只接受一个参数 pid，即只能诊断本机上的 Java 进程。（欢迎精通 bat 脚本的开发者改进）

as.bat <pid>

使用以下命令诊断 windows 服务模式运行的 Java 进程 (--interact 打开服务 UI 交互模式，方便诊断问题)：

as-service.bat -port <port>
as-service.bat -pid <pid>
as-service.bat -pid <pid> --interact

清理 arthas windows 服务执行以下命令：

as-service.bat -remove

手动拼接命令行启动

如果启动遇到问题，可以尝试手动拼接出命令行参数来启动。

1. 查找目录 jvm 的 java 文件路径。

   在 linux/mac 上执行ps aux | grep java，在 windows 上可以通过进程管理器来查看。假设是/opt/jdk1.8/bin/java。

2. 拼接出命令行

   /opt/jdk1.8/bin/java -Xbootclasspath/a:/opt/jdk1.8/lib/tools.jar \
    -jar /tmp/arthas-packaging/arthas-core.jar \
    -pid 15146 \
    -target-ip 127.0.0.1 -telnet-port 3658 -http-port 8563 \
    -core /tmp/arthas-packaging/arthas-core.jar \
    -agent /tmp/arthas-packaging/arthas/arthas-agent.jar
   

   命令行分几部分组成：

   • -Xbootclasspath 增加 tools.jar
   • -jar /tmp/arthas-packaging/arthas-core.jar 指定 main 函数入口
   • -pid 15146 指定目标 java 进程 ID
   • -target-ip 127.0.0.1 指定 IP
   • -telnet-port 3658 -http-port 8563 指定 telnet 和 http 端口
   • -core /tmp/arthas-packaging/arthas-core.jar -agent /tmp/arthas-packaging/arthas/arthas-agent.jar 指定 core/agent jar 包

   如果是jdk > 9，即 9/10/11 以上的版本，不需要指定tools.jar，直接去掉-Xbootclasspath 的配置即可。

   启动目志输出在~/logs/arthas/arthas.log里。

3. attach 成功之后，使用 telnet 连接

   telnet 127.0.0.1 3658