de.intarsys.tools.monitor
Interface ITrace

All Known Implementing Classes:

AbstractMonitorTrace, CompositeMonitorTrace, CounterMonitorTrace, MemberMonitorTrace, MemoryMonitorTrace, MonitorTrace, MultiTrace, TimeMonitorTrace

public interface ITrace

A trace of ISample instances for a specific IMonitor .

A trace means recording samples (and tags) while executing. The trace is later on aggregated in the IMonitor. The IMonitor may additionally keep a list of recent traces.

Method Summary

ISample	sample(Level level, String description) Take a sample and tag it with description.
void	tag(String key, Object tag) Add a key/value pair to this.

Method Detail

sample

ISample sample(Level level,
               String description)

Take a sample and tag it with description. The sample is stored in addition to the "fix" start and stop sample.

Parameters:

level -

tag

void tag(String key,
         Object tag)

Add a key/value pair to this. This data is not interpreted by the monitor.

Parameters:

key - The name of the value to store.

tag - The object to store with the measurement.