Skip to content
This repository has been archived by the owner on Jun 1, 2019. It is now read-only.

Latest commit

 

History

History
71 lines (48 loc) · 2.22 KB

README.md

File metadata and controls

71 lines (48 loc) · 2.22 KB
Raw

(Deprecated) statsd-injector

Use https://github.com/cloudfoundry/statsd-injector-release

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

Getting started

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

External Dependencies

To start, you must have the latest version of Go installed and on your PATH.

Then, choose one of the following:

Running from the bosh release

The statsd-injector-release repository contains a complete GOPATH with all of the statsd-injector's dependencies frozen at known working versions. Working from that repository will guarantee the best compatibility with the bosh release.

To work from within the bosh release:

  1. Clone https://github.com/cloudfoundry/statsd-injector-release
  2. From the statsd-injector-release directory:
  3. Run git submodule update --init --recursive
  4. If you're not using direnv, run source .envrc

Running with go get

Running Tests

We are using Ginkgo, to run tests. To run the tests, execute the following from the top level directory of this repository:

ginkgo -r -race -randomizeAllSpecs

Including statsd-injector in a bosh deployment

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

Emitting metrics to the statsd-injector

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>