java应用监测(2)-java命令的秘密

tags: java, troubleshooting, monitor

---

一句话归纳：简单的java启动命令，原来藏着这么多秘密，本文为你揭晓。

1 引言

刚开始学java的同窗，必定都不会忘记安装完jdk后，都会使用java -version命令来检测一下是否安装成功，那还有没有其它参数可使用呢？平时开发和运行java应用时，常常看到一些-D的参数（如使用maven时，package时会使用-Dmaven.test.skip），这些参数是用来作什么的？还有常常说到调优，都会涉及到-Xms和-Xmx的设置，它是什么意思呢？这些，基本都是在使用java命令启动应用时所使用的参数，它的参数有不少，特别涉及到应用调优和问题诊断时会常用，学习java的同窗都应该了解一下。本文将对java命令的启动参数进行详细描述，着重讲解经常使用的设置及用于调试监测的设置。

2 java应用启动

启动java应用使用的是java(class文件)或java -jar(jar或war包)命令，java命令其实就是生成一个JVM的实例，java应用则运行于此JVM实例中，JVM负责类加载，运行时区域堆栈分配等工做，当应用退出，JVM实例也会关闭。启动多个java应用，也会启动多个JVM实例，它们不会相互影响(但它们都共享同一系统的资源)，这也是为何使用一个JDK，能够跑多个java应用的背后逻辑。使用java命令启动应用所使用的参数，基本是用于JVM的，JVM实例经过调用某个初始类的main()方法来运行一个Java程序，此方法将做为该程序初始线程的起点，任何其余的线程都是由这个初始线程启动的。在JVM内部有两种线程：守护线程（如垃圾回收线程）和非守护线程（main方法线程及用户使用Thread建立的线程），当该程序中全部的非守护线程都终止时，JVM实例将自动退出。

3 java应用启动参数说明

java命令究竟有哪些参数能够用，这些参数分别有什么做用，简单的不带参数使用java或java -help或java -?，便可看到此命令的使用方法及参数描述，以下所示：

java执行类文件，java -jar执行jar或war文件。上面只是把参数简要的列了出来，更详细的参数说明，可参考官网的java命令说明（https://docs.oracle.com/javase/8/docs/technotes/tools/unix/java.html）。使用java命令启动应用所使用的参数，基本是用于JVM的，某种程度上也叫作JVM参数。总的来讲，java启动参数共分为三大类，分别是：

• 标准参数(-)：相对稳定的参数，每一个版本的JVM均可用。
• 非标准X参数(-X)：默认jvm实现这些参数的功能，可是并不保证全部jvm实现都知足，且不保证向后兼容。
• XX参数(-XX)：此类参数各个jvm实现会有所不一样，未来可能会随时取消。

下面将会对这些参数进行说明。

3.1 标准参数(-)

从前面使用java -?能够看到，以-开头的参数，都属于标准参数，咱们经常使用的-help，-version，-classpath，-Dproperty=value等均属于标准参数。参数详细说明以下：

-d32及-d64  分别表示应用运行在32位或64位的环境中，使用Java HotSpot Server VM的默认使用的是server模式，而server模式默认使用的是-d64，所以在没有使用此参数时，默认就是-d64。

-server       选择 "server" VM，默认 VM 是 server,表示是在服务器类计算机上运行。

-cp或-classpath <目录和 zip/jar 文件的类搜索路径>linux用":",windows用";"来分隔目录, JAR 档案和 ZIP 档案列表, 用于搜索类文件。
      使用-classpath后jvm将再也不使用CLASSPATH中的类搜索路径，若是-classpath和CLASSPATH都没有设置，则jvm使用当前路径(.)做为类搜索路径。

-D<名称>=<值> 设置系统属性,运行在此jvm之上的应用程序可用System.getProperty(“property”)获得value的值。
      若是value中有空格，则须要用双引号将该值括起来，如-Dfoo=”foo bar”。该参数一般用于设置系统级全局变量值，如配置文件路径，以便该属性在程序中任何地方均可访问。

-verbose:[class|gc|jni] 启用详细输出，通常在调试和诊断时，都会把gc的详细信息输出
-version      输出产品版本并退出
-version:<值> 须要指定的版本才能运行
-showversion  输出产品版本并继续，即输出版本后，继续按java执行，这是跟-version的区别
-jre-restrict-search | -no-jre-restrict-search 在版本搜索中包括/排除用户专用 JRE
-? -help      输出此帮助消息
-X            输出非标准选项的帮助
-ea或-enableassertions [:<packagename>...|:<classname>] 按指定的粒度启用断言，默认jvm关闭断言机制
-da或-disableassertions [:<packagename>...|:<classname>] 禁用具备指定粒度的断言
-esa | -enablesystemassertions 启用系统断言
-dsa | -disablesystemassertions 禁用系统断言
-agentlib:<libname>[=<选项>] 加载本机代理库 <libname>, 例如 -agentlib:hprof
                  另请参阅 -agentlib:jdwp=help 和 -agentlib:hprof=help
-agentpath:<pathname>[=<选项>] 按完整路径名加载本机代理库
-javaagent:<jarpath>[=<选项>] 加载Java编程语言代理, 请参阅 java.lang.instrument
-splash:<imagepath> 使用指定的图像显示启动屏幕，通常用于图形编程。
复制代码

由上面描述可，可知道咱们经常使用的-version，-classpath，-Dproperty=value是用于作什么的了。特别提一下-classpath（之前遇到因为这个致使运行问题），jvm在加载类时，搜索的路径就是此路径，而它在linux及windows使用的分隔符是不同的，linux用:,windows用;来分隔。

3.2 非标准X参数(-X)

使用命令java -X，便可把非标准参数输出，平时使用中，咱们用得较多的就是-Xloggc，-Xms<size>,-Xmx<size>,-Xss<size>,-Xmn<size>了，详细说明以下所示：

-Xmixed  默认是mixed，使用它们来设置JVM的本地代码编译模式
-Xint    表示解释执行，全部的字节码将被直接执行，而不会编译成本地码
-Xcomp   表示第一次使用就编译成本地代码。
-Xbatch  禁止后台代码编译，强制在前台编译，编译完成以后才能进行代码执行，默认状况下，jvm在后台进行编译，若没有编译完成，则前台运行代码时以解释模式运行
-Xbootclasspath:    设置搜索路径以引导类和资源，让jvm从指定路径（能够是分号分隔的目录、jar、或者zip）中加载bootclass，用来替换jdk的rt.jar
-Xbootclasspath/a:  附加在引导类路径末尾
-Xbootclasspath/p:  置于引导类路径以前，让jvm优先于bootstrap默认路径加载指定路径的全部文件
-Xcheck:jni    对JNI函数进行附加check；此时jvm将校验传递给JNI函数参数的合法性，在本地代码中遇到非法数据时，jmv将报一个致命错误而终止；使用该参数后将形成性能降低，请慎用。
-Xfuture   让jvm对类文件执行严格的格式检查（默认jvm不进行严格格式检查），以符合类文件格式规范，推荐开发人员使用该参数
-Xincgc    开启增量gc（默认为关闭）；这有助于减小长时间GC时应用程序出现的停顿；但因为可能和应用程序并发执行，因此会下降CPU对应用的处理能力
-Xloggc:file   与-verbose:gc功能相似，只是将每次GC事件的相关状况记录到一个文件中，文件的位置最好在本地，以免网络的潜在问题。若与verbose命令同时出如今命令行中，则以-Xloggc为准。
-Xms   指定jvm堆的初始大小，默认为物理内存的1/64，最小为1M；能够指定单位，好比k、m，若不指定，则默认为字节。
-Xmx   指定jvm堆的最大值，默认为物理内存的1/4或者1G，最小为2M；单位与-Xms一致。
-Xss   设置单个线程栈的大小，通常默认为512k。
-Xmn   设置堆(heap)的年轻代的初始值及最大值，单位与-Xms一致，年轻代是存储新对象的地址，也是GC发生得最频繁的地方，若设置太小，则会容易触发年轻代垃圾回收（minor gc），若设置过大，只触发full gc，则占用时间会很长，oracle建议是把年轻代设置在堆大小的四份之一到一半的。这命令同时设置了初始值和最大值，可使用-XX:NewSize和-XX:MaxNewSiz来分别设置。
-XshowSettings    显示全部设置并继续
复制代码

上述参数中，-Xms<size>,-Xmx<size>,-Xss<size>,-Xmn<size>都是咱们性能优化中很重要的参数，-Xloggc是在没有专业跟踪工具状况下排错的好手。

3.3 XX参数(-XX)

此类参数很是丰富，包括高级运行时参数，高级JIT编译参数，高级维护参数和高级GC参数，在官网能够看到它所有的参数（https://docs.oracle.com/javase/8/docs/technotes/tools/unix/java.html），各个版本jvm实现有可能会有所不一样。其中按设置格式，主要分为两类，一种是boolean类型，主要用于功能开关，一种是key-value类型，主要性能、调试参数等设置，下面列举一些主要使用的参数。

3.3.1 boolean类型

此类参数，格式：-XX:[+-]<name>，做为功能开关，表示启用或者禁用属性。如下列举一些：

-XX:+PrintFlagsFinal  输出参数的最终值
-XX:+PrintFlagsInitial 输出参数的默认值
-XX:-DisableExplicitGC  禁止调用System.gc()；但jvm的gc仍然有效
-XX:+MaxFDLimit 最大化文件描述符的数量限制
-XX:+ScavengeBeforeFullGC   新生代GC优先于Full GC执行
-XX:+UseGCOverheadLimit 在抛出OOM以前限制jvm耗费在GC上的时间比例
-XX:-UseConcMarkSweepGC 对老生代采用并发标记交换算法进行GC
-XX:-UseParallelGC  启用并行GC
-XX:-UseParallelOldGC   对Full GC启用并行，当-XX:-UseParallelGC启用时该项自动启用
-XX:-UseSerialGC    启用串行GC
-XX:+UseThreadPriorities    启用本地线程优先级
-XX:-UseG1GC    启用G1的GC
复制代码

3.3.2 key-value类型

此类参数，格式：-XX:<name>=<value>表示属性name的值为value。在性能调优和调试监测时，会常常用到。

• 性能调优

性能调优时，主要是对JVM的内存分配状况的调优，包括堆大小，年轻代大小，年轻年老代比例等等。

-XX:LargePageSizeInBytes=4m 设置用于Java堆的大页面尺寸
-XX:MaxHeapFreeRatio=70 GC后java堆中空闲量占的最大比例
-XX:MaxNewSize=size 新生成对象能占用内存的最大值
-XX:MaxPermSize=64m 老生代对象能占用内存的最大值
-XX:MinHeapFreeRatio=40 GC后java堆中空闲量占的最小比例
-XX:NewRatio=2  新生代内存容量与老生代内存容量的比例
-XX:NewSize=2.125m  新生代对象生成时占用内存的默认值
-XX:ReservedCodeCacheSize=32m   保留代码占用的内存容量
-XX:ThreadStackSize=512 设置线程栈大小，若为0则使用系统默认值
-XX:+UseLargePages  使用大页面内存
复制代码

• 调试监测

在须要对应用进行监测，特别是观察GC状况，OOM后检查问题等。

-XX:-CITime 打印消耗在JIT编译的时间
-XX:ErrorFile=./hs_err_pid<pid>.log 保存错误日志或者数据到文件中
-XX:-ExtendedDTraceProbes   开启solaris特有的dtrace探针
-XX:HeapDumpPath=./java_pid<pid>.hprof  指定导出堆信息时的路径或文件名
-XX:-HeapDumpOnOutOfMemoryError 当首次遭遇OOM时导出此时堆中相关信息
-XX:OnError="<cmd args>;<cmd args>" 出现致命ERROR以后运行自定义命令
-XX:OnOutOfMemoryError="<cmd args>;<cmd args>"  当首次遭遇OOM时执行自定义命令
-XX:-PrintClassHistogram    遇到Ctrl-Break后打印类实例的柱状信息，与jmap -histo功能相同
-XX:-PrintConcurrentLocks   遇到Ctrl-Break后打印并发锁的相关信息，与jstack -l功能相同
-XX:-PrintCommandLineFlags  打印在命令行中出现过的标记
-XX:-PrintCompilation   当一个方法被编译时打印相关信息
-XX:-PrintGC    每次GC时打印相关信息
-XX:-PrintGC Details    每次GC时打印详细信息
-XX:-PrintGCTimeStamps  打印每次GC的时间戳
-XX:-TraceClassLoading  跟踪类的加载信息
-XX:-TraceClassLoadingPreorder  跟踪被引用到的全部类的加载信息
-XX:-TraceClassResolution   跟踪常量池
-XX:-TraceClassUnloading    跟踪类的卸载信息
-XX:-TraceLoaderConstraints 跟踪类加载器约束的相关信息
复制代码

4 经常使用java应用启动参数

通过前面几个章节的介绍，你们应该对java的启动参数（JVM参数）有必定的了解，但参数太多了，不可能把全部参数都得记住，有须要时，建议你们看-help或者看官网说明来查阅。不少时候，咱们只须要记住几个经常使用的便可。下面总结一下经常使用的JVM参数。

4.1 经常使用标准参数

• -version，场景：想查看JDK版本，java -version。
• -D<名称>=<值>，场景:maven跳过单元测试，使用java -Dmaven.test.skip=true,
• -cp或-classpath, 场景：设置须要加载的jar包位置，使用java -cp lib/test.jar com.test.TestMain
• -verbose:gc, 场景：输出GC详细信息

4.2 经常使用X参数

• -Xms<size>和-Xmx<size>，场景：因为内存不足发生oom，调大堆大小，如设置为1G，能够java -Xms1024m -Xmx1024m，一般为了不频繁发生GC，-Xms和-Xmx设置为一致。
• -Xss<size>，场景：线程操做数及局部变量多，把线程栈的大小调大，能够java -Xss1024k
• -Xmn<size>，场景：年轻代大小设置为512m，能够java -Xmn512m
• -Xloggc:file，场景：将每次GC事件的相关状况记录到一个文件中以便于后续分析，能够java -Xloggc:logs/gc.log

4.3 经常使用XX参数

打印GC相关的内容，包括堆状况，GC详情，GC时间，发生OOM时，生成快照，发生错误是记录错误日志等，以下：

• -XX:+PrintHeapAtGC
• -XX:+PrintGCDetails
• -XX:+PrintGCDateStamps
• -XX:+PrintGCTimeStamps
• -XX:+PrintTenuringDistribution
• -XX:+PrintGCApplicationStoppedTime
• -XX:+HeapDumpOnOutOfMemoryError
• -XX:HeapDumpPath=logs/heapdump.hprof，发生OOM时，dump出快照到文件heapdump.hprof中。
• -XX:ErrorFile=logs/java_error_%p.log，发生JVM错误时，把日志输出到java_error_%p.log中。

以上参数均是使用度很高的参数，在使用java命令启动应用时，能够把这些参数加上，以便于后续调优与问题诊断。

5 总结

简单的java启动命令，使用起来原来这么复杂，固然通常来讲，只使用java或java -jar来按默认值启动应用，也不会有太大问题。只是涉及到调优、监测、诊断时，了解这些参数，无疑是高级程序员必要的技能。但愿经过本文，你们对java命令及参数能够作到心中有数。

参考资料

• JDK工具参考文档：https://docs.oracle.com/javase/8/docs/technotes/tools/unix

相关阅读

• 《java应用监测(1)-java程序员应该知道的应用监测技术》：https://juejin.im/post/5d5fde94f265da03d42fae8b