Skip to content

Commit a227e40

Browse files
authored
Merge pull request #36 from PerfMa/iteration/2.1.1-RELEASE
Iteration/2.1.1 release
2 parents d7fcd8d + 42f11e6 commit a227e40

File tree

33 files changed

+509
-467
lines changed

33 files changed

+509
-467
lines changed

README

Lines changed: 0 additions & 258 deletions
This file was deleted.

README.md

Lines changed: 29 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@
2222
* [XPocket plugin Perf](https://github.com/PerfMa/xpocket-plugin-perf)
2323
* [XPocket plugin Arthas](https://github.com/PerfMa/xpocket-plugin-arthas)
2424
* [XPocket plugin VJMap](https://github.com/PerfMa/xpocket-plugin-vjmap)
25-
* [XPocket plugin VJMap](https://github.com/PerfMa/xpocket-plugin-vjtop)
25+
* [XPocket plugin VJTop](https://github.com/PerfMa/xpocket-plugin-vjtop)
2626

2727

2828
## XPocket在线教程
@@ -49,11 +49,11 @@ cd simulator
4949
sh run.sh
5050
```
5151

52-
### 2.下载xpocket,然后解压并运行(注:如果您当前的jdk版本大于jdk8,请使用xpocket_jdk9+.sh)
52+
### 2.下载xpocket,然后解压并运行
5353
```bash
5454
wget https://a.perfma.net/xpocket/download/XPocket.tar.gz
5555
tar -xvf XPocket.tar.gz
56-
sh xpocket/xpocket_jdk8.sh
56+
sh xpocket/xpocket.sh
5757
```
5858
启动成功后如下所示
5959
![plugins](resourse/start.png)
@@ -109,6 +109,24 @@ XPocket退出插件的方式很简单,只需要使用命令 `cd` 即可,cd
109109

110110
![quit](resourse/quit.jpg)
111111

112+
## 运行模式
113+
### 1. telnet server模式
114+
```bash
115+
sh xpocket.sh -run_mode telnet -port 9527
116+
```
117+
- 该模式会启动一个静默模式的XPocket,以对应端口的Telnet Server接受外部链接并使用,适用于远程执行操作的场景。
118+
119+
### 2. run once 模式
120+
```bash
121+
sh xpocket.sh -run_mode once "echo test"
122+
```
123+
- 该模式是启动XPocket运行完指定命令以后直接退出,适用于外部调用完成单次操作的场景。
124+
125+
### 3. Java Agent模式
126+
```bash
127+
sh xpocket.sh -run_mode agent-launcher -pid 1 -port 9527
128+
```
129+
- 该模式与telnet模式类似,但是是将XPocket整体作为一个Java Agent挂载到目标进程上运行,适用于容器类场景,并且可以获取更多JVM运行时信息。
112130

113131
## 插件开发
114132
详情请见[开发者指南](https://xpocket.perfma.com/docs/developer/)
@@ -129,7 +147,7 @@ Tips:
129147
```
130148
更多操作以及介绍请参考[官方介绍](https://docs.oracle.com/javase/jp/8/docs/serviceabilityagent/sun/jvm/hotspot/HSDB.html)
131149

132-
[github](https://github.com/perfma/xpocket-plugin-hsdb)
150+
[插件仓库](https://github.com/perfma/xpocket-plugin-hsdb)
133151

134152
[插件概况](https://plugin.xpocket.perfma.com/plugin/54)
135153

@@ -151,7 +169,7 @@ Java调试器(JDB)是Java类在命令行中调试程序的工具, 它实
151169
```
152170
更多操作以及介绍请参考[官方介绍](https://docs.oracle.com/javase/8/docs/technotes/tools/windows/jdb.html)
153171

154-
[github](https://github.com/perfma/xpocket-plugin-jdb)
172+
[插件仓库](https://github.com/perfma/xpocket-plugin-jdb)
155173

156174
[插件概况](https://plugin.xpocket.perfma.com/plugin/56)
157175

@@ -186,7 +204,7 @@ analyze -p [pid] (-p 指定进程采集热点)
186204
analyze -detail 查看进程CPU热点抓取结果
187205
同时支持perf原生的命令和参数,并且针对java程序集成了perf-map-agent 这个工具,可以协助显示java的调用栈信息.具体使用方式见命令的帮助信息(如 help analyze)
188206

189-
[github](https://github.com/perfma/xpocket-plugin-perf)
207+
[插件仓库](https://github.com/perfma/xpocket-plugin-perf)
190208

191209
[插件概况](https://plugin.xpocket.perfma.com/plugin/57)
192210

@@ -205,7 +223,8 @@ Arthas 是Alibaba开源的Java诊断工具,深受开发者喜爱,支持JDK 6
205223

206224
XPocket管控了Arthas在attach进程之前的输入输出,attach之后的具体使用请参考[Arthas官方文档](https://arthas.aliyun.com/doc/)
207225

208-
[github](https://github.com/alibaba/arthas)
226+
[Arthas](https://github.com/alibaba/arthas)
227+
[插件仓库](https://github.com/perfma/xpocket-plugin-arthas)
209228

210229
[插件概况](https://plugin.xpocket.perfma.com/plugin/52)
211230

@@ -225,7 +244,7 @@ JConsole 是一个内置Java性能分析器,用于对JVM中内存,线程和
225244

226245
注:插件化后的JConsole相比gui版本的JConsole在显示与操作上有所区别,但是数据的采集方式是一样的。
227246

228-
[github](https://github.com/perfma/xpocket-plugin-jconsole)
247+
[插件仓库](https://github.com/perfma/xpocket-plugin-jconsole)
229248

230249
[插件概况](https://plugin.xpocket.perfma.com/plugin/55)
231250

@@ -263,7 +282,8 @@ vjmap的原始思路来源于R大的TBJMap ,翻新后支持JDK8,支持Surviv
263282
264283
```
265284

266-
[github](https://github.com/vipshop/vjtools/tree/master/vjmap)
285+
[VJMap](https://github.com/vipshop/vjtools/tree/master/vjmap)
286+
[插件仓库](https://github.com/perfma/xpocket-plugin-vjmap)
267287

268288
[插件概况](https://plugin.xpocket.perfma.com/plugin/58)
269289

0 commit comments

Comments
 (0)