启动 Arthas

交互模式启动

./as.sh

➜  bin git:(develop) ✗ ./as.sh
Found existing java process, please choose one and hit RETURN.
  [1]: 3088 org.jetbrains.idea.maven.server.RemoteMavenServer
* [2]: 12872 org.apache.catalina.startup.Bootstrap
  [3]: 2455
Attaching to 12872...
  ,---.  ,------. ,--------.,--.  ,--.  ,---.   ,---.
 /  O  \ |  .--. ''--.  .--'|  '--'  | /  O  \ '   .-'
|  .-.  ||  '--'.'   |  |   |  .--.  ||  .-.  |`.  `-.
|  | |  ||  |\  \    |  |   |  |  |  ||  | |  |.-'    |
`--' `--'`--' '--'   `--'   `--'  `--'`--' `--'`-----'
$

非交互模式启动

启动脚本如下：

./as.sh <PID>[@IP:PORT]

参数说明

• PID：目标 Java 进程 ID（请确保执行当前执行命令的用户必须有足够的权限操作对应的 Java 进程）
• IP：目标服务器 IP 地址，当 Arthas Server 启动后，其他人可以通过指定 IP 的形式加载到对应目标机器的 Java 进程中，从而实现远程协助。Arthas 允许多个用户同时访问，并且各自的命令不会相互干扰执行
• PORT：目标服务器 Arthas Server 的端口号，默认的端口号是 3658

示例

• 如果不指定 IP 和 PORT，默认是 127.0.0.1 和 3658

  ./as.sh 12345

  上述命令等价于：

  ./as.sh 12356@127.0.0.1:3658

远程诊断

服务器启动 Arthas Server 后，其他人可以使用 Arthas Console Client 远程连接上去进程诊断，请参考：

./as.sh PID@RemoteIP:RemotePort

其中 PID 为远程服务器上的 Java 进程 ID，RemoteIP 为远程服务器的 IP 地址，RemotePort 为远程服务器上 Arthas Server 的端口，默认为 3658。

sudo 支持

成熟的线上管理环境一般都不会直接开放 JVM 部署用户权限给你，而是通过 sudo-list 来控制和监控用户的越权操作。由于 as.sh 脚本中会对当前用户的环境变量产生感知，所以需要加上 -H 参数

> sudo -u admin -H ./as.sh 12345

telnet 的支持

Arthas 支持通过 telnet 来访问服务端，如果当你手头的机器没有安装 Arthas Console Client，你可以简单的通过 telnet 命令来进行访问。

> telnet 10.232.12.113 3658

当然了，telnet 命令没有 Tab 自动补全，各种操作体验也不如 Arthas Client Console。

Windows 环境支持

• 目前 Arthas 提供了 as.bat 脚本，用于 Windows 环境下的诊断场景；此脚本暂时只接受一个参数 pid，即只能诊断本机上的 Java 进程；
• 另外，as.bat 脚本在体验方面还有一些问题，如果需要更好的体验，可以在本地使用 as.bat pid 启动 Arthas Server 后，然后在另外的 Linux/Mac 上使用 as.bat pid@ip:port 来远程诊断；