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.

• Machine Agent HTTP Listener docs

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