1、 Starting mode

At present, there are three types ：

• jar Package start ：arthas-boot.jar Start installation .
• browser ：Web Console.
• browser ：Arthas Tunnel.

2、jar Package start mode

download arthas-boot.jar, And then use java -jar Way to start

curl -O https://arthas.aliyun.com/arthas-boot.jar
java -jar arthas-boot.jar

3、Web Console

3.1 spring boot Access

Introduce dependencies

<dependency>
    <groupId>com.taobao.arthas</groupId>
    <artifactId>arthas-spring-boot-starter</artifactId>
    <version>${arthas.version}</version>
</dependency>

Start project

java -jar arthas-demo-1.0.0.jar 

You can directly access ：http://127.0.0.1:8563/

 4、Arthas Tunnel（ It is recommended to use in production ）

4.1 Download deployment arthas tunnel server

https://github.com/alibaba/arthas/releases

• from Maven Warehouse downloading ：Maven Central Repository Search

• from Github Releases Page download ： https://github.com/alibaba/arthas/releases

Arthas tunnel server It's a spring boot fat jar application , direct java -jar start-up ：

java -jar arthas-tunnel-server-3.6.0-fatjar.jar

  By default ,arthas tunnel server Of web The port is 8080,arthas agent The port of connection is 7777.

After starting , You can visit  http://127.0.0.1:8080/ , Re pass agentId Connect to a registered arthas agent On .

adopt Spring Boot Of Endpoint, You can view the specific connection information ： http://127.0.0.1:8080/actuator/arthas , The login user name is arthas, Password in arthas tunnel server You can find it in your log , such as ：

32851 [main] INFO  o.s.b.a.s.s.UserDetailsServiceAutoConfiguration

Using generated security password: f1dca050-3777-48f4-a577-6367e55a78a2

 4.2 spring boot Access

Introduce dependencies

<dependency>
    <groupId>com.taobao.arthas</groupId>
    <artifactId>arthas-spring-boot-starter</artifactId>
    <version>${arthas.version}</version>
</dependency>

The configuration file

arthas:
  app-name: arthas-demo
#  agent-id: arthas-demo
  tunnel-server: ws://127.0.0.1:7777/ws
  # If it is to prevent multiple startup on one machine  arthas Port conflict . It can be configured as a random port ( Configure to 0), Or it can be configured as  -1, And through tunnel server To use arthas.
  telnet-port: -1
  http-port: -1

Be careful ：

• If you just configure app-name, Not configured agent-id, Will be automatically generated to arthas-demo Prefixed agent-id. Such as ：

arthas-demo_CKPSCPC14OPLSAPM5P1P

• If it is to prevent multiple startup on one machine arthas Port conflict . It can be configured as a random port , Or it can be configured as -1, And through tunnel server To use arthas.

Start project

java -jar arthas-demo-1.0.0.jar 

tunnel server journal , It indicates that the registration is successful

2022-04-19 14:50:08.278  INFO 3789 --- [Server-boss-1-1] io.netty.handler.logging.LoggingHandler  : [id: 0x341ce3ae, L:/0.0.0.0:7777] READ: [id: 0xedb2f060, L:/172.16.29.148:7777 - R:/47.111.96.249:48576]
2022-04-19 14:50:08.278  INFO 3789 --- [Server-boss-1-1] io.netty.handler.logging.LoggingHandler  : [id: 0x341ce3ae, L:/0.0.0.0:7777] READ COMPLETE
2022-04-19 14:50:08.293  INFO 3789 --- [rver-worker-3-3] c.a.a.t.server.TunnelSocketFrameHandler  : websocket handshake complete, uri: /ws?method=agentRegister&arthasVersion=3.6.0&appName=arthas-demo

4.3 tunnel server Check out the list of apps

Access address ：http://localhost:8080/apps.html

Open details , You can see all the connected agent list ：

Click on ip Address , You can enter the corresponding arthas Console

5、 Official website document address

Arthas User documentation — Arthas 3.6.0 file