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>