Companion component to Metron that receives Statsd and emits Dropsonde to Metron

The following instructions may help you get started with statsd-injector in a standalone environment.

• Go should be installed and in the PATH
• etcd should be installed and in the PATH
• GOPATH should be set as described in http://golang.org/doc/code.html
• loggregator should be included in the GOPATH if you want to run integration tests.

export GOPATH=$GOPATH:$WORKSPACE/loggregator

Download statsd-injector:

go get -v github.com/cloudfoundry/statsd-injector
cd src/github.com/cloudfoundry/statsd-injector

To install exactly the dependecies vendored with statsd-injector, use godep:

go get -v github.com/tools/godep
godep restore ./...

We are using Ginkgo, to run tests. To run the tests execute:

bin/test

As an example, if you want the injector to be present on loggregator boxes, add the following in cf-lamb.yml

   loggregator_templates:
   - name: doppler
     release: (( lamb_meta.release.name ))
   - name: syslog_drain_binder
     release: (( lamb_meta.release.name ))
   - name: metron_agent
     release: (( lamb_meta.release.name ))
+  - name: statsd-injector
+    release: (( lamb_meta.release.name ))

You can emit statsd metrics to the injector by sending a correctly formatted message to udp port 8125

As an example using netcat:

echo "origin.some.counter:1|c" | nc -u -w0 127.0.0.1 8125

You should see the metric come out of the firehose.

The injector expects the the name of the metric to be of the form <origin>.<metric_name>