From Fedora Project Wiki
(→‎Current status: update the status to reflect that all the work in fedora is done)
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)
# Run thermostat<pre>/usr/bin/thermostat-client</pre>
# 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 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.


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

Revision as of 11:00, 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)
  4. Thermostat is a client/server tool, to run it you need:
  5. Run thermostat agent and service backends
    /usr/bin/thermostat service --start
  6. Run thermostat client
    /usr/bin/thermostat-client
  7. 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.
  8. 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