7.4.7 -XX:JavaLogRotationTime
-XX:JavaLogRotationTime specifies the rotation time of the Java VM log file.
Description
If the rotation type of the Java VM log file is the shift method, -XX:JavaLogRotationTime specifies the time when the output destination file is to be switched. This option applies to Java VM log files and the log files for the explicit memory management functionality. The Java VM log files will be switched at the time specified in this option. If this option is omitted or a value that is outside of the specifiable range is specified, the log files will be switched at the default time of 00:00:00 (midnight). If the rotation type is the wraparound method (-XX:JavaLogRotationType:WRAP), the functionality for switching output destination files at a specific time cannot be used.
Depending on certain conditions (for example, when there is a heavy load on OS resources or a thread is in the stopped status during GC execution), the switching of the output destination files might be delayed by a few milliseconds or a few seconds from the specified time. Even if the switching time is delayed, the delay will not carry over to the next switching time, because the next switch will occur at the specified time.
Note that, depending on the delay in the switch timing, there might be a margin of error in the time when log information is output to the backup log and the current log file. For example, if you specify 000000 (00:00:00) in this option, the log information before and after 00:00:00 might be output to two files. If the asynchronous output functionality for the log file is used, there might be a margin of error between the switching time and the time when log information is output, because the log is output to the log file asynchronously via a thread that is used exclusively for log output.
The output destination file is switched everyday at the specified time. However, if you specify a time that is earlier than the current time, the Java VM log file will switched at the specified time on the next day. For example, if you specify 144500 (14:45:00) in this option and then start Java at 15:00:00 on February 12, 2014, the Java VM log file will be switched at 14:45:00 on February 13, 2014.
Syntax
-XX:JavaLogRotationTime:applicable_range
Specifiable values
- applicable_range
-
Type: Integer
Specifies the time. Specify the time in the HHMMSS format as a value from 000000 to 235959. Specify with 6 numbers without using any delimiter characters (such as colons). If you specify an incorrect time value that is outside of the specifiable range, the default value is set.