statsd-appdynamics-backend v0.1.0
StatsD AppDynamics backend
Overview
This is a pluggable backend for StatsD, which publishes stats to AppDynamics using the Machine Agent custom metrics functionality.
The code converts from statsd dot notation to appdynamics pipe notation for metric path.
The 'Custom Metrics' portion of the path is automatically added.
Requirements
- StatsD versions >= 0.3.0.
- An AppDynamics account.
Installation
$ cd /path/to/statsd
$ npm install statsd-appdynamics-backend
Credits:
- Documentation & Readme copied from https://github.com/collectiveidea/statsd-instrumental-backend
- Console.js sample backend
Running the machine agent
You need to be running the AppDynamics machine agent on some host. The machine agent exposes a web interface that this statsd backend contacts. If the agent isn't running, your metrics will not flow. The Machine Agent configuration defines where your AppDynamics Controller is, credentials for accessing it, and which Application/Tier the metrics will be stored under.
start_listener.sh
might help get your machine agent running
Configuration
Add statsd-appdynamics-backend
backend to the list of StatsD
backends in the StatsD configuration file:
{
backends: ["statsd-appdynamics-backend"]
, appdynamics: { base_url: 'http://localhost:8081/machineagent/metrics', hide_statsd: false }
}
- base_url: the URL to the Machine Agent listener
- hide_statsd: enable to suppress out the statsd.bad_lines_seen and statsd.packets_received metrics
Start/restart the statsd daemon and your StatsD metrics should now be pushed to your appdynamics account.
Test signal
generate_stats.sh
will produce sample metrics data
NPM Dependencies
- http
Development
Pull Requests Accepted
10 years ago