JarCastingdogstatd-client
A java client to push UDP messages to a local dogstatd.
Javadoc and build reports are available.
Requirements
- Minimal latency in the mainline processing
- Some, but not extreme buffering of outgoing messages
- Non-blocking write of UDP message
- Thread-safe sender
- Lack of dogstatd collector will be noted, but not cause failure of mainline processing
Assumptions
- A local (on the same host) dogstatd collector
- Firing a UDP message per application event will be cheaper than in-process aggregation of events
Use with Maven
To include dogstatd-client in your maven build, use the following fragment in your pom.
<dependency>
<groupId>org.honton.chas</groupId>
<artifactId>dogstatd-client</artifactId>
<version>0.0.3</version>
</dependency>
Typical Java Use
In setup code
// you only need a single instance, Sender is thread safe and send method does not block caller
static public final Sender METRICS = new Sender();
Sending some example metrics
METRICS.send(new Histogram("histogram.name", latency);
METRICS.send(new Gauge("round", i, tag));
METRICS.send(new Counter("pi", 3.14));
METRICS.send(new Event("title", "message", "tag1", "tag2"));
0.2 to 0.3
- Added public constructors for Event
- Added public constructors for ServiceCheck
- Metric changed to abstract
- Tags changed to package protected
- Validator changed to package protected