strong-statsd

Control a statsd child process.

Uses strongloop-forks/strong-fork-statsd, a fork of etsy/statsd with support
for being controlled by a parent process.

Usage

$3

Constructor.

$3

Options:

- debug: cause statsd to log debug messages
- scope: prefix to add before all metric names (default is "", but also,
if the statsd: backend URL is used, it can provide a scope that will
override this option)
- expandScope: function to call on scope before using it as a prefix
- flushInterval: accumulated metrics will be processed and emitted at this
interval, in seconds (default is 15)

$3

Specify one or more backends.

Backend URL formats:

- statsd://[][:]: publish metrics to a statsd receiver. The host
defaults to "localhost", and the port defaults to 8125.

- log:[]: log metrics to FILE, which may be - to indicate stdout (FILE
defaults to -). Format is ISOTIMESTAMP METRIC=VALUE (TYPE), where TYPE is
one of count, gauge, or ms (a timer interval in milliseconds).

- debug:[?pretty[=]]: json dump to stdout for testing and
debugging backends. Pretty output is formatted as multi-line with color,
otherwise it's single line.

- graphite://[][:]: forward to
graphite, host defaults to
"localhost", port defaults to 2003

- syslog:[?[application=][&priority=]: write to
local system log using syslog(3). The application defaults to "statsd",
and priority defaults to "LOG_INFO", but can be set to any of "LOG_DEBUG",
"LOG_INFO", "LOG_NOTICE", "LOG_WARNING", or "LOG_CRIT".

- splunk://[]:: write using a UDP key value protocol to splunk,
host defaults to localhost, and port is mandatory, since the protocol has no
assigned port.

Throws on error in URL format, returns self on success.

$3

Starts statsd child process, callback indicates when it is started, and the
statsd port is known.

$3

The port that the statsd server is listening on.

$3

A statsd: URL that contains the PORT and (unexpanded) scope that should be
published to. The publish is usually done by .send(), but this URL may
be useful for display or debug purposes.

$3

Send statsd metric with name and value. Metrics are discarded until statsd
is started.

$3

Stop the statsd child, callback indicates it has exited.

Stopping is optional, the child will self-exit when the parent process exits.