No commit activity in last 3 years
No release in over 3 years
Interact with Graphite's Carbon Daemon through this middleware
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 0.1
~> 5.0
~> 10.0
~> 0.16

Runtime

>= 0
>= 0.3.3
~> 4.3
 Project Readme

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.

Key Features

  • 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.

Status

Gem Version Build Status Test Coverage

Installation

Install stable version

gem install graphite-api-middleware

Usage

  • 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 $
    

Example Setup

example setup

Development

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.

Releasing a new version of this gem

  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.

Contributing

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.

Bugs

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

License

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

Code of Conduct

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.

Warranty

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.