https://github.com/rj/estatsd
Erlang stats aggregation app that periodically flushes data to graphite
https://github.com/rj/estatsd
Last synced: 21 days ago
JSON representation
Erlang stats aggregation app that periodically flushes data to graphite
- Host: GitHub
- URL: https://github.com/rj/estatsd
- Owner: RJ
- License: mit
- Created: 2011-05-20T16:10:40.000Z (about 14 years ago)
- Default Branch: master
- Last Pushed: 2012-05-28T15:39:46.000Z (almost 13 years ago)
- Last Synced: 2025-04-25T13:13:48.367Z (26 days ago)
- Language: Erlang
- Homepage:
- Size: 519 KB
- Stars: 87
- Watchers: 7
- Forks: 48
- Open Issues: 2
-
Metadata Files:
- Readme: README.txt
- License: LICENSE.txt
Awesome Lists containing this project
README
estatsd is a simple stats aggregation service that periodically dumps data to
Graphite: http://graphite.wikidot.com/
NB: Graphite is good, despite the website being a bit ghetto.
Inspired heavily by etsy statsd:
http://codeascraft.etsy.com/2011/02/15/measure-anything-measure-everything/
QUICK DEMO
==========
1) Install and configure graphite (quick-ish)
2) Install rebar, have it in your path
3) rebar compile
4) erl -pa ebin
5) > application:start(estatsd).
> estatsd:increment(foo, 123).
6) Observe graphite now has 1 data point.
USAGE
=====
Add this app to your rebar deps, and make sure it's started somehow
eg: application:start(estatsd).
You can configure custom graphite host/port and flush interval using
application environment vars. See estatsd_sup for details.
The following calls to estatsd are all gen_server:cast, ie non-blocking.
Gauges
--------
estatsd:gauge(temperature, 45). %% set temperature to 45
Counters
--------
estatsd:increment(num_foos). %% increment num_foos by one
estatsd:decrement(<<"num_bars">>, 3). %% decrement num_bars by 3
estatsd:increment("tcp.bytes_in", 512). %% increment tcp.bytes_in by 512
Timers
------
estatsd:timing(sometask, 1534). %% report that sometask took 1534ms
Or for your convenience:
Start = erlang:now(),
do_sometask(),
estatsd:timing(sometast, Start). %% uses now() and now_diff for you
NOTES
=====
This could be extended to take a callback for reporting mechanisms.
Right now it's hardcoded to stick data into graphite.
I've been running this since May 2011 in production for irccloud.
Richard Jones
@metabrew