Overview
StatsD backend for sending metrics to New Relic Infrastructure
Requirements
- StatsD versions >= 0.3.0.
- New Relic Infrastructure Agent >= v1.0.818
Installation
$ cd /path/to/statsd
$ npm install @newrelic/statsd-infra-backend
Enabling
- Add
@newrelic/statsd-infra-backend
backend to the list of StatsD backends in the StatsD configuration file.
{
backends: ["@newrelic/statsd-infra-backend"],
}
- Configure the necessary configuration values for running this backend:
newrelic: {
port: 5001,
rules: [
{
matchExpression: "myapp.*redis.*",
metricSchema: "{app}.{environment}.{service}.{serviceName}.{metricName}",
eventType: "RedisStatsdSample",
labels: {
role: "cache",
environment: "{environment}"
}
}
]
}
See our example config file for a complete StatsD configuration.
- Start/restart the StatsD daemon and your metrics should now be pushed to your New Relic Infrastructure account.
Development
- Fork and clone this project
- Download project dependencies using
npm
- Modify the code
- Ensure everything is running properly executing tests:
npm test
- Push the code to your fork
- Send a Pull Request
License
New Relic Infrastructure Backend for StatsD is free-to-use, proprietary software. Please see the full license (found in LICENSE in this distribution) for details on its license and the licenses of its dependencies.