From Fedora Project Wiki
 
Line 38: Line 38:
# Install thermostat: <pre> yum install thermostat</pre>
# Install thermostat: <pre> yum install thermostat</pre>
# Run any java program (for example, eclipse)
# Run any java program (for example, eclipse)
# Thermostat is a client/server tool, to run it you need:
Thermostat is a client/server tool, to run it you need:
# Run thermostat agent and service backends <pre>/usr/bin/thermostat service --start</pre>
# Run thermostat agent and service backends <pre>/usr/bin/thermostat service --start</pre>
# Run thermostat client <pre>/usr/bin/thermostat-client</pre>
# Run thermostat client <pre>/usr/bin/thermostat-client</pre>
# It should show you a summary of the local machine as well as a list of, and information about, all java processes running on the local machine.
It should show you a summary of the local machine as well as a list of, and information about, all java processes running on the local machine.
# Note that the thermostat service application doesn't release the therminal and can't be run in background yet as of this writing.
Note that the thermostat service application doesn't release the therminal and can't be run in background yet as of this writing.


== User Experience ==
== User Experience ==

Latest revision as of 11:01, 16 May 2012

Feature Name Thermostat

Summary

Thermostat is an instrumentation tool for the Hotspot JVM, with support for monitoring multiple JVM instances. Currently it is limited to just the local machine.

Owner

Current status

  • Targeted release: Fedora 17
  • Last updated: 2012-02-07
  • Percentage of completion: 100%

Detailed Description

Thermostat aims to provide an instrumentation tool for monitoring multiple JVM instances on multiple hosts.

This is the initial release of Thermostat. Goals of thermostat for this release include:

  • We want a tool that allows users of IcedTea/OpenJDK to monitor running JVMs on the local machine
  • There should be a GUI application.
  • 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.

Future release of thermostat will include many additional features and better support for monitoring applications running in the cloud.

Benefit to Fedora

As a result of this, Fedora becomes a better platform for running and monitoring Java applications.

Scope

All of thermostat's dependencies are already in Fedora 17. Only the thermostat package needs to be added to fedora. Thermostat does not require any changes to java-1.7.0-openjdk.

How To Test

  1. No special hardware is need
  2. Install thermostat:
     yum install thermostat
  3. Run any java program (for example, eclipse)

Thermostat is a client/server tool, to run it you need:

  1. Run thermostat agent and service backends
    /usr/bin/thermostat service --start
  2. Run thermostat client
    /usr/bin/thermostat-client

It should show you a summary of the local machine as well as a list of, and information about, all java processes running on the local machine. Note that the thermostat service application doesn't release the therminal and can't be run in background yet as of this writing.

User Experience

A GUI application will be available to users. Users will be able to run it and use it to look at other JVM processes running on the same host.

Dependencies

None.

Contingency Plan

We leave out thermostat. No other package gets affected. We just lose a good tool.

Documentation

Release Notes

  • Fedora 17 includes Thermostat, a new tool for monitoring and instrumenting OpenJDK/Hotspot.

Comments and Discussion