Simple Java Metrics

This package provides some Java classes to help with the providing application metrics.

• For more information, visit the SimpleMetrics home page.
• Online documentation can be found off the home page. Here are the code Javadocs.
• Browse the code on the git repository.
• Maven packages are published via

Enjoy. Gray Watson

Little Sample Program

I've checked in a little example program.

Getting Started

Here's a quick code sample showing how to get started.

// create our metrics manager which controls everything
MetricsManager metricsManager = new MetricsManager();

// create and register a persister, you will probably want to write your own for your own logging
LoggingMetricsPersister persister = new LoggingMetricsPersister();
metricsManager.setMetricValuesPersisters(new MetricValuesPersister[] { persister });

// create and register one (or many) metrics
ControlledMetricAccum hitCounter =
	new ControlledMetricAccum("example", null, "hits", "number of hits to the cache", null);
metricsManager.registerMetric(hitCounter);

// optionally start a persister thread to persist the metrics every minute (60000 millis)
MetricsPersisterJob persisterThread = new MetricsPersisterJob(manager, 60000, 60000, true);

// now the metric can be incremented whenever a "hit" occurs
hitCounter.increment();
// or maybe we need to account for a bunch of hits
hitCounter.add(23);
// ...

// the persister will log the value of hitCounter every 60 seconds automatically

Maven Configuration

<dependencies>
	<dependency>
		<groupId>com.j256.simplemetrics</groupId>
		<artifactId>simplemetrics</artifactId>
		<!-- NOTE: change the version to the most recent release version from the repo -->
		<version>1.10</version>
	</dependency>
</dependencies>

ChangeLog Release Notes

See the ChangeLog.txt file.