How alibaba/arthas works
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: CommandExecutorImpl.java Command Execution · TransformerManager.java Runtime Instrumentation · McpServer.java MCP Server · CommandExecutor.java MCP Commands
Components 19
Attach and Bootstrap
- Arthas Boot
boot/src/main/java/com/taobao/arthas/boot/Bootstrap.java - Agent Attach
arthas-agent-attach/src/main/java/com/taobao/arthas/agent/attach/ArthasAgent.java
Diagnostic Runtime
- Command Execution
core/src/main/java/com/taobao/arthas/core/command/CommandExecutorImpl.java - Class Inspection
core/src/main/java/com/taobao/arthas/core/command/klass100 - Runtime Instrumentation
core/src/main/java/com/taobao/arthas/core/advisor/TransformerManager.java - Advice Listeners
core/src/main/java/com/taobao/arthas/core/advisor/AdviceListenerManager.java - Runtime Monitoring
core/src/main/java/com/taobao/arthas/core/command/monitor200 - Heap Inspection
arthas-vmtool/src/main/java/arthas/VmTool.java
Command Interfaces
- Interactive Terminal
client/src/main/java/com/taobao/arthas/client/TelnetConsole.java - MCP Server
arthas-mcp-server/src/main/java/com/taobao/arthas/mcp/server/protocol/server/McpServer.java - MCP Commands
arthas-mcp-server/src/main/java/com/taobao/arthas/mcp/server/CommandExecutor.java - Command Sessions
arthas-mcp-server/src/main/java/com/taobao/arthas/mcp/server/session/ArthasCommandSessionManager.java - MCP Tasks
arthas-mcp-server/src/main/java/com/taobao/arthas/mcp/server/task/DefaultTaskManager.java
Remote Integrations
- gRPC Watch
labs/arthas-grpc-web-proxy/src/main/java/com/taobao/arthas/grpcweb/grpc/service/WatchCommandService.java - gRPC Object Query
labs/arthas-grpc-web-proxy/src/main/java/com/taobao/arthas/grpcweb/grpc/service/ObjectService.java - Tunnel Proxy
tunnel-server/src/main/java/com/alibaba/arthas/tunnel/server/app/web/ProxyController.java
Other components
- Engineer
- Target JVM
- Diagnostic Results
Connections 23
- 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
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
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
labs/arthas-grpc-web-proxy/src/main/java/com/taobao/arthas/grpcweb/grpc/service/ObjectService.java - gRPC Watch → Diagnostic Results: streams events
labs/arthas-grpc-web-proxy/src/main/java/com/taobao/arthas/grpcweb/grpc/service/WatchCommandService.java - Tunnel Proxy → Diagnostic Results: returns proxied response
tunnel-server/src/main/java/com/alibaba/arthas/tunnel/server/app/web/ProxyController.java - Diagnostic Results → Engineer: delivers findings