Arthas Install

Linux/Unix/Mac

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

curl -L https://alibaba.github.io/arthas/install.sh | sh

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

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

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

Windows

最新版本：Arthas

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

as.bat pid

如果需要更好的体验，可以在本地使用 as.bat pid 启动 Arthas Server 后，然后在另外的 Linux/Mac 上使用 as.sh pid@ip:port 来远程诊断。

Windows用户如果在cmd里不能正常显示颜色，可以使用conemu。

手动安装

手动安装

手动拼接命令行启动

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

  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 localhost 3658

离线帮助文档

最新版本：Arthas

在Download栏下载最新的 doc.zip 包，

卸载

  • 在 Linux/Unix/Mac 平台

    删除下面文件：

    rm -rf ~/.arthas/ ~/.arthas_history

  • Windows平台直接删除zip包和解压的文件