info.ganglia.gmetric4j.gmetric

Class GMetric

java.lang.Object

info.ganglia.gmetric4j.gmetric.GMetric

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

public class GMetric
extends java.lang.Object
implements java.io.Closeable

Implements the Ganglia gmetric command in java

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	GMetric.UDPAddressingMode

Field Summary

Fields

Modifier and Type	Field and Description
private Protocol	protocol

Constructor Summary

Constructors

Constructor and Description
GMetric(java.lang.String group, int port, GMetric.UDPAddressingMode mode, int ttl) Constructs a GMetric
GMetric(java.lang.String group, int port, GMetric.UDPAddressingMode mode, int ttl, boolean ganglia311) Constructs a GMetric
GMetric(java.lang.String group, int port, GMetric.UDPAddressingMode mode, int ttl, boolean ganglia311, java.util.UUID uuid) Constructs a GMetric
GMetric(java.lang.String group, int port, GMetric.UDPAddressingMode mode, int ttl, boolean ganglia311, java.util.UUID uuid, java.lang.String spoof) Constructs a GMetric

Method Summary

Modifier and Type	Method and Description
void	announce(java.lang.String name, double value, java.lang.String group) Announces a metric
void	announce(java.lang.String name, float value, java.lang.String group) Announces a metric
void	announce(java.lang.String name, int value, java.lang.String group) Announces a metric
void	announce(java.lang.String name, long value, java.lang.String group) Announces a metric
void	announce(java.lang.String name, java.lang.String value, GMetricType type, java.lang.String units, GMetricSlope slope, int tmax, int dmax, java.lang.String group) The Ganglia Metric Client (gmetric) announces a metric
void	close() Closes the underlying protocol.
protected void	finalize()
static void	main(java.lang.String[] args) Main method that sends a test metric

Methods inherited from class java.lang.Object

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

Field Detail

protocol

private Protocol protocol

Constructor Detail

GMetric

public GMetric(java.lang.String group,
               int port,
               GMetric.UDPAddressingMode mode,
               int ttl)
        throws java.io.IOException

Constructs a GMetric

Parameters:

group - the host/group to send the event to

port - the port to send the event to

mode - the mode

ttl - time to live value

Throws:

java.io.IOException

GMetric

public GMetric(java.lang.String group,
               int port,
               GMetric.UDPAddressingMode mode,
               int ttl,
               boolean ganglia311)
        throws java.io.IOException

Constructs a GMetric

Parameters:

group - the host/group to send the event to

port - the port to send the event to

mode - adressing mode to be used (UNICAST/MULTICAST)

ttl - time to live value

ganglia311 - protocol version true=v3.1, false=v3.0

Throws:

java.io.IOException

GMetric

public GMetric(java.lang.String group,
               int port,
               GMetric.UDPAddressingMode mode,
               int ttl,
               boolean ganglia311,
               java.util.UUID uuid)
        throws java.io.IOException

Constructs a GMetric

Parameters:

group - the host/group to send the event to

port - the port to send the event to

mode - adressing mode to be used (UNICAST/MULTICAST)

ttl - time to live value

ganglia311 - protocol version true=v3.1, false=v3.0

uuid - uuid for the host

Throws:

java.io.IOException

GMetric

public GMetric(java.lang.String group,
               int port,
               GMetric.UDPAddressingMode mode,
               int ttl,
               boolean ganglia311,
               java.util.UUID uuid,
               java.lang.String spoof)
        throws java.io.IOException

Constructs a GMetric

Parameters:

group - the host/group to send the event to

port - the port to send the event to

mode - adressing mode to be used (UNICAST/MULTICAST)

ttl - time to live value

ganglia311 - protocol version true=v3.1, false=v3.0

uuid - uuid for the host

spoof - spoofing information IP:hostname

Throws:

java.io.IOException

Method Detail

announce

public void announce(java.lang.String name,
                     java.lang.String value,
                     GMetricType type,
                     java.lang.String units,
                     GMetricSlope slope,
                     int tmax,
                     int dmax,
                     java.lang.String group)
              throws GangliaException

The Ganglia Metric Client (gmetric) announces a metric

Parameters:

name - Name of the metric

value - Value of the metric

type - Type of the metric. Either string|int8|uint8|int16|uint16|int32|uint32|float|double

units - Unit of measure for the value

slope - Either zero|positive|negative|both

tmax - The maximum time in seconds between gmetric calls

dmax - The lifetime in seconds of this metric

group - Group Name of the metric

Throws:

java.lang.Exception

GangliaException

announce

public void announce(java.lang.String name,
                     int value,
                     java.lang.String group)
              throws GangliaException

Announces a metric

Parameters:

name - Name of the metric

value - Value of the metric

group - Group Name of the metric

Throws:

ganglia.GangliaException

GangliaException

announce

public void announce(java.lang.String name,
                     long value,
                     java.lang.String group)
              throws GangliaException

Announces a metric

Parameters:

name - Name of the metric

value - Value of the metric

group - Group Name of the metric

Throws:

ganglia.GangliaException

GangliaException

announce

public void announce(java.lang.String name,
                     float value,
                     java.lang.String group)
              throws GangliaException

Announces a metric

Parameters:

name - Name of the metric

value - Value of the metric

group - Group Name of the metric

Throws:

ganglia.GangliaException

GangliaException

announce

public void announce(java.lang.String name,
                     double value,
                     java.lang.String group)
              throws GangliaException

Announces a metric

Parameters:

name - Name of the metric

value - Value of the metric

group - Group Name of the metric

Throws:

ganglia.GangliaException

GangliaException

close

public void close()
           throws java.io.IOException

Closes the underlying protocol.

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Throws:

java.io.IOException

finalize

protected void finalize()
                 throws java.lang.Throwable

Overrides:

finalize in class java.lang.Object

Throws:

java.lang.Throwable

See Also:

Object.finalize()

main

public static void main(java.lang.String[] args)
                 throws java.io.IOException

Main method that sends a test metric

Parameters:

args -

Throws:

java.io.IOException