Back to Zing Documentation Home

Appendix. jHiccup Command-Line Arguments

Below are the command-line options used to control jHiccup behavior and reporting:

[-h] [-v] [-l logFileName] [-d startDelayMs] [-i reportingIntervalMs] [-r resolutionMs] [-t runTimeMs] [-c] [-x controlProcessArgs] [-terminateWithStdInput]

The command-line options are separated by commas instead of spaces for easier embedding the –javaagent option to existing start scripts, for example:

-javaagent:/opt/zing/jHiccup.jar=-i,1000,-l,/tmp/hiccup.log

Details of the options to use with the jHiccup Java agent that runs in the same process as the application:

Option Description
[-h] help
[-l logFileName]

Logs hiccup information into logFileName.hlog (will automatically replace occurrences of %pid and %date in the file name with appropriate information).

[-d startDelayMs] Delays the beginning of hiccup measurement by startDelayMs milliseconds (default 30000).
[-i reportingIntervalMs] Sets reporting interval (default 5000).
[-r resolutionMs] Sets sampling resolution in milliseconds (default 1).
[-t runTimeMs] Limits measurement time (default 0, == infinite).

Details of the options to use to launch a separate JVM process on the same machine that runs the jHiccup Java agent and collects information about the operating system and hardware’s impact on pauses:

Option Description

[-c]

Launches a control process in a separate JVM logging hiccup data into logFileName.c.hlog.

[-x controlProcessArgs]

Passes additional arguments to the control process JVM.

[-terminateWithStdInput]

Takes over standard input, and terminates process when standard input is severed (useful for control processes that wish to terminate when their launching parent does).


© Azul Systems, Inc. 2020 All rights reserved.

Privacy Policy | Legal | Terms of Use