chonton / dogstatd-client

A java client to push UDP messages to a local dogstatd.

UP FOR ADOPTION

dogstatd-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

dogstatd-client's Issues

Missing Public constructors

The constructors of Event and ServiceCheck classes have no access modifiers so it cannot be instantiated outside their package. They should have public constructors

Notify the patterns to validate the metrics.

When I'm using this library, I don't find the pattern to validate the metrics parameters. (On the Readme.)

If you like, I can take my time to add it!.

Missing information in JAVADOC.

I analysed your code and I saw you missing to put the parameter throttleInterval in the javadoc...

Can you add please? Has datadog some restriction to send more than 1 message per minute?

I tried to found this information in the datadog documentation but I didn't found.

dogstatd-client/src/main/java/org/honton/chas/dogstatd/model/Sender.java

Line 81 in 7b6a701

public Sender(InetSocketAddress socket, long throttleInterval) {