slate 0.0.1

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.sw*

data/.travis.yml

@@ -0,0 +1,8 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - jruby-18mode # JRuby in 1.8 mode
+  - jruby-19mode # JRuby in 1.9 mode
+  - rbx-18mode
+  - rbx-19mode
+  - 1.8.7

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in graphite.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Trae Robrock
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,30 @@
+# Slate
+[![Build Status](https://secure.travis-ci.org/trobrock/slate.png)](http://travis-ci.org/trobrock/slate)
+
+Simple wrapper to the Graphite render api
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'slate'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install slate
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/lib/slate.rb

@@ -0,0 +1,16 @@
+require "slate/version"
+require "slate/configuration"
+require "slate/render"
+require "slate/calculation"
+
+require "slate/calculation/mean"
+
+module Slate
+  def self.configure
+    yield Configuration.instance
+  end
+
+  def self.configuration
+    Configuration.instance
+  end
+end

data/lib/slate/calculation.rb

@@ -0,0 +1,21 @@
+require 'json'
+
+module Slate
+  module Calculation
+    class Base
+      def initialize(graph)
+        @graph = graph
+      end
+
+      def result
+        nil # Override this
+      end
+
+      protected
+
+      def data
+        @data ||= JSON.parse(@graph.download(:json)).first["datapoints"].map(&:first).compact
+      end
+    end
+  end
+end

data/lib/slate/calculation/mean.rb

@@ -0,0 +1,9 @@
+module Slate
+  module Calculation
+    class Mean < Base
+      def result
+        data.inject(0.0, :+) / data.size.to_f
+      end
+    end
+  end
+end

data/lib/slate/configuration.rb

@@ -0,0 +1,9 @@
+require 'singleton'
+
+module Slate
+  class Configuration
+    include Singleton
+
+    attr_accessor :endpoint
+  end
+end

data/lib/slate/render.rb

@@ -0,0 +1,77 @@
+require 'cgi'
+require 'rest_client'
+
+module Slate
+  class Render
+    def initialize(options={})
+      @target = options[:target]
+      @from   = options[:from]
+      @until  = options[:until]
+      @functions = []
+    end
+
+    def url(format=:png)
+      options = url_options.merge("format" => format.to_s)
+      "#{Configuration.instance.endpoint}/render?#{params(options)}"
+    end
+
+    def download(format=:png)
+      RestClient.get url(format)
+    end
+
+    def add_function(*function)
+      if function.size > 1
+        arguments = function[1..-1]
+        @functions << [function.first.to_sym, arguments]
+      else
+        @functions << function.first.to_sym
+      end
+
+      target
+    end
+
+    def target
+      target = @target
+      @functions.each do |function|
+        if function.is_a? Symbol
+          target = %Q{#{function}(#{target})}
+        else
+          args = arguments(function.last).join(",")
+          target = %Q{#{function.first}(#{target},#{args})}
+        end
+      end
+
+      target
+    end
+
+    private
+
+    def arguments(args=[])
+      args.map do |arg|
+        if arg.is_a?(Numeric)
+          arg.to_s
+        elsif arg.is_a?(Slate::Render)
+          arg.send(:target)
+        else
+          %Q{"#{arg}"}
+        end
+      end
+    end
+
+    def url_options
+      options = {
+        "target" => target
+      }
+      options["from"]  = @from if @from
+      options["until"] = @until if @until
+
+      options
+    end
+
+    def params(options={})
+      options.map do |key,value|
+        "#{CGI.escape(key)}=#{CGI.escape(value)}"
+      end.join("&")
+    end
+  end
+end

data/lib/slate/version.rb

@@ -0,0 +1,3 @@
+module Slate
+  VERSION = "0.0.1"
+end

data/script.rb

@@ -0,0 +1,61 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'bundler/setup'
+require 'slate'
+
+WINDOW = ARGV[0] || "-1w"
+
+def log(title, value)
+  format = "[%17s] %01.2f\n"
+  printf format, title, value
+end
+
+Slate.configure do |c|
+  c.endpoint = "http://statsd.outright.com"
+end
+
+graph = Slate::Render.new(target: "stats.timers.rack.*.response_time.upper_90", from: WINDOW)
+graph.add_function :avg
+graph.add_function :summarize, "1h", "avg"
+
+app_response_time = Slate::Calculation::Mean.new(graph).result
+
+graph = Slate::Render.new(target: "stats.rack.*.status_code.success", from: WINDOW)
+graph.add_function :sum
+
+total_graph = Slate::Render.new(target: "stats.rack.*.status_code.*", from: WINDOW)
+total_graph.add_function :exclude, "missing"
+total_graph.add_function :sum
+
+graph.add_function :asPercent, total_graph
+
+app_success_rate = Slate::Calculation::Mean.new(graph).result
+
+
+
+graph = Slate::Render.new(target: "stats.timers.agg.thrift.*.response_time.upper_90", from: WINDOW)
+graph.add_function :avg
+graph.add_function :summarize, "1h", "avg"
+
+agg_response_time = Slate::Calculation::Mean.new(graph).result
+
+
+graph = Slate::Render.new(target: "stats.agg.thrift.*.status_code.success", from: WINDOW)
+graph.add_function :sum
+
+total_graph = Slate::Render.new(target: "stats.agg.thrift.*.status_code.*", from: WINDOW)
+total_graph.add_function :exclude, "missing"
+total_graph.add_function :sum
+
+graph.add_function :asPercent, total_graph
+
+agg_success_rate = Slate::Calculation::Mean.new(graph).result
+
+log "App Response Time", app_response_time
+log "App Success Rate" , app_success_rate
+log "App Uptime"       , 0
+print "\n"
+log "Agg Response Time", agg_response_time
+log "Agg Success Rate" , agg_success_rate
+log "Agg Uptime"       , 0

data/slate.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'slate/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "slate"
+  gem.version       = Slate::VERSION
+  gem.authors       = ["Trae Robrock"]
+  gem.email         = ["trobrock@gmail.com"]
+  gem.description   = %q{Simple api on top of the graphite render api}
+  gem.summary       = %q{Simple wrapper on top of the graphite render api}
+  gem.homepage      = "https://github.com/trobrock/slate"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_dependency "rest-client", "~> 1.6.7"
+  gem.add_dependency "json", "~> 1.7.5"
+  gem.add_dependency "jruby-openssl" if RUBY_PLATFORM == 'java'
+
+  gem.add_development_dependency "rake"
+  gem.add_development_dependency "rspec"
+  gem.add_development_dependency "mocha"
+  gem.add_development_dependency "webmock"
+end

data/spec/slate/calculation/mean_spec.rb

@@ -0,0 +1,24 @@
+require File.join(File.dirname(__FILE__), '..', '..', 'spec_helper')
+
+describe Slate::Calculation::Mean do
+  before do
+    @graph = Slate::Render.new(:target => "some.stat")
+    data = [
+      {
+        "target" => "some.stat",
+        "datapoints" => [
+          [1.0, 1352143990],
+          [0.0, 1352144000],
+          [2.0, 1352145000],
+          [3.0, 1352146000]
+        ]
+      }
+    ]
+    @graph.stubs(:download).with(:json).returns(JSON.generate(data))
+  end
+
+  it "should calculate the mean of the series" do
+    calculation = Slate::Calculation::Mean.new(@graph)
+    calculation.result.should == 1.5
+  end
+end

data/spec/slate/render_spec.rb

@@ -0,0 +1,89 @@
+require File.join(File.dirname(__FILE__), '..', 'spec_helper')
+
+describe Slate::Render do
+  before(:each) do
+    Slate.configure { |c| c.endpoint = "http://graphite" }
+
+    @png_stub  = "PNG Image Data"
+    @raw_stub  = "RAW Image Data"
+    @csv_stub  = "CSV,Image,Data"
+    @json_stub = "{ \"JSON\": \"Image Data\" }"
+    @svg_stub  = "SVG Image Data"
+
+    stub_download :png , @png_stub
+    stub_download :raw , @raw_stub
+    stub_download :csv , @csv_stub
+    stub_download :json, @json_stub
+    stub_download :svg , @svg_stub
+  end
+
+  it "should be able to get a single target" do
+    graph = Slate::Render.new(:target => "app.server01.load")
+    query(graph.url).should include("target" => "app.server01.load", "format" => "png")
+  end
+
+  it "should be able to apply functions" do
+    graph = Slate::Render.new(:target => "app.server01.load")
+    graph.add_function :cumulative
+    graph.url.should include(CGI.escape("cumulative(app.server01.load)"))
+
+    graph = Slate::Render.new(:target => "app.server01.load")
+    graph.add_function :cumulative
+    graph.add_function :alias, "load"
+    graph.url.should include(CGI.escape("alias(cumulative(app.server01.load),\"load\""))
+
+    graph = Slate::Render.new(:target => "app.server01.load")
+    graph.add_function :summarize, "1s", "sum"
+    graph.url.should include(CGI.escape("summarize(app.server01.load,\"1s\",\"sum\")"))
+
+    graph = Slate::Render.new(:target => "app.server01.load")
+    graph.add_function :movingAverage, 10
+    graph.url.should include(CGI.escape("movingAverage(app.server01.load,10)"))
+  end
+
+  it "should be able to accept other graphs as options to a function" do
+    graph = Slate::Render.new(:target => "app.server01.load")
+
+    other_graph = Slate::Render.new(:target => "app.server*.load")
+    other_graph.add_function :sum
+
+    graph.add_function :asPercent, other_graph
+
+    graph.url.should include(CGI.escape("asPercent(app.server01.load,sum(app.server*.load))"))
+  end
+
+  it "should be able to specify start and end times" do
+    graph = Slate::Render.new(:target => "app.server01.load", :from => "-1d")
+    graph.url.should match(/from=-1d/)
+
+    graph = Slate::Render.new(:target => "app.server01.load", :until => "-1d")
+    graph.url.should match(/until=-1d/)
+
+    graph = Slate::Render.new(:target => "app.server01.load", :from => "-1d", :until => "-6h")
+    graph.url.should match(/from=-1d/)
+    graph.url.should match(/until=-6h/)
+  end
+
+  it "should provide methods for retrieving formats" do
+    graph = Slate::Render.new(:target => "app.server01.load")
+    graph.url(:png).should  match(/format=png/)
+    graph.url(:raw).should  match(/format=raw/)
+    graph.url(:csv).should  match(/format=csv/)
+    graph.url(:json).should match(/format=json/)
+    graph.url(:svg).should  match(/format=svg/)
+  end
+
+  it "should retrieve the graph" do
+    graph = Slate::Render.new(:target => "app.server01.load")
+    graph.download(:png).should  eq(@png_stub)
+    graph.download(:raw).should  eq(@raw_stub)
+    graph.download(:csv).should  eq(@csv_stub)
+    graph.download(:json).should eq(@json_stub)
+    graph.download(:svg).should  eq(@svg_stub)
+  end
+end
+
+def stub_download(format, body="")
+  stub_request(:get, "http://graphite/render?format=#{format}&target=app.server01.load").
+    to_return(:status => 200, :body => body, :headers => {})
+end

data/spec/slate_spec.rb

@@ -0,0 +1,11 @@
+require File.join(File.dirname(__FILE__), 'spec_helper')
+
+describe Slate do
+  it "should be able to configure the graphite host" do
+    Slate.configure do |c|
+      c.endpoint = "http://graphite"
+    end
+
+    Slate.configuration.endpoint.should == "http://graphite"
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,28 @@
+require "slate"
+require "webmock/rspec"
+require "mocha_standalone"
+require "uri"
+require "cgi"
+
+RSpec.configure do |config|
+  # Use color in STDOUT
+  config.color_enabled = true
+
+  # Use color not only in STDOUT but also in pagers and files
+  config.tty = true
+
+  # Use the specified formatter
+  config.formatter = :documentation # :progress, :html, :textmate
+
+  config.mock_framework = :mocha
+end
+
+def query(url)
+  CGI.parse(URI.parse(url).query).inject({}) do |h, x|
+    key = x.first
+    val = x.last
+    h[key] = val.size == 1 ? val.first : val
+
+    h
+  end
+end

metadata

@@ -0,0 +1,169 @@
+--- !ruby/object:Gem::Specification
+name: slate
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Trae Robrock
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-11-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.7
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.7
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.7.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.7.5
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Simple api on top of the graphite render api
+email:
+- trobrock@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/slate.rb
+- lib/slate/calculation.rb
+- lib/slate/calculation/mean.rb
+- lib/slate/configuration.rb
+- lib/slate/render.rb
+- lib/slate/version.rb
+- script.rb
+- slate.gemspec
+- spec/slate/calculation/mean_spec.rb
+- spec/slate/render_spec.rb
+- spec/slate_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/trobrock/slate
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -1369003764169049016
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -1369003764169049016
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Simple wrapper on top of the graphite render api
+test_files:
+- spec/slate/calculation/mean_spec.rb
+- spec/slate/render_spec.rb
+- spec/slate_spec.rb
+- spec/spec_helper.rb