thermostat man page

thermostat — A monitoring and serviceability tool for OpenJDK

Synopsis

thermostat [ global_options ] command [ command_options ] [ command_arguments ]
thermostat help
thermostat help command

Description

Thermostat is an instrumentation tool for the Hotspot JVM, with support for monitoring multiple JVM instances on multiple hosts, optionally in a cloud environment. The name Thermostat is intended as a play on words: Thermostat is to Hotspot much as IcedTea is to Java.
Some goals of Thermostat are:

Options

Global Options

 --print-osgi-info     Print debug information related to the OSGi framework's
                       boot/shutdown process.
 --ignore-bundle-versions
                       Ignore exact bundle versions and use whatever version is
                       available.
 --boot-delegation     Boot delegation string passed on to the OSGi framework.
                       Defaults to
                       "com.redhat.thermostat.vm.profiler.agent.jvm,com.redhat.thermostat.vm.profiler.agent.asm,com.redhat.thermostat.vm.profiler.agent.asm.commons"

Command Options and Command Arguments

Please see thermostat help command for options and arguments for a command.

Quick Start

For new users and users looking to monitor JVMs only on the local machine, simply run the "thermostat local command" to get started.

Command Overview

thermostat help

 show help for a given command or help overview

thermostat local

 start a self contained instance of service/web-storage-service and the GUI client

thermostat storage <--start|--stop|--status> [--dryRun] [-q] [-l <level>]

 control Thermostat mongodb storage

thermostat agent [-d <url>] [-s] [-l <level>]

 starts the Thermostat agent

thermostat gui [-l <level>]

 starts the graphical user interface client

thermostat shell

 starts the Thermostat interactive shell

thermostat web-storage-service

 starts mongodb storage, an embedded servlet container and an agent

Command Reference

Please see "thermostat help command" for detailed options and arguments of each command. "thermostat help", without a specific command argument, lists all available commands.

Files

THERMOSTAT_HOME/etc/db.properties

System configuration for mongodb storage

USER_THERMOSTAT_HOME/etc/db.properties

User specific configuration for mongodb storage. Overrides system configuration.

THERMOSTAT_HOME/etc/agent.properties

System configuration for agent

USER_THERMOSTAT_HOME/etc/agent.properties

User specific configuration for agent. Overrides system configuration.

USER_THERMOSTAT_HOME/etc/agent.auth

User specific storage connection credentials configuration for agent.

THERMOSTAT_HOME/etc/ssl.properties

System configuration for TLS

USER_THERMOSTAT_HOME/etc/ssl.properties

User specific configuration for TLS.

Bugs

If you think you've found a bug in thermostat please make sure that it really is a bug, and that it appears in the latest version of thermostat. The latest version is always  available from http://icedtea.classpath.org/hg/thermostat/. You can file thermostat bugs at: http://icedtea.classpath.org/bugzilla/

See Also

http://icedtea.classpath.org/thermostat/
http://icedtea.classpath.org/wiki/Thermostat/UserGuide