github-forks
/
arthas
mirror of https://github.com/alibaba/arthas.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
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.
master
gh-pages
3.x
grpc-service
killercoda
dependabot/npm_and_yarn/web-ui/arthasWebConsole/vite-2.9.16
channel-server
object-view-model
oneagent
improve-http-api
http-api
4.0.x
arthas-all-3.4.3
arthas-all-3.4.2
arthas-all-3.4.1
arthas-all-3.4.0
arthas-all-3.3.9
arthas-all-3.3.8
arthas-all-3.3.7
arthas-all-3.3.6
arthas-all-3.3.5
arthas-all-3.3.3
arthas-all-3.3.2
arthas-all-3.3.1
arthas-all-3.3.0
arthas-all-3.2.0
arthas-all-3.1.8
arthas-all-3.1.7
arthas-all-3.1.6
arthas-all-3.1.5
arthas-all-3.1.4
arthas-all-3.1.3
arthas-all-3.1.2
arthas-all-3.1.1
3.1.0
arthas-all-3.0.5
arthas-all-3.0.4
arthas-all-3.0.3
arthas-all-3.0.0-RC
3.0.0-SNAPSHOT
arthas-all-3.3.4
arthas-all-3.4.4
arthas-all-3.4.5
arthas-all-3.4.6
arthas-all-3.4.7
arthas-all-3.4.8
arthas-all-3.5.0
arthas-all-3.5.1
arthas-all-3.5.2
arthas-all-3.5.3
arthas-all-3.5.4
arthas-all-3.5.5
arthas-all-3.5.6
arthas-all-3.6.0
arthas-all-3.6.1
arthas-all-3.6.2
arthas-all-3.6.3
arthas-all-3.6.4
arthas-all-3.6.5
arthas-all-3.6.6
arthas-all-3.6.7
arthas-all-3.6.8
arthas-all-3.6.9
arthas-all-3.7.0
arthas-all-3.7.1
arthas-all-3.7.2
arthas-all-3.7.3
arthas-all-4.0.0
arthas-all-4.0.1
arthas-all-4.0.2
arthas-all-4.0.3
arthas-all-4.0.4
doc-3.0.4-20181112
doc-3.0.4-20181128
doc-3.0.5-20190213
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '8f36fdd720'
${ noResults }
arthas/site/docs/en/doc/start-arthas.md

1.9 KiB
Raw Blame History Unescape Escape

Start Arthas

Interactive Mode

./as.sh

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

Non-Interactive Mode

Startup script is as follows:

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

Parameter Description

  • PID: Target Java process ID (Make sure that the user executing the command has sufficient permissions to operate the target Java process.)
  • IP: The address that Arthas Server listens on, the default value is 127.0.0.1. Arthas allows multiple users to access simultaneously without interfering with each other.
  • PORT: Arthas Server port，the default value is 3658

Sample

  • If IP and PORT are not specified, then the default values are 127.0.0.1 and 3658

    ./as.sh 12345

    Equivalent to:

    ./as.sh 12356@127.0.0.1:3658

Remote Diagnosis

After starting Arthas Server on the target Java process, users can use telnet connect to the remote Arthas Server, for example：

telnet 192.168.1.119 3658

sudo Support

Usually online environment will only grant users privilege as low as possible, instead, all advanced operations are through sudo-list. Since as.sh script takes into account the current effective user, it is possible to run the script in the other rule, by specifying -H option like this:

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

Windows Support

Right now as.bat script supports one parameter only, which is: pid

as.bat <pid>