所有插件

BistouryisaJavaDiagnostictoolopensourcedbyQunar。

插件信息：|名称|大小|版本|更新时间|支持系统||-|-|-|-|-||pstack_chen|0.1M|1.0.0|2021/8/13|Linux|插件简介：pstack_chen插件用于执行pstack命令，可以打印正在运行的进程的栈跟踪信息。在排查进程问题时非常有用，比如我们发现一个服务一直处于work状态（如假死状态，好似死循环）等。此命令允许使用的唯一选项是要检查的进程的PID。注意，使用该插件时系统须有安装pstack工具，安装gdb会自带安装pstack。使用说明:```pstackprocess-id参数为进程的pid```比如我们想看一下nginx的调用栈，先试用ps,或者pstree拿到nginx的进程pid，让后通过pstackpid查看进程运行的调用栈```$pstree-p├─nginx17546─┬─nginx17605│└─nginx17606XPocket[pstack]>pstack1760500x00007f7a22306e43in__epoll_wait_nocancelfrom/lib64/libc.so.610x0000000000437a38inngx_epoll_process_eventscycle=0x24e2fb0,timer=18446744073709551615,flags=1atsrc/event/modules/ngx_epoll_module.c:80020x000000000042f5c8inngx_process_events_and_timerscycle=cycle@entry=0x24e2fb0atsrc/event/ngx_event.c:24230x0000000000435fc4inngx_worker_process_cyclecycle=0x24e2fb0,data=<optimizedout>atsrc/os/unix/ngx_process_cycle.c:75040x00000000004346f2inngx_spawn_processcycle=cycle@entry=0x24e2fb0,proc=proc@entry=0x435f53<ngx_worker_process_cycle>,data=data@entry=0x0,name=name@entry=0x4b1f8d"workerprocess",respawn=respawn@entry=-4atsrc/os/unix/ngx_process.c:19950x000000000043528binngx_start_worker_processescycle=cycle@entry=0x24e2fb0,n=2,type=type@entry=-4atsrc/os/unix/ngx_process_cycle.c:35960x0000000000436cd8inngx_master_process_cyclecycle=0x24e2fb0,cycle@entry=0x24defa0atsrc/os/unix/ngx_process_cycle.c:24470x0000000000412295inmainargc=<optimizedout>,argv=<optimizedout>atsrc/core/nginx.c:382```pstack不仅可以查看c/c++调用栈，还可以查看其他语言例如pyton,php的调用栈```XPocket[pstack]>pstack1885800x00007fd12bc87980in__accept_nocancelfrom/lib64/libpthread.so.010x00007fd124a6cabdinsock_acceptfrom/usr/lib64/python2.7/lib-dynload/_socketmodule.so20x00007fd12bf7993cinPyEval_EvalFrameExfrom/lib64/libpython2.7.so.1.030x00007fd12bf7957dinPyEval_EvalFrameExfrom/lib64/libpython2.7.so.1.040x00007fd12bf7befdinPyEval_EvalCodeExfrom/lib64/libpython2.7.so.1.050x00007fd12bf7c002inPyEval_EvalCodefrom/lib64/libpython2.7.so.1.060x00007fd12bf9543finrun_modfrom/lib64/libpython2.7.so.1.070x00007fd12bf965feinPyRun_FileExFlagsfrom/lib64/libpython2.7.so.1.080x00007fd12bf97889inPyRun_SimpleFileExFlagsfrom/lib64/libpython2.7.so.1.090x00007fd12bfa8a3finPy_Mainfrom/lib64/libpython2.7.so.1.0100x00007fd12b1c4505in__libc_start_mainfrom/lib64/libc.so.6110x000000000040071ein_start```其他tips:使用依赖系统已经安装了pstack和gdb程序

GarbageCatXPocket插件，提供了离线GC日志分析功能，后续会慢慢对功能进行增强。

插件信息：|名称|大小|版本|更新时间|支持系统||-|-|-|-|-||sysbench|0.1M|0.0.1|2021/7/13|Linux|插件简介：依赖系统本地的sysbench工具执行，具体模块取决于系统sysbench编译所使用模块可使用sysbench--help获取帮助信息，使用sysbench[testname]--help获取具体test项的帮助sysbench项目仓库https://github.com/akopytov/sysbench

插件信息：|名称|大小|版本|更新时间|支持系统||-|-|-|-|-||ab_x|0.1M|0.0.1|2021/7/13|Linux|插件简介：依赖系统本身的ab命令，如不存在需要用户进行安装，ab命令集成于apachehttpd中，https://httpd.apache.org/简单使用ab-n5https://baidu.com/,即对baidu.com访问5次，并输出统计信息可以通过ab-h来获取详细帮助信息

openmessaging-benchmark是一个压测工具，使用此压测工具可对部署在云上的分布式消息系统进行压测。

插件信息：|名称|大小|版本|更新时间|支持系统||-|-|-|-|-||vmstat|0.1M|1.0.0|2020/7/6|Linux|插件简介：vmstat（VirtualMeomoryStatistics，虚拟内存统计）是Linux中监控内存的常用工具，可对操作系统的虚拟内存、进程、CPU等的整体情况进行监视使用说明：使用语法:vmstat[-V][-n][delay[count]]```-V：显示vmstat版本信息。-n：只在开始时显示一次各字段名称。-a：显示活跃和非活跃内存-d：显示磁盘相关统计信息。-p：显示指定磁盘分区统计信息-s：显示内存相关统计信息及多种系统活动数量。-m：显示slabinfo-S：使用指定单位显示。参数有k、K、m、M，分别代表1000、1024、1000000、1048576字节（byte）。默认单位为K（1024bytes）-f：显示从系统启动至今的fork数量。delay：刷新时间间隔。count：刷新次数。如果不指定刷新次数，但指定了刷新时间间隔，这时刷新次数为无穷。```首先看一个vmstat2命令，表示每隔两秒钟采集一次：```XPocket[vmstat]>vmstat2--------------------------------------------------------------------CurrentExecution:vmstat.vmstat@MAZHI2CurrentPlugin:vmstat@MAZHI-------------------------------procs-----------memory-------------swap-------io-----system--------cpu-----rbswpdfreebuffcachesisobiboincsussyidwast2026814824407116468002201109900202681482120711646800010220022450050003026814821207116468000021952205005000```输出栏如下：```Processprocsr:等待运行时间的进程数b:处于不可中断睡眠状态的进程数w:被交换出去的看一下的进程数。此数是由linux计算得出的，但是Linux并不好进交换空间Memoryswpd:虚拟内存使用量KBfree:空闲内存量KBbuffer:用作buffer的内存量KBcache:用作cache的内存量（KBSwapsi:从硬盘交换到内存的数量（KBps）so:交换到硬盘的内存量（KBps）IObi:发送到块设备的块的数量block/sbo:从块设备获取的块的数量（block/s）Systemin:每秒钟的中断数量，包括时钟中断cs:每秒钟上下文交换的数量CPU整个CPU时间的百分比）us:花费在非内核代码的CPU时间用户时间，包括Nice时间）sy:花费在内核代码的CPU时间（系统时间）id:空闲时间wa:IO等待时间```

插件信息：|名称|大小|版本|更新时间|支持系统||-|-|-|-|-||pstack|0.1M|1.0.4|2021/8/6|Linux|插件简介:xpocket将pstack作为插件集成了进来,作为获取进程调用栈的好用的工具,pstack可以很方便的获取进程的调用栈信息在/proc/pid/stack中可以看到进程的调用栈不过只包含内核调用栈部分.ps依赖gdb的bt命令，所以获取到的调用栈符号信息还是非常准确的，当程序出现死循环，死锁，莫名的挂在某一地方无法响应请求等等情况下，可以通过pstack命令看看进程当前状态使用说明:```pstackprocess-id参数为进程的pid```比如我们想看一下nginx的调用栈，先试用ps,或者pstree拿到nginx的进程pid，让后通过pstackpid查看进程运行的调用栈```$pstree-p├─nginx17546─┬─nginx17605│└─nginx17606XPocket[pstack]>pstack1760500x00007f7a22306e43in__epoll_wait_nocancelfrom/lib64/libc.so.610x0000000000437a38inngx_epoll_process_eventscycle=0x24e2fb0,timer=18446744073709551615,flags=1atsrc/event/modules/ngx_epoll_module.c:80020x000000000042f5c8inngx_process_events_and_timerscycle=cycle@entry=0x24e2fb0atsrc/event/ngx_event.c:24230x0000000000435fc4inngx_worker_process_cyclecycle=0x24e2fb0,data=<optimizedout>atsrc/os/unix/ngx_process_cycle.c:75040x00000000004346f2inngx_spawn_processcycle=cycle@entry=0x24e2fb0,proc=proc@entry=0x435f53<ngx_worker_process_cycle>,data=data@entry=0x0,name=name@entry=0x4b1f8d"workerprocess",respawn=respawn@entry=-4atsrc/os/unix/ngx_process.c:19950x000000000043528binngx_start_worker_processescycle=cycle@entry=0x24e2fb0,n=2,type=type@entry=-4atsrc/os/unix/ngx_process_cycle.c:35960x0000000000436cd8inngx_master_process_cyclecycle=0x24e2fb0,cycle@entry=0x24defa0atsrc/os/unix/ngx_process_cycle.c:24470x0000000000412295inmainargc=<optimizedout>,argv=<optimizedout>atsrc/core/nginx.c:382```pstack不仅可以查看c/c++调用栈，还可以查看其他语言例如pyton,php的调用栈```XPocket[pstack]>pstack1885800x00007fd12bc87980in__accept_nocancelfrom/lib64/libpthread.so.010x00007fd124a6cabdinsock_acceptfrom/usr/lib64/python2.7/lib-dynload/_socketmodule.so20x00007fd12bf7993cinPyEval_EvalFrameExfrom/lib64/libpython2.7.so.1.030x00007fd12bf7957dinPyEval_EvalFrameExfrom/lib64/libpython2.7.so.1.040x00007fd12bf7befdinPyEval_EvalCodeExfrom/lib64/libpython2.7.so.1.050x00007fd12bf7c002inPyEval_EvalCodefrom/lib64/libpython2.7.so.1.060x00007fd12bf9543finrun_modfrom/lib64/libpython2.7.so.1.070x00007fd12bf965feinPyRun_FileExFlagsfrom/lib64/libpython2.7.so.1.080x00007fd12bf97889inPyRun_SimpleFileExFlagsfrom/lib64/libpython2.7.so.1.090x00007fd12bfa8a3finPy_Mainfrom/lib64/libpython2.7.so.1.0100x00007fd12b1c4505in__libc_start_mainfrom/lib64/libc.so.6110x000000000040071ein_start```其他tips:使用依赖系统已经安装了pstack和gdb程序

插件信息：|名称|大小|版本|更新时间|支持系统||-|-|-|-|-||df|0.1M|1.0.6|2021/7/13|Linux|插件简介：集成linux集成命令df，df命令的英文全称即“DiskFree”，顾名思义功能是用于显示系统上可使用的磁盘空间。默认显示单位为KB，建议使用“df-h”的参数组合，根据磁盘容量自动变换合适的单位，更利于阅读。日常普遍用该命令可以查看磁盘被占用了多少空间、还剩多少空间等信息。使用说明：常用参数：```-a显示所有系统文件-B<块大小>指定显示时的块大小-h以容易阅读的方式显示-H以1000字节为换算单位来显示-i显示索引字节信息-k指定块大小为1KB-l只显示本地文件系统-t<文件系统类型>只显示指定类型的文件系统-T输出时显示文件系统类型---sync在取得磁盘使用信息前，先执行sync命```以容易阅读的方式显示磁盘分区使用情况：```XPocket[df]>df-h--------------------------------------------------------------------CurrentExecution:df.df@LINUX-hCurrentPlugin:df@LINUX-------------------------------FilesystemSizeUsedAvailUse%Mountedon/dev/mapper/centos-root50G25G26G49%/devtmpfs3.9G03.9G0%/devtmpfs3.9G03.9G0%/dev/shmtmpfs3.9G73M3.8G2%/runtmpfs3.9G03.9G0%/sys/fs/cgroup/dev/vda11014M143M872M15%/boot/dev/mapper/centos-home42G32G9.6G77%/homeoverlay50G25G26G49%/var/lib/docker/overlay2/dc7281d906ed3a311307184293dd0c92939d79d3745582bffbd7a8812e1ed1f3/mergedtmpfs783M0783M0%/run/user/0--------------------------------------------------------------------XPocket[df]>```

插件信息：|名称|大小|版本|更新时间|支持系统||-|-|-|-|-||ss|0.1M|1.0.1|2021/9/1|Linux|插件简介:ss可以用来获取socket统计信息，它可以显示和netstat类似的内容。但ss的优势在于它能够显示更多更详细的有关tcp和连接状态的信息，而且比netstat更快速更高效.使用说明:-r,--resolveresolvehostnames-a,--alldisplayallsockets-l,--listeningdisplaylisteningsockets-o,--optionsshowtimerinformation-e,--extendedshowdetailedsocketinformation-m,--memoryshowsocketmemoryusage-p,--processesshowprocessusingsocket-i,--infoshowinternalTCPinformation-s,--summaryshowsocketusagesummary-b,--bpfshowbpffiltersocketinformation-Z,--contextdisplayprocessSELinuxsecuritycontexts-z,--contextsdisplayprocessandsocketSELinuxsecuritycontexts-N,--netswitchtothespecifiednetworknamespacename-4,--ipv4displayonlyIPversion4sockets-6,--ipv6displayonlyIPversion6sockets-0,--packetdisplayPACKETsockets-t,--tcpdisplayonlyTCPsockets-S,--sctpdisplayonlySCTPsockets-u,--udpdisplayonlyUDPsockets-d,--dccpdisplayonlyDCCPsockets-w,--rawdisplayonlyRAWsockets-x,--unixdisplayonlyUnixdomainsockets-f,--family=FAMILYdisplaysocketsoftypeFAMILY例如如果想查看当前tcp连接的详细信息可以通过ss-ta来查看```XPocket[ss]>ss-taStateRecv-QSend-QLocalAddress:PortPeerAddress:PortLISTEN0128:http:LISTEN0128:ssh:LISTEN0100127.0.0.1:smtp:LISTEN0128:vcom-tunnel:ESTAB036192.168.0.83:ssh172.16.2.136:54294ESTAB00192.168.0.83:ssh172.16.2.136:54299ESTAB00192.168.0.83:ssh172.16.2.136:54293ESTAB00192.168.0.83:ssh172.16.2.136:54296ESTAB00192.168.0.83:ssh172.16.2.136:54331LISTEN0128:::http:::LISTEN0128:::ssh:::LISTEN0100::1:smtp:::```需要tcp的详细信息例如cwndrtt等信息在则需要加上-i选项```XPocket[ss]>ss-tiStateRecv-QSend-QLocalAddress:PortPeerAddress:PortESTAB036192.168.0.83:ssh172.16.2.136:54294cubicwscale:6,7rto:207rtt:6.199/3.179ato:40mss:1448cwnd:6ssthresh:4bytes_acked:47609bytes_received:6517segs_out:183segs_in:267send11.2Mbpslastsnd:1lastrcv:2lastack:2pacing_rate22.4Mbpsunacked:1retrans:0/4rcv_rtt:9rcv_space:28960ESTAB00192.168.0.83:ssh172.16.2.136:54299cubicwscale:6,7rto:205rtt:4.383/1.111ato:47mss:1448cwnd:10bytes_acked:2897bytes_received:2533segs_out:19segs_in:24send26.4Mbpslastsnd:10415390lastrcv:10415390lastack:3190394pacing_rate52.9Mbpsrcv_rtt:7rcv_space:28960ESTAB00192.168.0.83:ssh172.16.2.136:54293cubicwscale:6,7rto:205rtt:4.6/0.673ato:53mss:1448cwnd:10bytes_acked:21713bytes_received:6681segs_out:174segs_in:279send25.2Mbpslastsnd:8922828lastrcv:8922949lastack:1719975pacing_rate50.4Mbpsrcv_rtt:8rcv_space:28960ESTAB00192.168.0.83:ssh172.16.2.136:54296cubicwscale:6,7rto:205rtt:4.789/1.301ato:40mss:1448cwnd:10bytes_acked:2897bytes_received:2533segs_out:21segs_in:23send24.2Mbpslastsnd:10418464lastrcv:10418464lastack:3206821pacing_rate48.4Mbpsrcv_rtt:8rcv_space:28960ESTAB00192.168.0.83:ssh172.16.2.136:54331cubicwscale:6,7rto:206rtt:5.366/2.075ato:40mss:1448cwnd:10bytes_acked:2897bytes_received:2533segs_out:21segs_in:24send21.6Mbpslastsnd:10412097lastrcv:10412098lastack:3190394pacing_rate43.2Mbpsrcv_rtt:29rcv_space:28960```

插件信息：|名称|大小|版本|更新时间|支持系统||-|-|-|-|-||iostat|0.1M|1.1|2021/7/1|Linux|插件简介：iostat主要用于监控系统设备的IO负载情况，iostat首次运行时显示自系统启动开始的各项统计信息，之后运行iostat将显示自上次运行该命令以后的统计信息。用户可以通过指定统计的次数和时间来获得所需的统计信息。使用说明：```-C显示CPU使用情况-d显示磁盘使用情况-k以KB为单位显示-m以M为单位显示-N显示磁盘阵列LVM信息-n显示NFS使用情况-p[磁盘]显示磁盘和分区的情况-t显示终端和CPU的信息-x显示详细信息-V显示版本信息```显示所有设备负载情况：```XPocket[iostat]>iostat--------------------------------------------------------------------CurrentExecution:iostat.iostat@LINUXCurrentPlugin:iostat@LINUX-------------------------------Linux3.10.0-693.el7.x86_64xinglu-12310/18/2021_x86_64_4CPUavg-cpu:%user%nice%system%iowait%steal%idle1.050.000.010.000.0098.93Device:tpskB_read/skB_wrtn/skB_readkB_wrtnvda0.686.009.583786313360454874dm-00.120.271.2617064077965601dm-10.000.000.002400280dm-20.565.728.323612168252486564--------------------------------------------------------------------```cpu属性值说明：```%user：CPU处在用户模式下的时间百分比。%nice：CPU处在带NICE值的用户模式下的时间百分比。%system：CPU处在系统模式下的时间百分比。%iowait：CPU等待输入输出完成时间的百分比。%steal：管理程序维护另一个虚拟处理器时，虚拟CPU的无意识等待时间百分比。%idle：CPU空闲时间百分比。```disk属性值说明：```rrqm/s:每秒进行merge的读操作数目。即rmerge/swrqm/s:每秒进行merge的写操作数目。即wmerge/sr/s:每秒完成的读I/O设备次数。即rio/sw/s:每秒完成的写I/O设备次数。即wio/srsec/s:每秒读扇区数。即rsect/swsec/s:每秒写扇区数。即wsect/srkB/s:每秒读K字节数。是rsect/s的一半，因为每扇区大小为512字节。wkB/s:每秒写K字节数。是wsect/s的一半。avgrq-sz:平均每次设备I/O操作的数据大小扇区。avgqu-sz:平均I/O队列长度。await:平均每次设备I/O操作的等待时间毫秒。svctm:平均每次设备I/O操作的服务时间毫秒。%util:一秒中有百分之多少的时间用于I/O操作，即被io消耗的cpu百分比```

插件信息：|名称|大小|版本|更新时间|支持系统||-|-|-|-|-||useful-scripts|0.1M|1.0|2021/8/13|Linux|插件简介：useful-scriptsXPocket集成版，不过只保留了部分功能。把平时有用的手动操作做成脚本，以便捷地使用，包含java和shell脚本。脚本列表：```uq:不重排序输入完成整个输入行的去重。相比系统的`uniq`命令加强的是可以跨行去重，不需要排序输入。apandrp:批量转换文件路径为绝对路径/相对路径，会自动跟踪链接并规范化路径。tcp-connection-state-counter:统计各个TCP连接状态的个数。用于方便排查系统连接负荷问题。find-in-jars:在目录下所有`jar`文件里，查找类或资源文件。show-busy-java-threads:用于快速排查`Java`的`CPU`性能问题`topus`值过，自动查出运行的`Java`进程中消耗`CPU`多的线程，并打印出其线程栈，从而确定导致性能问题的方法调用。show-duplicate-java-classes:找出`jar`文件和`class`目录中的重复类。用于排查`Java`类冲突问题。```其他tips：更完整的使用方式，参考原版文档:[https://github.com/oldratlee/useful-scripts]https://github.com/oldratlee/useful-scripts