| jarboot: Jarboot 是一个强大的Java进程管理、诊断的平台，可以在线管理、监控及诊断本地和远程的Java进程。 | 您所在的位置：网站首页 › 进程监控程序 › jarboot: Jarboot 是一个强大的Java进程管理、诊断的平台，可以在线管理、监控及诊断本地和远程的Java进程。 |
jarboot: Jarboot 是一个强大的Java进程管理、诊断的平台，可以在线管理、监控及诊断本地和远程的Java进程。
|
Jarboot ❤️
Jarboot 是一个Java进程启停、管理、诊断的平台，可以管理、守护、监控及诊断本地和远程的Java进程。 在测试环境、每日构建的集成环境，可以把一系列编译输出等jar文件放入约定的目录，由Jarboot提供友好的浏览器ui界面和http接口，统一管理它的启动、停止及状态的监控，以及执行命令对目标进程进行调试。 English version goes here. 📚 文档：https://www.yuque.com/jarboot 🍏 最佳实践 🔥 : Jarboot with Spring Cloud Alibaba Example ⭐️ 🐳 可扩展: 同时支持JDK SPI和Spring SPI，支持插件式开发。
Jarboot 使用Java Agent和ASM技术往目标Java进程注入代码，无业务侵入性，注入的代码仅用于和 Jarboot 的服务实现命令交互，部分命令会修改类的字节码用于类增强，加入了与Arthas类似的命令系统，如获取JVM信息、 监控线程状态、获取线程栈信息等。 🌈 浏览器界面管理，一键启、停服务进程，不必挨个手动执行 🔥 支持启动、停止优先级配置[1]，默认并行启动 ⭐️ 支持进程守护，开启后若服务异常退出则自动启动并通知 ☀️ 支持文件更新监控，开启后若jar文件更新则自动重启[2] 🚀 调试命令执行，同时远程调试多个Java进程，界面更友好 💎 支持通过SPI自定义调试命令实现，支持开发插件
详细架构设计查看 前端界面采用Vue3技术。 后端服务主要由SpringBoot实现，提供http接口和静态资源代理。通过WebSocket向前端界面实时推送进程信息，同时与启动的Java进程维持一个长连接，以监控其状态。 安装或编译构建 下载压缩包文件的方式安装，或者使用Docker 从Github下载 🐳 Docker Hub: https://registry.hub.docker.com/r/mazheng0908/jarboot使用Docker sudo docker run -itd --name jarboot -p 9899:9899 mazheng0908/jarboot 编译源码的步骤使用压缩包安装或者Docker的时候忽略此步骤 编译Jarboot源代码 #首先需要准备JDK17+和nodeJS16+的开发环境，然后执行： $ mvn clean install -P prod 启动Jarboot服务如果是使用的Docker忽略此步骤。 #执行 startup.sh 启动, 在Windows系统上使用startup.cmd。 $ sh startup.sh 浏览器访问http://127.0.0.1:9899进入登录界面，初始的用户名：jarboot，默认密码：jarboot SPI扩展，支持JDK和Spring的SPI使用扩展可以自己实现命令，自己定义一个命令如何执行。并且，可以时应用启动完成快速的通知Jarboot服务，不需要等待没有控制台输出的时间。 SpringBoot应用 引入spring-boot-starter-jarboot依赖 io.github.majianzheng spring-boot-starter-jarboot ${jarboot.version} 实现CommandProcessorSPI接口同样的, 你也可以在方法上使用 @Bean 注解来定义命令处理器。 如果没有使用@Name注解的话，将会默认使用Bean的名称作为命令的名称。 @Name("spring.command.name") @Summary("The command summary") @Description("The command usage detail") @Component public class DemoServiceImpl implements DemoService, CommandProcessor { @Override public String process(CommandSession session, String[] args) { return "Spring boot Demo user-defined command using Spring SPI"; } //implement other method... }当引入了spring-boot-starter-jarboot依赖后，将会增加2个Spring调试命令，spring.bean和spring.env #spring.bean 用法： $ spring.bean [-b ] [-d] #示例： # 获取所有的bean name $ spring.bean # 获取bean的信息 $ spring.bean -b beanName # 获取bean的详细信息 $ spring.bean -b beanName -d #sping.env 用法： $ spring.env #示例： $ spring.env spring.application.name 非SpringBoot应用演示普通的非SpringBoot的应用如何使用。 如何创建一个用户自定义的命令 引入jarboot api的依赖 io.github.majianzheng jarboot-api provided ${jarboot.version} 实现spi接口 /** * 使用Name注解来定义一个命令的名字 */ @Name("demo") @Summary("The command summary") @Description("The command usage detail") public class DemoCommandProcessor implements CommandProcessor { @Override public String process(CommandSession session, String[] args) { return "demo SPI command result."; } } 创建JDK的spi定义文件在目录resources/META-INF/services中创建名为 spi.cmd.io.github.majianzheng.jarboot.api.CommandProcessor的文件，内容为类的全名。 启动成功主动通知Jarboot服务 public class DemoApplication { public static void main(String[] args) { // do something try { //Notify completion JarbootFactory.createAgentService().setStarted(); } catch (Exception e) { log(e.getMessage()); } } } 工具 文件浏览器
查看类的字节码，用法： jarboot$ bytes io.github.majianzheng.jarboot.demo.DemoServerApplication ClassLoader: org.springframework.boot.loader.LaunchedURLClassLoader@31221be2 ------ getUser L0 LINENUMBER 27 L0 ... ILOAD 1 ILOAD 2 IADD IRETURN L8 stdout开启或关闭标准输出流的实时显示（默认开启），将会在Web的前端ui界面上实时显示，输出流包括代码中的System.out.println、System.err.println 以及日志打印信息如logger.info("hello")。 注：该功能的实现机制经过精心设计，建议一直开启，对性能没有影响还可加速启动。 #开启标准输出流实时显示 jarboot$ stdout on #关闭标准输出流实时显示 jarboot$ stdout off #获取当前的状态，启动或关闭 jarboot$ stdout dashboard当前系统的实时数据面板，点击按钮取消
反编译 jarboot$ jad [-c] java.lang.String
查看进程JVM属性信息 jarboot$ jvm sc查找JVM中已经加载的类 $ sc -d org.springframework.web.context.support.XmlWebApplicationContext class-info org.springframework.web.context.support.XmlWebApplicationContext code-source /Users/xxx/work/test/WEB-INF/lib/spring-web-3.2.11.RELEASE.jar name org.springframework.web.context.support.XmlWebApplicationContext isInterface false isAnnotation false isEnum false isAnonymousClass false isArray false isLocalClass false isMemberClass false isPrimitive false isSynthetic false simple-name XmlWebApplicationContext modifier public annotation interfaces super-class +-org.springframework.web.context.support.AbstractRefreshableWebApplicationContext +-org.springframework.context.support.AbstractRefreshableConfigApplicationContext +-org.springframework.context.support.AbstractRefreshableApplicationContext +-org.springframework.context.support.AbstractApplicationContext +-org.springframework.core.io.DefaultResourceLoader +-java.lang.Object class-loader +-org.apache.catalina.loader.ParallelWebappClassLoader +-java.net.URLClassLoader@6108b2d7 +-sun.misc.Launcher$AppClassLoader@18b4aac2 +-sun.misc.Launcher$ExtClassLoader@1ddf84b8 classLoaderHash 25131501 trace方法执行监控 jarboot$ trace io.github.majianzheng.jarboot.demo.DemoServerApplication add Affect(class count: 2 , method count: 1) cost in 63 ms, listenerId: 2 `---ts=2021-06-15 23:34:20;thread_name=http-nio-9900-exec-3;id=13;is_daemon=true;priority=5;TCCL=org.springframework.boot.web.embedded.tomcat.TomcatEmbeddedWebappClassLoader@4690b489 `---[0.053485ms] io.github.majianzheng.jarboot.demo.DemoServerApplication:add() watch方法执行数据监测 观察方法 io.github.majianzheng.jarboot.demo.DemoServerApplicatio#add 执行的入参，仅当方法抛出异常时才输出。 jarboot$ watch io.github.majianzheng.jarboot.demo.DemoServerApplicatio add {params[0], throwExp} -e Press Ctrl+C to abort. Affect(class-cnt:1 , method-cnt:1) cost in 65 ms. ts=2018-09-18 10:26:28;result=@ArrayList[ @RequestFacade[org.apache.catalina.connector.RequestFacade@79f922b2], @NullPointerException[java.lang.NullPointerException], ] thread查看当前线程信息，查看线程的堆栈 jarboot$ thread -n 3 "nioEventLoopGroup-2-1" Id=31 cpuUsage=0.37% deltaTime=0ms time=880ms RUNNABLE at sun.management.ThreadImpl.dumpThreads0(Native Method) at sun.management.ThreadImpl.getThreadInfo(ThreadImpl.java:448) at impl.cmd.io.github.majianzheng.jarboot.core.ThreadCommand.processTopBusyThreads(ThreadCommand.java:209) at impl.cmd.io.github.majianzheng.jarboot.core.ThreadCommand.run(ThreadCommand.java:120) at basic.io.github.majianzheng.jarboot.core.EnvironmentContext.runCommand(EnvironmentContext.java:162) at cmd.io.github.majianzheng.jarboot.core.CommandRequestSubscriber.execute(CommandDispatcher.java:35) at server.io.github.majianzheng.jarboot.core.JarbootBootstrap$1.onText(JarbootBootstrap.java:94) at io.github.majianzheng.jarboot.core.ws.WebSocketClientHandler.channelRead0(WebSocketClientHandler.java:83) at io.netty.channel.SimpleChannelInboundHandler.channelRead(SimpleChannelInboundHandler.java:99) "C2 CompilerThread1" [Internal] cpuUsage=3.14% deltaTime=6ms time=4599ms "C2 CompilerThread0" [Internal] cpuUsage=2.28% deltaTime=4ms time=4692ms Classloader查看classloader的继承树，urls，类加载信息 jarboot$ classloader name numberOfInstances loadedCountTotal org.springframework.boot.loader.LaunchedURLClassLoader 1 3929 BootstrapClassLoader 1 2623 io.github.majianzheng.jarboot.agent.JarbootClassLoader 1 1780 sun.misc.Launcher$AppClassLoader 1 59 sun.reflect.DelegatingClassLoader 58 58 sun.misc.Launcher$ExtClassLoader 1 18 Affect(row-cnt:6) cost in 35 ms. heapdumpdump java heap, 类似jmap命令的heap dump功能。 jarboot$ heapdump
查看进程系统属性信息 #获取全部 jarboot$ sysprop #获取指定的属性 jarboot$ sysprop user.home Credit Projects bytekit Java Bytecode Kit. Arthas 部分命令在Arthas源码的基础上二次开发。 致谢我们使用Jetbrains tools开发和构建项目.
1: 可以配置优先级级别，从整数值1开始，越大约先启动，停止的顺序则相反。 2: 开发中可以由gitlab runner、Jenkins等工具自动构建后通过脚本拷贝到Jarboot指定的目录下，Jarboot监控到文件的更新会自动重启服务，目录监控实现了防抖设计（在一定时间内的多次更新只会触发一次重启）。 |
【本文地址】