@q42philips/statsd-daemon

Statsd Daemon

This repository contains a simple statsd UDP server. When you run it on your local machine any other application emitting StatsD metrics to localhost will end up on the console output of this statsd-deamon.

Handy if you want to verify if your metrics are what you expect them to be.

NOTE: this is by no means a full-fledged statsd aggregator.

Usage

Install

You can install globally for convenience, which will add a statsd-daemon executable to your path:

$ npm install -g @q42philips/statsd-daemon

Run

If installed globally:

$ statsd-daemon

Otherwise in this directory:

$ npm start

Contributing

Local development

You can also create a symlink in your global node modules, making the hue binary globally accessible. Note that this only works if you first uninstall the NPM version

$ npm uninstall -g @q42philips/statsd-daemon
$ npm link
$ hue <command>

And then after testing, just run

$ npm unlink
$ npm install -g @q42philips/statsd-daemon

Creating a new release

After PRs are merged to master, you can create a new version using npm. Please carefully check the changes made since the last release and choose your update type accordingly, then create a new version using the command below. This will succeed only if the tests pass, to avoid versioning broken code. It will also push the newly created tag to this repository.

$ npm version <major|minor|patch>

After creating a new version, you may publish it to the npm registry using the following command, which will automatically compile it using babel before publishing:

$ npm publish

Finally, please take the time to add a changelog to the newly created release on Github, noting the new features, fixes or other notable stuff.