Statsd output plugin v3.1.4

Getting Help

For questions about the plugin, open a topic in the Discuss forums. For bugs or feature requests, open an issue in Github.
For the list of Elastic supported plugins, please consult the Elastic Support Matrix.

Description

statsd is a network daemon for aggregating statistics, such as counters and timers,
and shipping over UDP to backend services, such as Graphite or Datadog. The general
idea is that you send metrics to statsd and every few seconds it will emit the
aggregated values to the backend. Example aggregates are sums, average and maximum
values, their standard deviation, etc. This plugin makes it easy to send such
metrics based on data in Logstash events.

Typical examples of how this can be used with Logstash include counting HTTP hits
by response code, summing the total number of bytes of traffic served, and tracking
the 50th and 95th percentile of the processing time of requests.

Each metric emitted to statsd has a dot-separated path, a type, and a value. The
metric path is built from the namespace and sender options together with the
metric name that’s picked up depending on the type of metric. All in all, the
metric path will follow this pattern:

namespace.sender.metric

With regards to this plugin, the default namespace is "logstash", the default
sender is the host field, and the metric name depends on what is set as the
metric name in the increment, decrement, timing, count, set or gauge
options. In metric paths, colons (":"), pipes ("|") and at signs ("@") are reserved
and will be replaced by underscores ("_").

id

Add a unique ID to the plugin configuration. If no ID is specified, Logstash will generate one.
It is strongly recommended to set this ID in your configuration. This is particularly useful
when you have two or more plugins of the same type. For example, if you have 2 statsd outputs.
Adding a named ID in this case will help in monitoring Logstash when using the monitoring APIs.