Skip to content

A beat to get statsd udp messages into Elastic Search

License

Notifications You must be signed in to change notification settings

mwik/statsdbeat

 
 

Repository files navigation

Statsdbeat

Using the beat framework to send statsd formatted messages to ElasticSearch.

Download

1.0 release

What we do

We listen for UDP pacakges. And forwards them as beat.Event into Elastic Search at the index statsdbeat-<beat-version>-<yyyy-mm-dd>

Support

  • Following statsd types are supported

    Type Example
    Counters `platform-insights.test.counter.tick:1
    Gauge `platform-insights.test.gauge.num_goroutine:1
    Histogram `platform-insights.test.histogram.my_histo:17
    Timing `platform-insights.test.timing.ping:10
  • Tags (in InfluxDB notation format counter,tagName=tagValue,anotherTag=withAnotherValue:1|c)

  • Multi-Metric Packets

Configuration

statsdbeat:
  statsdserver: ":8125"    # where should we listen for the UDP messages. Typically your localhost on port 8125
  period: 5s               # interval period the events (if any) are send to the output  

Spooling

Spooling to disk is currently a beta feature. Use with care.

You can configure in statsbeat.yml the spooling to disk

output.elasticsearch:
  hosts: ["https://vpc-<your-name>.<aws-region>.es.amazonaws.com:443"]

queue:
  spool:
    file:
      flush.timeout:1s 

What we don't do (yet)

  • No pre-aggreation (roll-ups) of data before sending to Elastic Search

  • No Sets

  • No Sampling

  • No resend Gauge information ()

  • We don't compute percentile aggregations. Elastic Search has this already build in

Development

References:

About

A beat to get statsd udp messages into Elastic Search

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 87.7%
  • Makefile 7.7%
  • Python 4.6%