com.sun.sgs.impl.profile.listener
Class RuntimeHistogramListener

java.lang.Object
  com.sun.sgs.impl.profile.listener.RuntimeHistogramListener

All Implemented Interfaces:

ProfileListener

public class RuntimeHistogramListener
extends Object
implements ProfileListener

A text-output listener that displays the distribution of successful task execution times, for both a recent fixed-size window of tasks and the lifetime of the application. This class uses a PowerOfTwoHistogram to display the distribution of execution times.

Note that this class uses a fixed number of tasks between outputs, rather than a period of time. The number of tasks can be configured by defining the com.sun.sgs.profile.listener.window.size property in the application properties file. The default window size for this class is 5000.

Field Summary

Fields inherited from interface com.sun.sgs.profile.ProfileListener

WINDOW_SIZE_PROPERTY

Constructor Summary

RuntimeHistogramListener(Properties properties, Identity owner, ComponentRegistry registry)
Creates an instance of RuntimeHistogramListener.

Method Summary

void	propertyChange(PropertyChangeEvent event) Notifies this listener of a new change in the system properties.
void	report(ProfileReport profileReport) Aggregates the task execution times for sucessful tasks and when the number of tasks reaches the windowed limit, outputs a histogram for the execution times for the window and also the lifetime of the application.
void	shutdown() Tells this listener that the system is shutting down.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RuntimeHistogramListener

public RuntimeHistogramListener(Properties properties,
                                Identity owner,
                                ComponentRegistry registry)

Creates an instance of RuntimeHistogramListener.

Parameters:

properties - the Properties for this listener

owner - the Identity to use for all tasks run by this listener

registry - the ComponentRegistry containing the available system components

Method Detail

propertyChange

public void propertyChange(PropertyChangeEvent event)

Notifies this listener of a new change in the system properties. This method is called for any property that changes.

The current list of supported property names is as follows:

name	description	new value	old value
com.sun.sgs.profile.newop	a new operation is registered with the system.	the new operation : ProfileOperation	null
com.sun.sgs.profile.threadcount	the number of threads in the system has changed.	the current number of threads : Integer	the previous number of threads : Integer
com.sun.sgs.profile.nodeid	the local node has been assigned a unique identifier	the identifier for the local node: Long	null

Specified by:

propertyChange in interface ProfileListener

Parameters:

event - A PropertyChangeEvent object describing the name of the property, its old and new values and the source of the change.

report

public void report(ProfileReport profileReport)

Aggregates the task execution times for sucessful tasks and when the number of tasks reaches the windowed limit, outputs a histogram for the execution times for the window and also the lifetime of the application.

Specified by:

report in interface ProfileListener

Parameters:

profileReport - the summary for the finished Task

shutdown

public void shutdown()

Tells this listener that the system is shutting down.

Specified by:

shutdown in interface ProfileListener