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:

·
We want a tool that allows users of IcedTea/OpenJDK to monitor running JVMs, especially remote JVMs.
·
Both high level (uptime, cpu and memory usage) and low level (including hotspot's perf data) information should be available through the tool.
·
The tool should be usable in a production environment, with minimal overhead.

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/Therm…

Info