graphite-api-middleware 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 2d8f0e57a178f384b38405f15f092e986e88fa5585055cdbe65e893da2db4fa4
+  data.tar.gz: b278408d5aab2272821259e5f3dc3a4d03e4b63b74ccdc0f69adcef5ba64c4e8
+SHA512:
+  metadata.gz: 2e21491fcc8861de88a3b1756da647302aaf0fea3f7bcdf6d87361a6027abf4b82e0a584d857a6e589c567d33d5d55ceff739f6b25c511160257c0fcfb1c9cd2
+  data.tar.gz: 5a04645a1a4531549134266d76cae67d5777dd35d23a4cbfb4f068ae8a337c25a02c56dfde05506470dcb054362afb250fc9d5b512aa7561c92828205269e616

data/LICENSE.txt

@@ -0,0 +1,11 @@
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License V3 as published by
+the Free Software Foundation.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with this program.  If not, see <http://www.gnu.org/licenses/>.

data/README.md

@@ -0,0 +1,113 @@
+# 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](http://graphite.readthedocs.org/en/1.0/feeding-carbon.html) 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](https://badge.fury.io/rb/graphite-api-middleware.svg)](https://badge.fury.io/rb/graphite-api-middleware)
+[![Build Status](https://travis-ci.org/kontera-technologies/graphite-api-middleware.svg?branch=master)](https://travis-ci.org/kontera-technologies/graphite-api-middleware)
+[![Test Coverage](https://codecov.io/gh/kontera-technologies/graphite-api-middleware/branch/master/graph/badge.svg)](https://codecov.io/gh/kontera-technologies/graphite-api-middleware)
+
+## 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](/examples/middleware_t1.png)
+
+## 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](https://github.com/kontera-technologies/graphite-api-middleware/issues) on github.
+
+## License
+It is free software, and may be redistributed under the terms specified in [LICENSE](/LICENSE.txt).
+
+## 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.

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+task :default => :test

data/bin/graphite-api-middleware

@@ -0,0 +1,77 @@
+#!/usr/bin/env ruby
+$:.unshift File.expand_path('../../lib',__FILE__)
+
+require 'graphite-api-middleware'
+require 'docopt'
+
+FILE_NAME = File.basename(__FILE__)
+options = GraphiteApiMiddleware::Server.default_options
+
+doc = <<DOCOPT
+Graphite API Middleware Server
+Usage:
+  #{FILE_NAME} <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>]
+  #{FILE_NAME} -v | --version
+  #{FILE_NAME} -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 #{options[:pid]}).
+  -i=<interval>, --interval=<interval>                               The interval to wait between each report (defaults to #{options[:interval]}).
+  -s=<slice>, --slice=<slice>                                        This middleware will send reports to graphite in slices of X seconds (defaults to #{options[:slice]}).
+  -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 #{options[:default_aggregation_method]}).
+
+More Info @ https://github.com/kontera-technologies/graphite-api-middleware
+DOCOPT
+
+begin
+  opts = Docopt::docopt(doc)
+
+  if opts["--version"]
+    puts "GraphiteAPI Middleware #{GraphiteApiMiddleware::VERSION}"
+    exit 0
+  end
+
+  raise "Invalid aggregation method. Valid values are sum, avg or replace." unless ["sum", "avg", "replace", nil].include? opts["--aggregation-method"]
+
+  options[:backends] = opts["<graphite-uri>"]
+  options[:port] = opts["--port"] if opts["--port"]
+  options[:log_file] = File::expand_path opts["--log-file"] if opts["--log-file"]
+  options[:log_level] = opts["--log-level"] if opts["--log-level"]
+  options[:pid] = opts["<pid>"] if opts["<pid>"]
+  options[:daemonize] = opts["--daemonize"]
+  options[:interval] = opts["--interval"].to_i if opts["--interval"].to_i > 0
+  options[:slice] = opts["--slice"].to_i if opts["--slice"].to_i > 0
+  options[:cache] = opts["--cache"].to_i * 3600 if opts["--cache"].to_i > 0
+  options[:default_aggregation_method] = opts["--aggregation-method"].to_sym if opts["--aggregation-method"]
+
+  logger = Logger.new options[:log_file] ||  STDOUT
+  logger.level= Logger.const_get options[:log_level].to_s.upcase
+  Process.daemon if options[:daemonize]
+  GraphiteApiMiddleware::Server.start options, logger
+rescue Docopt::Exit => e
+  puts e.message
+rescue Interrupt
+  logger.info "Shutting down..."
+  Zscheduler.stop
+rescue StandardError => e
+  puts (Docopt::Exit.new e.message).message
+end

data/lib/graphite-api-middleware/version.rb

@@ -0,0 +1,3 @@
+module GraphiteAPIMiddleware
+  VERSION = "1.0.0"
+end

data/lib/graphite-api-middleware.rb

@@ -0,0 +1,82 @@
+# -----------------------------------------------------
+# Graphite Middleware Server
+# Should be placed between graphite server and graphite clients
+# - Data Aggregator
+# - Caching
+# - Data Manipulation
+# -----------------------------------------------------
+# Usage:
+#   GraphiteApiMiddleware::Server.start(options)
+#
+# Options:
+#   graphite         target graphite hostname
+#   reanimation_exp  cache lifetime in seconds  (default is 43200 seconds)
+#   prefix           add prefix to each key
+#   interval         report to graphite every X seconds (default is 60)
+#   slice            send to graphite in X seconds slices (default is 60)
+#   log_level        info
+# -----------------------------------------------------
+require "graphite-api-middleware/version"
+require 'graphite-api'
+require 'eventmachine'
+require 'socket'
+require 'logger'
+
+module GraphiteApiMiddleware
+  class Server < EventMachine::Connection
+
+    def initialize buffer, logger
+      @buffer = buffer and super
+      @logger = logger
+    end
+
+    attr_reader :buffer, :client_id
+
+    def post_init
+      @client_id = peername
+      @logger.debug [:middleware, :connecting, client_id]
+    end
+
+    def receive_data data
+      @logger.debug [:middleware, :message, client_id, data]
+      buffer.stream data, client_id
+    end
+
+    def unbind
+      @logger.debug [:middleware, :disconnecting, client_id]
+    end
+
+    def peername
+      port, *ip = get_peername[2,6].unpack "nC4"
+      [ip.join("."),port].join ":"
+    end
+
+    private :peername
+
+    def self.default_options
+      GraphiteAPI::Client.default_options.merge interval: 60, pid: '/var/run/graphite-api-middleware.pid'
+    end
+
+    def self.start options, logger
+      EventMachine.run do
+        GraphiteAPI::Logger.logger = logger
+        logger.info "Server running on port #{options[:port]}"
+
+        buffer = GraphiteAPI::Buffer.new options
+        group  = GraphiteAPI::Connector::Group.new options
+
+        # Starting server
+        [:start_server, :open_datagram_socket].each do |m|
+          EventMachine.send(m, '0.0.0.0', options[:port], self, buffer, logger)
+        end
+
+        # Send metrics to graphite every X seconds
+        Zscheduler.every(options[:interval], :on_shutdown => true) do
+          group.publish buffer.pull :string if buffer.new_records?
+        end
+
+      end
+    end
+
+  end
+end

data/test/functional/middleware_sanity_test.rb

@@ -0,0 +1,86 @@
+require "test_helper"
+require 'eventmachine'
+require 'socket'
+
+module GraphiteApiMiddleware::Tests
+  class MiddlewareSanityTest < TestCase
+    EM_STOP_AFTER = 4
+    MIDDLEWARE_STARTUP_WAIT = 1
+    MIDDLEWARE_STOP_WAIT = 1
+    MIDDLEWARE_BIN_FILE = File.expand_path("../../../bin/graphite-api-middleware", __FILE__)
+
+    def setup
+      @middleware_port = Utils.random_non_repeating_port
+      @mock_server_port = Utils.random_non_repeating_port
+      @data = []
+      Utils.stop_em_if_running
+    end
+
+    def start_middleware middleware_port, mock_server_port, aggregation_method=nil, interval=2
+      options = %W(tcp://localhost:#{mock_server_port} --port #{middleware_port} --interval #{interval} -L error)
+      options += ["--aggregation-method", aggregation_method] if aggregation_method
+      @pid = Process.spawn("ruby", MIDDLEWARE_BIN_FILE, *options)
+      sleep MIDDLEWARE_STARTUP_WAIT
+    end
+
+    def teardown
+      Process.kill(:KILL, @pid)
+      sleep MIDDLEWARE_STOP_WAIT
+    end
+
+    def test_with_defaults
+      start_middleware @middleware_port, @mock_server_port
+      EventMachine.run {
+        EventMachine.start_server("0.0.0.0", @mock_server_port, MockServer, @data)
+        socket = TCPSocket.new("0.0.0.0", @middleware_port)
+        1.upto(1000) do
+          socket.puts("shuki.tuki1 1.1 123456789\n")
+          socket.puts("shuki.tuki2 10 123456789\n")
+          socket.puts("shuki.tuki3 10 123456789\n")
+        end
+        EventMachine::Timer.new(EM_STOP_AFTER, &EM.method(:stop))
+      }
+
+      expected = [
+        "shuki.tuki1 1100.0 123456780",
+        "shuki.tuki2 10000.0 123456780",
+        "shuki.tuki3 10000.0 123456780"
+      ]
+      assert_expected_equals_data expected
+    end
+
+    def test_with_avg
+      start_middleware @middleware_port, @mock_server_port, 'avg'
+      EventMachine.run {
+        EventMachine.start_server("0.0.0.0", @mock_server_port, MockServer, @data)
+        socket = TCPSocket.new("0.0.0.0", @middleware_port)
+        1.upto(1000) do
+          socket.puts("shuki.tuki1 1.0 123456789\n")
+          socket.puts("shuki.tuki1 1.2 123456789\n")
+        end
+        EventMachine::Timer.new(EM_STOP_AFTER, &EM.method(:stop))
+      }
+
+      assert_expected_equals_data ["shuki.tuki1 1.1 123456780"]
+    end
+
+    def test_with_replace
+      start_middleware @middleware_port, @mock_server_port, 'replace'
+      EventMachine.run {
+        EventMachine.start_server("0.0.0.0", @mock_server_port, MockServer, @data)
+        socket = TCPSocket.new("0.0.0.0", @middleware_port)
+        1.upto(1000) do
+          socket.puts("shuki.tuki1 10.0 123456789\n")
+          socket.puts("shuki.tuki1 5.0 123456789\n")
+        end
+        EventMachine::Timer.new(EM_STOP_AFTER, &EM.method(:stop))
+      }
+
+      assert_expected_equals_data ["shuki.tuki1 5.0 123456780"]
+    end
+
+    def assert_expected_equals_data expected
+      assert_equal expected, @data.map {|o| o.split("\n")}.flatten(1).map(&:strip)
+    end
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,42 @@
+$LOAD_PATH.unshift File.expand_path("../../lib", __FILE__)
+
+require 'simplecov'
+require 'simplecov-rcov'
+require 'codecov'
+require "minitest/autorun"
+
+SimpleCov.start { add_filter "/tests/" }
+SimpleCov.formatter = Class.new do
+  def format(result)
+     SimpleCov::Formatter::Codecov.new.format(result) if ENV["CODECOV_TOKEN"]
+     SimpleCov::Formatter::RcovFormatter.new.format(result) unless ENV["CI"]
+  end
+end
+
+require "graphite-api-middleware"
+
+module GraphiteApiMiddleware::Tests
+  class TestCase < Minitest::Test
+  end
+
+  module Utils
+    def self.random_non_repeating_port
+      @ports ||= (1000..9999).to_a.shuffle
+      @ports.pop
+    end
+
+    def self.stop_em_if_running
+      EM.stop if EM.reactor_running?
+      sleep 0.1 while EM.reactor_running?
+    end
+  end
+
+  module MockServer
+    def initialize db
+      @db = db
+    end
+    def receive_data data
+      @db.push data
+    end
+  end
+end

metadata

@@ -0,0 +1,194 @@
+--- !ruby/object:Gem::Specification
+name: graphite-api-middleware
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Eran Levi
+- Eyal Shalev
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-03-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: docopt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: eventmachine
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.3.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.3.3
+- !ruby/object:Gem::Dependency
+  name: zscheduler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.0.7
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.0.7
+- !ruby/object:Gem::Dependency
+  name: graphite-api
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.16'
+- !ruby/object:Gem::Dependency
+  name: codecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: simplecov-rcov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: gem-release
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: Interact with Graphite's Carbon Daemon through this middleware
+email:
+- eran@kontera.com
+- eyalsh@gmail.com
+executables:
+- graphite-api-middleware
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/graphite-api-middleware
+- lib/graphite-api-middleware.rb
+- lib/graphite-api-middleware/version.rb
+- test/functional/middleware_sanity_test.rb
+- test/test_helper.rb
+homepage: https://github.com/kontera-technologies/graphite-api-middleware
+licenses:
+- LGPL-3.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3
+signing_key: 
+specification_version: 4
+summary: Aggregator daemon for Graphite API
+test_files: []