【JVM實戰系列】「監控調優體系」實戰開發arthas-spring-boot-starter監控你的微服務是否健康

洛神灬殤發表於2022-12-22

前提介紹

相信如果經歷了我的上一篇Arthas的文章[【JVM實戰系列】「監控調優體系」針對於Alibaba-Arthas的安裝入門及基礎使用開發實戰指南]之後，相信你對Arthas的功能和使用應該有了一定的理解了。那麼我們就要進行下一步的探索功能。

Arthas對於SpringBoot2的支援和監控體系

在SpringBoot2應用中加入arthas-spring-boot-starter後，Spring會啟動arthas服務，並且進行attach自身程式，並配合tunnel server實現遠端管理。這樣的方案非常適合在微服務容器環境中進行遠端診斷，在容器網路環境中僅需要對外暴露tunnel server的埠。

Arthas的監控體系所需要的元件支援

Arthas Tunnel Server/Client（Java agent探針的管理和監控，方便我們管理服務和探針）
Web Console

什麼是Arthas Tunnel

在容器化部署的環境內部，Java程式可以是在不同的機器啟動的，想要使用Arthas去診斷會比較麻煩，因為使用者通常沒有機器的許可權，即使登陸機器也分不清是哪個Java程式。在這種情況下，可以使用 Arthas Tunnel Server/Client。

Arthas Tunnel的作用和目的

整個Arthas的功能體系中，可以透過Arthas Tunnel Server/Client來遠端管理/連線多個Agent（也就代表著可以監控多個JVM程式）。主要目的用於監控和獲取目標的JVM的程式資料資訊。

下載部署Arthas tunnel server

Github原始碼倉庫下載

下載地址Arthas tunnel server，目前最新版本為arthas-all-3.6.7版本，如下圖所示。

針對於Arthas的安裝包進行下載資料進行介紹：

arthas-3.6.7.deb：主要用於debian作業系統去執行的安裝包
arthas-bin.zip：二進位制可執行執行包
arthas-doc.zip：針對於arthas的文件
arthas-tunnel-server-3.6.7-fatjar.jar：Arthas tunnel server服務的Jar可以執行包
Source code(zip)：原始碼zip壓縮包
Source code(tar.gz)：原始碼tar包

Maven倉庫下載

阿里雲的下載地址：https://arthas.aliyun.com/download/arthas-tunnel-server/latest_version?mirror=aliyun

直接執行對應的Arthas tunnel server

Arthas tunnel server是一個Spring boot fat jar 應用，直接java -jar啟動：

java -jar  arthas-tunnel-server.jar

預設情況下，arthas tunnel server的web埠是8080，Arthas agent 連線的埠是7777

開啟WebConsole，分別輸入Arthas agent的ip(127.0.0.1)和port(7777)，和SpringBoot應用裡配置的agent-id(URJZ5L48RPBR2ALI5K4V)，點Connect即可。

Web Console

如果希望可以透過瀏覽器連線Arthas服務，此時這裡的Arthas服務指的不是Arthas tunnel server，Arthas是總體的服務控制端，傳送指令的部分，而Arthas tunnel server屬於對接和管理agent的專門服務(依賴於Arthas Spring Boot Starter的服務)。

出了CLI模式之外，Arthas目前支援 Web Console，使用者在attach成功之後，可以直接訪問：http://127.0.0.1:8563/。
可以填入 IP，遠端連線其它機器上的arthas。啟動之後，可以訪問 http://127.0.0.1:8080/ ，再透過agentId連線到已註冊的arthas agent 上，如下圖所示。

透過Spring Boot的Endpoint，可以檢視到具體的連線資訊： http://127.0.0.1:8080/actuator/arthas ，

登陸使用者名稱是arthas，密碼在 arthas tunnel server 的日誌裡可以找到，比如：

注意：預設情況下，arthas 只 listen 127.0.0.1，所以如果想從遠端連線，則可以使用 --target-ip引數指定 listen 的 IP，更多參考-h的幫助說明。注意會有安全風險，考慮下面的 tunnel server 的方案。

如何將服務連線Arthas tunnel server

主要有兩種模式連線Arthas tunnel server：

遠端執行的Arthas server連線Arthas tunnel server
遠端執行的Arthas Spring Boot Starter的agent探針服務連線Arthas tunnel server

啟動 arthas 時連線到 tunnel server

在啟動 arthas，可以傳遞--tunnel-server引數，比如：

as.sh --tunnel-server 'ws://127.0.0.1:7777/ws'

如果有特殊需求，可以透過--agent-id引數裡指定 agentId。預設情況下，會生成隨機 ID。attach 成功之後，會列印出 agentId。

  ,---.  ,------. ,--------.,--.  ,--.  ,---.   ,---.
 /  O  \ |  .--. ''--.  .--'|  '--'  | /  O  \ '   .-'
|  .-.  ||  '--'.'   |  |   |  .--.  ||  .-.  |`.  `-.
|  | |  ||  |\  \    |  |   |  |  |  ||  | |  |.-'    |
`--' `--'`--' '--'   `--'   `--'  `--'`--' `--'`-----'

wiki      https://arthas.aliyun.com/doc
tutorials https://arthas.aliyun.com/doc/arthas-tutorials.html
version   3.1.2
pid       86183
time      2022-11-30 15:40:53
id        URJZ5L48RPBR2ALI5K4V

即使是啟動時沒有連線到 tunnel server，也可以在後續自動重連成功之後，透過 session 命令來獲取 agentId：

[arthas@86183]$ session
 Name           Value
-----------------------------------------------------
 JAVA_PID       86183
 SESSION_ID     f7273eb5-e7b0-4a00-bc5b-3fe55d741882
 AGENT_ID       URJZ5L48RPBR2ALI5K4V
 TUNNEL_SERVER  ws://127.0.0.1:7777/ws

在瀏覽器裡訪問 http://localhost:8080/arthas，輸入agentId，就可以連線到本機/其他機器上上的 arthas 了。

tunnel server的注意要點

agentId要保持唯一，否則會在 tunnel server 上衝突，不能正常工作。
如果arthas agent配置了appName，則生成的agentId會帶上appName的字首。

新增對應的app-name引數

啟動引數

as.sh --tunnel-server 'ws://127.0.0.1:7777/ws' --app-name demoapp ，則生成的 agentId 可能是demoapp_URJZ5L48RPBR2ALI5K4V。

Tunnel server 會以_做分隔符，提取出appName，方便按應用進行管理。

配置引數

解壓的 arthas 目錄下的 arthas.properties，或者在 spring boot 應用的application.properties裡配置appName。

Arthas Spring Boot Starter的agent服務連線Jar

只支援 springboot2

maven的倉庫地址：https://search.maven.org/search?q=a:arthas-spring-boot-starter

配置 maven 依賴：

arthas.version:3.6.7

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

應用啟動後，spring 會啟動 arthas，並且 attach 自身程式。如果你不知道如何建立或者引入哪些依賴，可以採用一鍵建立包含 Arthas Spring Boot Starter 的工程：點選跳轉到雲原生腳手架

可以看到最下面已經自動勾選了arthas的監控機制體系。

application.yml配置

arthas:
  agent-name: nihaotest
  agent-id: URJZ5L48RPBR2ALI5K4V  #需手工指定agent-id
  tunnel-server: ws://127.0.0.1:7777/ws

檢視 Endpoint 資訊

需要配置 spring boot 暴露 endpoint：假定endpoint 埠是 8080，則透過下面 url 可以檢視：

http://localhost:8080/actuator/arthas

{
    "arthasConfigMap": {
        "agent-id": "hsehdfsfghhwertyfad",
        "tunnel-server": "ws://47.75.156.201:7777/ws",
    }
}

最後，啟動SpringBoot服務即可。

非 spring boot 應用使用方式

非 Spring Boot 應用，可以透過下面的方式來使用：

 <dependency>
     <groupId>com.taobao.arthas</groupId>
     <artifactId>arthas-agent-attach</artifactId>
     <version>${arthas.version}</version>
 </dependency>
 <dependency>
      <groupId>com.taobao.arthas</groupId>
     <artifactId>arthas-packaging</artifactId>
     <version>${arthas.version}</version>
</dependency>

attach本身的服務進行探針探測。

import com.taobao.arthas.agent.attach.ArthasAgent;
public class ArthasAttachExample {
	public static void main(String[] args) {
		ArthasAgent.attach();
	}
}

也可以配置屬性：

HashMap<String, String> configMap = new HashMap<String, String>();
configMap.put("arthas.appName", "demo");
configMap.put("arthas.tunnelServer", "ws://127.0.0.1:7777/ws");
ArthasAgent.attach(configMap);

Tunnel Server 的管理頁面

需要在 spring boot 的application.properties裡配置 arthas.enable-detail-pages=true

注意，開放管理頁面有風險！管理頁面沒有安全攔截功能，務必自行增加安全措施。

在本地啟動 tunnel-server，然後使用as.sh attach，並且指定應用名--app-name test：

$ as.sh --tunnel-server 'ws://127.0.0.1:7777/ws' --app-name test
telnet connecting to arthas server... current timestamp is 1627539688
Trying 127.0.0.1...
Connected to 127.0.0.1.
Escape character is '^]'.
  ,---.  ,------. ,--------.,--.  ,--.  ,---.   ,---.
 /  O  \ |  .--. ''--.  .--'|  '--'  | /  O  \ '   .-'
|  .-.  ||  '--'.'   |  |   |  .--.  ||  .-.  |`.  `-.
|  | |  ||  |\  \    |  |   |  |  |  ||  | |  |.-'    |
`--' `--'`--' '--'   `--'   `--'  `--'`--' `--'`-----'

wiki       https://arthas.aliyun.com/doc
tutorials  https://arthas.aliyun.com/doc/arthas-tutorials.html
version    3.5.3
main_class demo.MathGame
pid        65825
time       2022-07-29 14:21:29
id         test_PE3LZO9NA9ENJYTPGL9L

然後訪問 tunnel-server，可以看到所有連線的應用列表：

http://localhost:8080/apps.html

再開啟詳情，則可以看到連線的所有 agent 列表：

http://localhost:8080/agents.html?app=test

Spring Cloud實戰系列(八) - 微服務監控Spring Boot Admin
2019-02-05
Cloud微服務Spring Boot
App監控和效能優化實戰
2021-11-19
APP優化
Zabbix實戰--監控Nginx
2020-12-02
Nginx
微服務：指標和健康監控
2022-09-04
微服務指標
Prometheus監控實戰應用
2022-05-04
Prometheus
OpenTelemetry 實戰：gRPC 監控的實現原理
2024-09-04
RPC
RunLoop實戰：實時卡頓監控
2019-04-09
OOP
微服務監控
2018-11-20
微服務
SpringBoot Serverless 實戰 | 監控除錯
2022-02-08
Spring BootServer除錯
Spring Boot應用監控實戰
2018-05-02
Spring Boot
RabbitMQ實戰：介面管理和監控
2018-04-14
MQ
RestCloud監控平臺，專為微服務API打造的實時監控中心
2021-08-18
RESTCloud微服務API
[實戰] Flutter 上的記憶體洩漏監控
2020-06-17
Flutter記憶體
shell實戰之Linux主機系統監控
2019-04-05
Linux
upptime：使用GitHub Actions監控你的網站健康監控
2022-07-05
Github網站
案例實踐丨基於SkyWalking全鏈路監控的微服務系統效能調優實踐篇
2023-09-13
微服務
微服務監控探索
2020-04-04
微服務
效能監控調優
2024-07-06
【Redis實戰專題】「效能監控系列」全方位探索Redis的效能監控以及最佳化指南
2023-01-14
Redis
來！做一個分鐘級業務監控系統【實戰】
2019-07-21
Kustomize 生產實戰-注入監控 APM Agent
2023-03-15
Skywalking微服務監控分析
2019-01-04
微服務
JVM系列(七) – JVM線上監控工具
2019-03-01
JVM
JVM系列(七) - JVM線上監控工具
2018-08-12
JVM
TiDB監控實現--存活監控
2019-08-30
TiDB
愛奇藝微服務監控的探索與實踐
2020-07-15
微服務
go-kit 微服務服務監控 (prometheus 實現)
2020-02-12
Go微服務Prometheus
Sentry 監控 - Snuba 資料中臺本地開發環境配置實戰
2021-12-02
開發環境
10-SpringBoot 工程的健康監控實現
2020-11-09
Spring Boot
微服務架構之「監控系統」
2019-05-21
微服務架構
系統監控&JVM監控指標資料查詢
2022-02-23
JVM指標
APM效能監控軟體的監控型別服務及監控流程
2022-06-08
型別
JVM實戰調優(空格引發的服務異常)
2021-03-12
JVM
vivo 服務端監控體系建設實踐
2023-01-03
服務端
專案實戰：zabbix監控MySQL狀態、服務資訊
2021-09-09
MySql
prometheus JVM監控
2024-05-10
PrometheusJVM
Zabbix 4.0企業級分散式監控實戰
2019-11-08
分散式
WebGL 3D 工業隧道監控實戰
2018-03-26
Web3D