heroku-unicorn-metrics 1.0.0

data/README.md

@@ -0,0 +1,39 @@
+# Heroku Unicorn Metrics
+
+Report on Unicorn queued connections using [Raindrops](http://raindrops.bogomips.org/) and the [Raindrops::Linux](http://raindrops.bogomips.org/Raindrops/Linux.html) features. 
+
+## Usage
+
+First, add `heroku-unicorn-metrics` to your Gemfile:
+
+```
+gem 'heroku-unicorn-metrics'
+```
+
+Then subscribe to the `unicorn.metrics.request` notifcation in your Rails app. For example, to print queue information to your logs, add the following to `config/initializers/notifcations.rb:
+
+```
+# config/initializers/notifications.rb
+ActiveSupport::Notifications.subscribe(/unicorn.metrics.request/) do |*args|
+  event = ActiveSupport::Notifications::Event.new(*args)
+  payload = event.payload
+
+  addr = payload[:addr]
+  active = payload[:requests][:active]
+  queued = payload[:requests][:queued]
+  queue_time = payload[:queue_time]
+
+  puts "STATS addr=#{addr} active=#{active} queued=#{queued} queue_time=#{queue_time} "
+end
+```
+
+For more information, see the [ActiveSupport::Notification](http://api.rubyonrails.org/classes/ActiveSupport/Notifications.html) docs.
+
+## Data
+
+The following information is sent in the notification payload:
+
+* `requests[:active]`: Number of requests currently being processed by Unicorn at the start of the request
+* `requests[:queued]`: Number of requests waiting to be processed at the start of the request
+* `queue_time`: Amount of time the current request spent in the queue
+* `addr`: Address of the dyno processing the request

data/heroku-unicorn-metrics.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "heroku/version"
+
+Gem::Specification.new do |s|
+  s.name        = "heroku-unicorn-metrics"
+  s.version     = Heroku::UnicornMetrics::VERSION
+  s.authors     = ["dominic (Dominic Dagradi)"]
+  s.email       = ["dominic@heroku.com"]
+  s.homepage    = "http://github.com/heroku/heroku-unicorn-metrics"
+  s.summary     = %q{Additional metrics for Heroku apps using Unicorn}
+  s.description = %q{Additional metrics for Heroku apps using Unicorn}
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency 'unicorn'
+  s.add_dependency 'rails', ">= 3.0"
+end

data/lib/heroku-unicorn-metrics.rb

@@ -0,0 +1,2 @@
+require 'heroku/middleware'
+require 'heroku/railtie' if defined?(Rails)

data/lib/heroku/middleware.rb

@@ -0,0 +1,39 @@
+require 'socket'
+
+module Heroku
+  module UnicornMetrics
+    class Queue
+      ADDR = IPSocket.getaddress(Socket.gethostname).to_s+':'+ENV['PORT']
+
+      def initialize(app)
+        @app = app
+      end
+
+      def call(env)
+        start_time = Time.now.to_f*1000.0
+        stats = raindrops_stats
+
+        status, headers, body = @app.call(env)
+
+        stats[:addr] = ADDR
+        stats[:queue_time] = headers['X-Request-Start'] ? (start_time - headers['X-Request-Start'].to_f).round : 0
+
+        ActiveSupport::Notifications.instrument("unicorn.metrics.queue", stats)
+
+        [status, headers, body]
+      end
+
+    private
+
+      def raindrops_stats
+        if defined? Raindrops::Linux.tcp_listener_stats
+          stats = Raindrops::Linux.tcp_listener_stats([ '0.0.0.0:'+ENV['PORT'] ])['0.0.0.0:'+ENV['PORT']]
+          return { :requests => { :active => stats.active, :queued => stats.queued }}
+        else
+          return { :requests => { :active => 0, :queued => 0 }}
+        end
+      end
+
+    end
+  end
+end

data/lib/heroku/railtie.rb

@@ -0,0 +1,10 @@
+module Heroku
+  module UnicornMetrics
+    class UnicornMetricsRailtie < Rails::Railtie
+      initializer "my_railtie.configure_rails_initialization" do |app|
+        app.middleware.use Raindrops::Middleware
+        app.middleware.use Heroku::UnicornMetrics::Queue
+      end
+    end
+  end
+end

data/lib/heroku/version.rb

@@ -0,0 +1,5 @@
+module Heroku
+  module UnicornMetrics
+    VERSION = "1.0.0"
+  end
+end

metadata

@@ -0,0 +1,83 @@
+--- !ruby/object:Gem::Specification
+name: heroku-unicorn-metrics
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- dominic (Dominic Dagradi)
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-03-06 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: unicorn
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Additional metrics for Heroku apps using Unicorn
+email:
+- dominic@heroku.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- heroku-unicorn-metrics.gemspec
+- lib/heroku-unicorn-metrics.rb
+- lib/heroku/middleware.rb
+- lib/heroku/railtie.rb
+- lib/heroku/version.rb
+homepage: http://github.com/heroku/heroku-unicorn-metrics
+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'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Additional metrics for Heroku apps using Unicorn
+test_files: []