Description

GraphiteAPI Middleware provides a way to interacting with Graphite's Carbon Daemon, by setting up the GraphiteAPI-Middleware daemon. This method implements Graphite's plaintext protocol for communication.

• Multiple Graphite Servers Support - GraphiteAPI-Middleware supports sending aggregated data to multiple graphite servers, in a multiplex fashion, useful for large data centers and backup purposes
• Reanimation mode - support cases which the same keys (same timestamps as well) can be received simultaneously and asynchronously from multiple input sources, in these cases GraphiteAPI-Middleware will "reanimate" old records (records that were already sent to Graphite server), and will send the sum of the reanimated record value + the value of the record that was just received to the graphite server; this new summed record should override the key with the new value on Graphite database.
• non-blocking I/O ( EventMachine aware ).
• Thread-Safe client.

Install stable version

gem install graphite-api-middleware

• After installing this gem, the graphite-api-middleware command should be available.

  workspace $ graphite-api-middleware -h
  GraphiteAPI Middleware Server
  Usage:
    graphite-api-middleware <graphite-uri>...
                [-d | --daemonize]
                [-p=<port> | --port=<port>]
                [-l=<log-file> | --log-file=<log-file>]
                [-L=<log-level> | --log-level=<log-leve>]
                [-P=<pid-file> | --pid-file=<pid-file>]
                [-i=<interval> | --interval=<interval>]
                [-s=<slice> | --slice=<slice>]
                [-r=<reanimation> | --reanimation=<reanimation>]
                [-m=<aggregation-method> | --aggregation-method=<aggregation-method>]
    graphite-api-middleware -v | --version
    graphite-api-middleware -h | --help
  
  
  Arguments:
    <graphite-uri> List of URIs (seperated by spaces) that point to graphite API servers [udp,tcp]://host:port
  
  Options:
    -h, --help                                                         Show this screen.
    -v, --version                                                      Show version.
    -d, --daemonize                                                    Run as a daemon.
    -p=<port>, --port=<port>                                           Listening port for this server.
    -l=<log-file>, --log-file=<log-file>                               Listening port for this server.
    -L=<log-level>, --log-level=<log-level>                            Log level (defaults to warn).
    -P=<pid-file>, --pid-file=<pid-file>                               Path to the PID to use (defaults to /var/run/graphite-api-middleware.pid).
    -i=<interval>, --interval=<interval>                               The interval to wait between each report (defaults to 60).
    -s=<slice>, --slice=<slice>                                        This middleware will send reports to graphite in slices of X seconds (defaults to 60).
    -r=<reanimation>, --reanimation=<reanimation>                      Reanimate records that are younger than X hours, please see README.
    -m=<aggregation-method>, --aggregation-method=<aggregation-method> The aggregation method (sum, avg or replace) for multiple reports in the same time slice (defaults to s
  um).
  
  More Info @ https://github.com/kontera-technologies/graphite-api-middleware
  

• launch GraphiteAPI-Middleware daemon

  workspace $ graphite-api-middleware graphite-server:2003 graphite-backup-server:2003 \
    --port 2005                                                                        \
    --interval 60                                                                      \
    --log-level debug                                                                  \
    --log-file /tmp/graphite-api-middleware.out                                        \
    --daemonize                                                                        
  

• Send metrics via UDP/TCP sockets

  workspace $ telnet localhost 2005
  Trying 127.0.0.1...
  Connected to localhost.
  Escape character is '^]'.
  example.middleware.value 10.2 1335008343
  example.middleware.value2 99 1334929231
  ^C
  workspace $
  

After checking out the repo, run bundle install to install dependencies. Before submitting a pull request, run rake test to run the tests.

To install this gem onto your local machine, run bundle exec rake install.

1. Run gem bump -v [major|minor|patch|alpha|beta|pre] to bump the version number of this gem and create a new git commit for it.
2. Run git push to push the changes.
3. Run gem tag to create a git tag for this version.
4. Run git push --tags to push the tag to git.
5. Run gem release to build the gem and push it to rubygems.

Bug reports and pull requests are welcome on GitHub at https://github.com/Eyal_Shalev/graphite-api-middleware. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

If you find a bug, feel free to report it @ our issues tracker on github.

It is free software, and may be redistributed under the terms specified in LICENSE.

Everyone interacting in the graphite-api-middleware project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.

This software is provided “as is” and without any express or implied warranties, including, without limitation, the implied warranties of merchantability and fitness for a particular purpose.