org.janusgraph.util.stats

Enum MetricManager

java.lang.Object

java.lang.Enum<MetricManager>

org.janusgraph.util.stats.MetricManager

All Implemented Interfaces:

Serializable, Comparable<MetricManager>

public enum MetricManager
extends Enum<MetricManager>

Singleton that contains and configures JanusGraph's MetricRegistry.

Enum Constant Summary

Enum Constants

Enum Constant and Description
INSTANCE

Method Summary

Modifier and Type	Method and Description
void	addConsoleReporter(Duration reportInterval) Create a ConsoleReporter attached to the JanusGraph Metrics registry.
void	addCsvReporter(Duration reportInterval, String output) Create a CsvReporter attached to the JanusGraph Metrics registry.
void	addGraphiteReporter(String host, int port, String prefix, Duration reportInterval) Create a GraphiteReporter attached to the JanusGraph Metrics registry.
void	addJmxReporter(String domain, String agentId) Create a JmxReporter attached to the JanusGraph Metrics registry.
void	addSlf4jReporter(Duration reportInterval, String loggerName) Create a Slf4jReporter attached to the JanusGraph Metrics registry.
com.codahale.metrics.Counter	getCounter(String name)
com.codahale.metrics.Counter	getCounter(String prefix, String... names)
com.codahale.metrics.Histogram	getHistogram(String name)
com.codahale.metrics.Histogram	getHistogram(String prefix, String... names)
com.codahale.metrics.MetricRegistry	getRegistry() Return the JanusGraph Metrics registry.
com.codahale.metrics.Timer	getTimer(String name)
com.codahale.metrics.Timer	getTimer(String prefix, String... names)
boolean	remove(String name)
void	removeAllReporters() Remove all JanusGraph Metrics reporters previously configured through the add* methods on this class.
void	removeConsoleReporter() Stop a ConsoleReporter previously created by a call to addConsoleReporter(Duration) and release it for GC.
void	removeCsvReporter() Stop a CsvReporter previously created by a call to addCsvReporter(Duration, String) and release it for GC.
void	removeGraphiteReporter() Stop a GraphiteReporter previously created by a call to addGraphiteReporter(String, int, String, Duration) and release it for GC.
void	removeJmxReporter() Stop a JmxReporter previously created by a call to addJmxReporter(String, String) and release it for GC.
void	removeSlf4jReporter() Stop a Slf4jReporter previously created by a call to addSlf4jReporter(Duration, String) and release it for GC.
static MetricManager	valueOf(String name) Returns the enum constant of this type with the specified name.
static MetricManager[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

INSTANCE

public static final MetricManager INSTANCE

Method Detail

values

public static MetricManager[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (MetricManager c : MetricManager.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static MetricManager valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

getRegistry

public com.codahale.metrics.MetricRegistry getRegistry()

Return the JanusGraph Metrics registry.

Returns:

the single MetricRegistry used for all of JanusGraph's Metrics monitoring

addConsoleReporter

public void addConsoleReporter(Duration reportInterval)

Create a ConsoleReporter attached to the JanusGraph Metrics registry.

Parameters:

reportInterval - time to wait between dumping metrics to the console

removeConsoleReporter

public void removeConsoleReporter()

Stop a ConsoleReporter previously created by a call to addConsoleReporter(Duration) and release it for GC. Idempotent between calls to the associated add method. Does nothing before the first call to the associated add method.

addCsvReporter

public void addCsvReporter(Duration reportInterval,
                           String output)

Create a CsvReporter attached to the JanusGraph Metrics registry.

The output argument must be non-null but need not exist. If it doesn't already exist, this method attempts to create it by calling File.mkdirs().

Parameters:

reportInterval - time to wait between dumping metrics to CSV files in the configured directory

output - the path to a directory into which Metrics will periodically write CSV data

removeCsvReporter

public void removeCsvReporter()

Stop a CsvReporter previously created by a call to addCsvReporter(Duration, String) and release it for GC. Idempotent between calls to the associated add method. Does nothing before the first call to the associated add method.

addJmxReporter

public void addJmxReporter(String domain,
                           String agentId)

Create a JmxReporter attached to the JanusGraph Metrics registry.

If domain or agentId is null, then Metrics's uses its own internal default value(s).

If agentId is non-null, then MBeanServerFactory.findMBeanServer(String agentId) must return exactly one MBeanServer. The reporter will register with that server. If the findMBeanServer(String agentId) call returns no or multiple servers, then this method logs an error and falls back on the Metrics default for agentId.

Parameters:

domain - the JMX domain in which to continuously expose metrics

agentId - the JMX agent ID

removeJmxReporter

public void removeJmxReporter()

Stop a JmxReporter previously created by a call to addJmxReporter(String, String) and release it for GC. Idempotent between calls to the associated add method. Does nothing before the first call to the associated add method.

addSlf4jReporter

public void addSlf4jReporter(Duration reportInterval,
                             String loggerName)

Create a Slf4jReporter attached to the JanusGraph Metrics registry.

If loggerName is null, or if it is non-null but LoggerFactory.getLogger(Class loggerName) returns null, then Metrics's default Slf4j logger name is used instead.

Parameters:

reportInterval - time to wait between writing metrics to the Slf4j logger

loggerName - the name of the Slf4j logger that receives metrics

removeSlf4jReporter

public void removeSlf4jReporter()

Stop a Slf4jReporter previously created by a call to addSlf4jReporter(Duration, String) and release it for GC. Idempotent between calls to the associated add method. Does nothing before the first call to the associated add method.

addGraphiteReporter

public void addGraphiteReporter(String host,
                                int port,
                                String prefix,
                                Duration reportInterval)

Create a GraphiteReporter attached to the JanusGraph Metrics registry.

If prefix is null, then Metrics's internal default prefix is used (empty string at the time this comment was written).

Parameters:

host - the host to which Graphite reports are sent

port - the port to which Graphite reports are sent

prefix - the optional metrics prefix

reportInterval - time to wait between sending metrics to the configured Graphite host and port

removeGraphiteReporter

public void removeGraphiteReporter()

Stop a GraphiteReporter previously created by a call to addGraphiteReporter(String, int, String, Duration) and release it for GC. Idempotent between calls to the associated add method. Does nothing before the first call to the associated add method.

removeAllReporters

public void removeAllReporters()

Remove all JanusGraph Metrics reporters previously configured through the add* methods on this class.

getCounter

public com.codahale.metrics.Counter getCounter(String name)

getCounter

public com.codahale.metrics.Counter getCounter(String prefix,
                                               String... names)

getTimer

public com.codahale.metrics.Timer getTimer(String name)

getTimer

public com.codahale.metrics.Timer getTimer(String prefix,
                                           String... names)

getHistogram

public com.codahale.metrics.Histogram getHistogram(String name)

getHistogram

public com.codahale.metrics.Histogram getHistogram(String prefix,
                                                   String... names)

remove

public boolean remove(String name)