statsd.md

Statsd output plugin

Status : core plugin, unit tested and maintained.

This plugin is used send data to statsd.

Example: to send, for each line of nginx log, a counter with value 1, key nginx.request, on a statsd instance located on port 8125. Config using url: output://statsd://localhost:8125?only_type=nginx&metric_type=increment&metric_key=nginx.request

Config using logstash format:

output {
  if [type] == nginx {
    statsd {
      host => localhost
      port => 8125
      metric_type => increment
      metric_key => nginx.request
    }
  }
}

Parameters:

• host: ip of the statsd server.
• port: port of the statsd server.
• metric_type: one of increment, decrement, counter, timer, gauge. Type of value to send to statsd.
• metric_key: key to send to statsd.
• metric_value: metric value to send to statsd. Mandatory for timer, counter and gauge type.
• cache_*: cache configuration for resolving host. More doc at cache. (By default, the UDP node stack will resolve the host field for each write. This behaviour can be expensive).

metric_key and metric_value can reference log line properties (see interpolation).

Example: metric_key=nginx.response.#{status}