# alibaba/arthas architecture

> Architecture diagram of the GitHub repository alibaba/arthas, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/alibaba/arthas
- Repository: https://github.com/alibaba/arthas

## Overview

Arthas is a live Java diagnostics tool: an engineer attaches to a running JVM, issues commands through an interactive or remote interface, and receives diagnostic results without restarting the application. Its command surface spans class and classloader inspection, decompilation and redefinition, runtime tracing and monitoring, profiling, and heap-object inspection. The repository also includes an MCP server and experimental gRPC/web and tunnel interfaces. The graph uses README and indexed source references; unsampled implementation links are omitted where their wiring is not established.

Main entry points: [`core/src/main/java/com/taobao/arthas/core/command/CommandExecutorImpl.java`](https://github.com/alibaba/arthas/blob/master/core/src/main/java/com/taobao/arthas/core/command/CommandExecutorImpl.java) (Command Execution), [`core/src/main/java/com/taobao/arthas/core/advisor/TransformerManager.java`](https://github.com/alibaba/arthas/blob/master/core/src/main/java/com/taobao/arthas/core/advisor/TransformerManager.java) (Runtime Instrumentation), [`arthas-mcp-server/src/main/java/com/taobao/arthas/mcp/server/protocol/server/McpServer.java`](https://github.com/alibaba/arthas/blob/master/arthas-mcp-server/src/main/java/com/taobao/arthas/mcp/server/protocol/server/McpServer.java) (MCP Server), [`arthas-mcp-server/src/main/java/com/taobao/arthas/mcp/server/CommandExecutor.java`](https://github.com/alibaba/arthas/blob/master/arthas-mcp-server/src/main/java/com/taobao/arthas/mcp/server/CommandExecutor.java) (MCP Commands)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_attach["Attach and Bootstrap"]
  node_boot["Arthas Boot<br/>[Bootstrap.java]"]
  node_agent["Agent Attach<br/>[ArthasAgent.java]"]
end

subgraph group_runtime["Diagnostic Runtime"]
  node_command["Command Execution"]
  node_inspection["Class Inspection"]
  node_instrumentation["Runtime Instrumentation"]
  node_advice["Advice Listeners"]
  node_monitoring["Runtime Monitoring"]
  node_heap["Heap Inspection<br/>[VmTool.java]"]
end

subgraph group_interfaces["Command Interfaces"]
  node_terminal["Interactive Terminal<br/>[TelnetConsole.java]"]
  node_mcp["MCP Server<br/>[McpServer.java]"]
  node_mcpcommand["MCP Commands"]
  node_mcp_session["Command Sessions"]
  node_mcp_tasks["MCP Tasks"]
end

subgraph group_integrations["Remote Integrations"]
  node_grpc_watch["gRPC Watch"]
  node_grpc_objects["gRPC Object Query<br/>[ObjectService.java]"]
  node_tunnel_proxy["Tunnel Proxy"]
end

node_engineer(("Engineer"))
node_target(("Target JVM"))
node_result["Diagnostic Results"]

node_engineer -->|"starts"| node_boot
node_boot -.->|"attaches"| node_agent
node_agent -.->|"loads into"| node_target
node_engineer -->|"issues commands"| node_terminal
node_terminal -.->|"submits commands"| node_command
node_command -.->|"dispatches commands"| node_inspection
node_command -.->|"dispatches commands"| node_monitoring
node_command -.->|"requests enhancement"| node_instrumentation
node_instrumentation -->|"notifies listeners"| node_advice
node_inspection -->|"produces findings"| node_result
node_monitoring -->|"reports metrics"| node_result
node_instrumentation -->|"reports traces"| node_result
node_heap -->|"returns objects"| node_result
node_engineer -.->|"connects"| node_mcp
node_mcp -.->|"routes tool calls"| node_mcpcommand
node_mcpcommand -->|"uses sessions"| node_mcp_session
node_mcp -.->|"supports tasks"| node_mcp_tasks
node_mcpcommand -->|"executes commands"| node_command
node_grpc_watch -->|"registers watch"| node_advice
node_grpc_objects -->|"queries instances"| node_heap
node_grpc_watch -->|"streams events"| node_result
node_tunnel_proxy -->|"returns proxied response"| node_result
node_result -.->|"delivers findings"| node_engineer

click node_boot "https://github.com/alibaba/arthas/blob/master/boot/src/main/java/com/taobao/arthas/boot/Bootstrap.java"
click node_agent "https://github.com/alibaba/arthas/blob/master/arthas-agent-attach/src/main/java/com/taobao/arthas/agent/attach/ArthasAgent.java"
click node_command "https://github.com/alibaba/arthas/blob/master/core/src/main/java/com/taobao/arthas/core/command/CommandExecutorImpl.java"
click node_inspection "https://github.com/alibaba/arthas/tree/master/core/src/main/java/com/taobao/arthas/core/command/klass100"
click node_instrumentation "https://github.com/alibaba/arthas/blob/master/core/src/main/java/com/taobao/arthas/core/advisor/TransformerManager.java"
click node_advice "https://github.com/alibaba/arthas/blob/master/core/src/main/java/com/taobao/arthas/core/advisor/AdviceListenerManager.java"
click node_monitoring "https://github.com/alibaba/arthas/tree/master/core/src/main/java/com/taobao/arthas/core/command/monitor200"
click node_heap "https://github.com/alibaba/arthas/blob/master/arthas-vmtool/src/main/java/arthas/VmTool.java"
click node_terminal "https://github.com/alibaba/arthas/blob/master/client/src/main/java/com/taobao/arthas/client/TelnetConsole.java"
click node_mcp "https://github.com/alibaba/arthas/blob/master/arthas-mcp-server/src/main/java/com/taobao/arthas/mcp/server/protocol/server/McpServer.java"
click node_mcpcommand "https://github.com/alibaba/arthas/blob/master/arthas-mcp-server/src/main/java/com/taobao/arthas/mcp/server/CommandExecutor.java"
click node_mcp_session "https://github.com/alibaba/arthas/blob/master/arthas-mcp-server/src/main/java/com/taobao/arthas/mcp/server/session/ArthasCommandSessionManager.java"
click node_mcp_tasks "https://github.com/alibaba/arthas/blob/master/arthas-mcp-server/src/main/java/com/taobao/arthas/mcp/server/task/DefaultTaskManager.java"
click node_grpc_watch "https://github.com/alibaba/arthas/blob/master/labs/arthas-grpc-web-proxy/src/main/java/com/taobao/arthas/grpcweb/grpc/service/WatchCommandService.java"
click node_grpc_objects "https://github.com/alibaba/arthas/blob/master/labs/arthas-grpc-web-proxy/src/main/java/com/taobao/arthas/grpcweb/grpc/service/ObjectService.java"
click node_tunnel_proxy "https://github.com/alibaba/arthas/blob/master/tunnel-server/src/main/java/com/alibaba/arthas/tunnel/server/app/web/ProxyController.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_boot,node_agent toneBlue
class node_command,node_inspection,node_instrumentation,node_advice,node_monitoring,node_heap toneAmber
class node_terminal,node_mcp,node_mcpcommand,node_mcp_session,node_mcp_tasks toneMint
class node_grpc_watch,node_grpc_objects,node_tunnel_proxy toneRose
class node_engineer,node_target,node_result toneIndigo
```

## Components

### Attach and Bootstrap

- [Arthas Boot](https://github.com/alibaba/arthas/blob/master/boot/src/main/java/com/taobao/arthas/boot/Bootstrap.java): `boot/src/main/java/com/taobao/arthas/boot/Bootstrap.java`
- [Agent Attach](https://github.com/alibaba/arthas/blob/master/arthas-agent-attach/src/main/java/com/taobao/arthas/agent/attach/ArthasAgent.java): `arthas-agent-attach/src/main/java/com/taobao/arthas/agent/attach/ArthasAgent.java`

### Diagnostic Runtime

- [Command Execution](https://github.com/alibaba/arthas/blob/master/core/src/main/java/com/taobao/arthas/core/command/CommandExecutorImpl.java): `core/src/main/java/com/taobao/arthas/core/command/CommandExecutorImpl.java`
- [Class Inspection](https://github.com/alibaba/arthas/tree/master/core/src/main/java/com/taobao/arthas/core/command/klass100): `core/src/main/java/com/taobao/arthas/core/command/klass100`
- [Runtime Instrumentation](https://github.com/alibaba/arthas/blob/master/core/src/main/java/com/taobao/arthas/core/advisor/TransformerManager.java): `core/src/main/java/com/taobao/arthas/core/advisor/TransformerManager.java`
- [Advice Listeners](https://github.com/alibaba/arthas/blob/master/core/src/main/java/com/taobao/arthas/core/advisor/AdviceListenerManager.java): `core/src/main/java/com/taobao/arthas/core/advisor/AdviceListenerManager.java`
- [Runtime Monitoring](https://github.com/alibaba/arthas/tree/master/core/src/main/java/com/taobao/arthas/core/command/monitor200): `core/src/main/java/com/taobao/arthas/core/command/monitor200`
- [Heap Inspection](https://github.com/alibaba/arthas/blob/master/arthas-vmtool/src/main/java/arthas/VmTool.java): `arthas-vmtool/src/main/java/arthas/VmTool.java`

### Command Interfaces

- [Interactive Terminal](https://github.com/alibaba/arthas/blob/master/client/src/main/java/com/taobao/arthas/client/TelnetConsole.java): `client/src/main/java/com/taobao/arthas/client/TelnetConsole.java`
- [MCP Server](https://github.com/alibaba/arthas/blob/master/arthas-mcp-server/src/main/java/com/taobao/arthas/mcp/server/protocol/server/McpServer.java): `arthas-mcp-server/src/main/java/com/taobao/arthas/mcp/server/protocol/server/McpServer.java`
- [MCP Commands](https://github.com/alibaba/arthas/blob/master/arthas-mcp-server/src/main/java/com/taobao/arthas/mcp/server/CommandExecutor.java): `arthas-mcp-server/src/main/java/com/taobao/arthas/mcp/server/CommandExecutor.java`
- [Command Sessions](https://github.com/alibaba/arthas/blob/master/arthas-mcp-server/src/main/java/com/taobao/arthas/mcp/server/session/ArthasCommandSessionManager.java): `arthas-mcp-server/src/main/java/com/taobao/arthas/mcp/server/session/ArthasCommandSessionManager.java`
- [MCP Tasks](https://github.com/alibaba/arthas/blob/master/arthas-mcp-server/src/main/java/com/taobao/arthas/mcp/server/task/DefaultTaskManager.java): `arthas-mcp-server/src/main/java/com/taobao/arthas/mcp/server/task/DefaultTaskManager.java`

### Remote Integrations

- [gRPC Watch](https://github.com/alibaba/arthas/blob/master/labs/arthas-grpc-web-proxy/src/main/java/com/taobao/arthas/grpcweb/grpc/service/WatchCommandService.java): `labs/arthas-grpc-web-proxy/src/main/java/com/taobao/arthas/grpcweb/grpc/service/WatchCommandService.java`
- [gRPC Object Query](https://github.com/alibaba/arthas/blob/master/labs/arthas-grpc-web-proxy/src/main/java/com/taobao/arthas/grpcweb/grpc/service/ObjectService.java): `labs/arthas-grpc-web-proxy/src/main/java/com/taobao/arthas/grpcweb/grpc/service/ObjectService.java`
- [Tunnel Proxy](https://github.com/alibaba/arthas/blob/master/tunnel-server/src/main/java/com/alibaba/arthas/tunnel/server/app/web/ProxyController.java): `tunnel-server/src/main/java/com/alibaba/arthas/tunnel/server/app/web/ProxyController.java`

### Other components

- **Engineer**
- **Target JVM**
- **Diagnostic Results**

## Connections

- Engineer → Arthas Boot: starts
- Arthas Boot → Agent Attach: attaches
- Agent Attach → Target JVM: loads into
- Engineer → Interactive Terminal: issues commands
- Interactive Terminal → Command Execution: submits commands
- Command Execution → Class Inspection: dispatches commands
- Command Execution → Runtime Monitoring: dispatches commands
- Command Execution → Runtime Instrumentation: requests enhancement
- Runtime Instrumentation → Advice Listeners: notifies listeners (evidence: `core/src/main/java/com/taobao/arthas/core/advisor/AdviceListenerManager.java`)
- Class Inspection → Diagnostic Results: produces findings
- Runtime Monitoring → Diagnostic Results: reports metrics
- Runtime Instrumentation → Diagnostic Results: reports traces
- Heap Inspection → Diagnostic Results: returns objects
- Engineer → MCP Server: connects
- MCP Server → MCP Commands: routes tool calls
- MCP Commands → Command Sessions: uses sessions (evidence: `arthas-mcp-server/src/main/java/com/taobao/arthas/mcp/server/session/ArthasCommandSessionManager.java`)
- MCP Server → MCP Tasks: supports tasks
- MCP Commands → Command Execution: executes commands
- gRPC Watch → Advice Listeners: registers watch
- gRPC Object Query → Heap Inspection: queries instances (evidence: `labs/arthas-grpc-web-proxy/src/main/java/com/taobao/arthas/grpcweb/grpc/service/ObjectService.java`)
- gRPC Watch → Diagnostic Results: streams events (evidence: `labs/arthas-grpc-web-proxy/src/main/java/com/taobao/arthas/grpcweb/grpc/service/WatchCommandService.java`)
- Tunnel Proxy → Diagnostic Results: returns proxied response (evidence: `tunnel-server/src/main/java/com/alibaba/arthas/tunnel/server/app/web/ProxyController.java`)
- Diagnostic Results → Engineer: delivers findings
