Skip to content

Files

Latest commit

Jan 30, 2017
1ceb60a · Jan 30, 2017

History

History
36 lines (28 loc) · 1.28 KB

statsd.md

File metadata and controls

36 lines (28 loc) · 1.28 KB

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}