| 1 | # Statsd Cluster Proxy
|
| 2 |
|
| 3 | Statsd Cluster Proxy is a udp proxy that sits infront of multiple statsd instances.
|
| 4 |
|
| 5 | Create a proxyConfig.js file:
|
| 6 |
|
| 7 | `cp exampleProxyConfig.js proxyConfig.js`
|
| 8 |
|
| 9 | Once you have modified your config file run:
|
| 10 |
|
| 11 | `node proxy.js proxyConfig.js`
|
| 12 |
|
| 13 |
|
| 14 | It uses a consistent hashring to send the unique metric names to the same statsd instances so that
|
| 15 | the aggregation works properly.
|
| 16 |
|
| 17 | It handles a simple health check that dynamically recalculates the hashring if a statsd instance goes offline.
|
| 18 |
|
| 19 | Config Options are documented in the [exampleProxyConfig.js][exampleProxyConfig.js]
|
| 20 |
|
| 21 | ## Notes
|
| 22 |
|
| 23 | In your statsd configuration make sure to have the following configuration set: `deleteIdleStats: true`
|
| 24 |
|
| 25 | We plan to remove this restriction in the near future: [#pull/348][pull_348]
|
| 26 |
|
| 27 | [exampleProxyConfig.js]: https://github.com/etsy/statsd/blob/master/exampleProxyConfig.js
|
| 28 | [pull_348]: https://github.com/etsy/statsd/pull/348
|