1 [![Build Status](https://travis-ci.org/ibnfirnas/beam_stats.svg?branch=master)](https://travis-ci.org/ibnfirnas/beam_stats)
6 Periodically collects and pushes VM metrics to arbitrary consumer processes,
7 which, in-turn, can do whatever they want with the given data (such as
8 serialize and forward to some time series storage). Includes, off by default,
9 example implementations of consumers for:
11 - StatsD (`beam_stats_consumer_statsd`)
12 - Graphite (`beam_stats_consumer_graphite`)
13 - CSV file (`beam_stats_consumer_csv`)
15 Essentially like `folsomite`, but different. Different in the following ways:
17 - More-general: consumers other than graphite can be defined
18 - More-focused: only concerned with VM metrics, while `folsomite` ships off
19 _everything_ from `folsom` (in addition to VM metrics)
20 - Easier-(for me!)-to-reason-about implementation:
21 + Well-defined metrics-to-binary conversions, as opposed to the
22 nearly-arbitrary term-to-string conversions used in `folsomite`
23 + Spec'd, tested and Dialyzed
27 #### At app config time
31 [ {production_interval , 30000}
33 [ {beam_stats_consumer_statsd,
34 [ {consumption_interval , 60000}
35 , {dst_host , "localhost"}
39 , {beam_stats_consumer_graphite,
40 [ {consumption_interval , 60000}
41 , {host , "localhost"}
45 , {beam_stats_consumer_csv,
46 [ {consumption_interval , 60000}
47 , {path , "beam_stats.csv"}
49 , {some_custom_consumer_module,
50 [ {some_custom_option_a, "abc"}
51 , {some_custom_option_b, 123}
61 beam_stats_consumer:add(consumer_module, ConsumerOptions).
64 ### Removing consumers