librato-rails 0.8.2 → 0.9.0

data/CHANGELOG.md

@@ -0,0 +1,86 @@
+### Version 0.9.0
+* Bump librato-metrics dependency version for new functionality
+
+### Version 0.8.2
+* Allow override of logging location (Rick Martinez)
+
+### Version 0.8.1
+* Bump librato-metrics to fix issue with Rails 3.1.6
+
+### Version 0.8.0
+* Add support for terser `LIBRATO_` prefixed environment variables
+* Deprecate `LIBRATO_METRICS_` prefixed environment variables
+* Always check worker, not just in forking servers
+* Refactor configuration/logging functionality into standalone modules
+
+### Version 0.7.3
+* More resilient handling of invalid metric/source names
+* Don't start if provided source is invalid
+
+### Version 0.7.2
+* Relax multi_json version requirement to allow running with Rails 3.1/3.0
+* Fix exception if current environment is not in config file
+* Always respect LIBRATO_METRICS_LOG_LEVEL env variable for easier startup debugging
+* Add more debugging statements in startup sequence
+
+### Version 0.7.1
+* Support for Passenger 4 (James Miller)
+
+### Version 0.7.0
+* Add configurable log_level for easier debugging
+* Show settings during startup in debug mode
+* Logs are now redirected to be visible when running on Heroku
+* Fix running with unicorn on Heroku
+* Don't start on Heroku without an explicit source being set
+* Improve log messages
+* Clean up tracing output for measurements
+* Remove redundant per-measurement time tracking
+* Add some initial benchmarks of instrumenting performance
+* Added troubleshooting and heroku setup sections to README
+* Documentation improvements
+
+### Version 0.6.0
+* Add support for custom sources per measurement via increment
+* Add support for custom sources per measurement via measure/timing
+* Add support for sporadic (non-continuous) increment metrics
+* Aggregate metrics by source by default
+* Don't append pids to sources by default anymore
+* Start extracting collector behaviors into Collector
+* measure/timing metrics prefix now updates dynamically if .prefix changes after startup
+* Fix issue with some helpers not being found when running on unicorn
+* Fix issue with sometimes attempting submission without full credentials
+* Documentation improvements
+
+### Version 0.5.2
+* Fix bug where measure/timing events don't apply global prefix properly
+* Fix bug where increment events could have missing values if not called
+
+### Version 0.5.1
+* Remove old helper libs which may cause load conflict for rails helpers
+* Don't lock mutex during duration of timing blocks
+
+### Version 0.5.0
+* Support block form of timing
+* Config option to disable pid inclusion in source (Chris Roby)
+* Change prefix handling to be global for all reported metrics
+* Fix misassignment of source to prefix
+
+### Version 0.4.1
+* Fix whitespace-before-params warning.
+
+### Version 0.4.0
+* Support ERB config file using env variables. (Justin Smestad)
+* Precedence changed to favor YAML config (if present) over env vars.
+  Mirrors Heroku add-on model. (Justin Smestad)
+* Report counters as gauge increments instead.
+
+### Version 0.3.1
+* Fix config file fields to match new env variables
+
+### Version 0.3.0
+* Rename to librato-rails
+* Change env variables to LIBRATO_METRICS_USER and LIBRATO_METRICS_TOKEN
+
+### Version 0.2.0
+* Add rack middleware component (Pat Allan)
+* Fix config file detection (Rafael Chacon)

data/README.md

@@ -165,6 +165,48 @@ end
 
 Symbols can be used interchangably with strings for metric names.
 
+## Use with ActiveSupport::Notifications
+
+`librato-rails` and [ActiveSupport::Notifications](http://api.rubyonrails.org/classes/ActiveSupport/Notifications.html) work great together. In fact, many of the Rails metrics provided are produced by subscribing to the [instrumentation events](http://edgeguides.rubyonrails.org/active_support_instrumentation.html) built into Rails.
+
+Assume you have a custom event:
+
+```ruby
+ActiveSupport::Notifications.instrument 'my.event', :user => user do
+  # do work..
+end
+```
+
+Writing a subscriber to capture that event and its outcomes is easy:
+
+```ruby
+ActiveSupport::Notifications.subscribe 'my.event' do |*args|
+  event = ActiveSupport::Notifications::Event.new(*args)
+  user = event.payload[:user]
+
+  # track every time the event happens
+  Librato.increment 'my.event'
+
+  # track how long the event is taking
+  Librato.timing 'my.event.time', event.duration
+
+  # use payload data to do user-specific tracking
+  Librato.increment 'user.did.event', :source => user.id, :sporadic => true
+
+  # do conditional tracking
+  if user.feature_on?(:sample_group)
+    Librato.increment 'user.sample.event'
+  end
+
+  # track slow events
+  if event.duration >= 50.0
+    Librato.increment 'my.event.slow'
+  end
+end
+```
+
+These are just a few examples. Combining `ActiveSupport::Notifications` instrumentation with Librato can be extremely powerful. As an added benefit, using the instrument/subscribers model allows you to isolate complex instrumentation code from your main application codebase.
+
 ## Custom Prefix
 
 You can set an optional prefix to all metrics reported by `librato-rails` in your [configuration](https://github.com/librato/librato-rails/wiki/Configuration). This can be helpful for isolating test data or forcing different apps to use different metric names.

data/lib/librato/rails/version.rb

@@ -1,5 +1,5 @@
 module Librato
   module Rails
-    VERSION = "0.8.2"
+    VERSION = "0.9.0"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: librato-rails
 version: !ruby/object:Gem::Version
-  version: 0.8.2
+  version: 0.9.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-01-24 00:00:00.000000000 Z
+date: 2013-08-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -34,7 +34,7 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 1.0.2
+        version: 1.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -42,7 +42,7 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 1.0.2
+        version: 1.1.0
 - !ruby/object:Gem::Dependency
   name: sqlite3
   requirement: !ruby/object:Gem::Requirement
@@ -64,17 +64,17 @@ dependencies:
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: 2.0.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: 2.0.3
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -118,6 +118,7 @@ files:
 - LICENSE
 - Rakefile
 - README.md
+- CHANGELOG.md
 - test/dummy/app/assets/javascripts/application.js
 - test/dummy/app/assets/javascripts/home.js
 - test/dummy/app/assets/javascripts/status.js
@@ -155,12 +156,8 @@ files:
 - test/dummy/config/routes.rb
 - test/dummy/config/unicorn.rb
 - test/dummy/config.ru
-- test/dummy/db/development.sqlite3
 - test/dummy/db/migrate/20120719231810_create_users.rb
 - test/dummy/db/schema.rb
-- test/dummy/db/test.sqlite3
-- test/dummy/log/development.log
-- test/dummy/log/test.log
 - test/dummy/public/404.html
 - test/dummy/public/422.html
 - test/dummy/public/500.html
@@ -168,24 +165,6 @@ files:
 - test/dummy/Rakefile
 - test/dummy/README.rdoc
 - test/dummy/script/rails
-- test/dummy/tmp/cache/assets/CBF/9D0/sprockets%2F541895701c40c7d7fd678356b18cb59d
-- test/dummy/tmp/cache/assets/CD8/370/sprockets%2F357970feca3ac29060c1e3861e2c0953
-- test/dummy/tmp/cache/assets/CDF/870/sprockets%2Fb878faf942403e313a5b103e5d80488e
-- test/dummy/tmp/cache/assets/CE8/7E0/sprockets%2F178e2a1f9aa891d473009c7f3095df28
-- test/dummy/tmp/cache/assets/CF9/7C0/sprockets%2F40fc2f3d2a468a00e463f1d313cb1683
-- test/dummy/tmp/cache/assets/D02/220/sprockets%2F1410fa948b990522bdfeca7841d31b13
-- test/dummy/tmp/cache/assets/D04/890/sprockets%2F587335c079eef8d5a63784fc8f99905a
-- test/dummy/tmp/cache/assets/D05/D40/sprockets%2F1c9faaf28d05409b88ad3113374d613c
-- test/dummy/tmp/cache/assets/D19/710/sprockets%2F5b878936d488c1f601c231fda1d678ea
-- test/dummy/tmp/cache/assets/D32/A10/sprockets%2F13fe41fee1fe35b49d145bcc06610705
-- test/dummy/tmp/cache/assets/D4E/1B0/sprockets%2Ff7cbd26ba1d28d48de824f0e94586655
-- test/dummy/tmp/cache/assets/D4F/000/sprockets%2F25e44896aac12384727e9dab827ebef9
-- test/dummy/tmp/cache/assets/D5A/EA0/sprockets%2Fd771ace226fc8215a3572e0aa35bb0d6
-- test/dummy/tmp/cache/assets/D69/610/sprockets%2F3902e4b1ffbdb61222bf5fc45a44799a
-- test/dummy/tmp/cache/assets/D8B/F90/sprockets%2Ffe6ce696e9141eb755d8eed79128e17c
-- test/dummy/tmp/cache/assets/D98/8B0/sprockets%2Fedbef6e0d0a4742346cf479f2c522eb0
-- test/dummy/tmp/cache/assets/DDC/400/sprockets%2Fcffd775d018f68ce5dba1ee0d951a994
-- test/dummy/tmp/cache/assets/E04/890/sprockets%2F2f5173deea6c795b8fdde723bb4b63af
 - test/fixtures/config/librato.yml
 - test/fixtures/config/simple.yml
 - test/integration/custom_test.rb
@@ -216,7 +195,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -1850471496259477953
+      hash: 928415932724141645
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -225,10 +204,10 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -1850471496259477953
+      hash: 928415932724141645
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.24
+rubygems_version: 1.8.23
 signing_key: 
 specification_version: 3
 summary: Use Librato Metrics with your Rails 3 app
@@ -270,12 +249,8 @@ test_files:
 - test/dummy/config/routes.rb
 - test/dummy/config/unicorn.rb
 - test/dummy/config.ru
-- test/dummy/db/development.sqlite3
 - test/dummy/db/migrate/20120719231810_create_users.rb
 - test/dummy/db/schema.rb
-- test/dummy/db/test.sqlite3
-- test/dummy/log/development.log
-- test/dummy/log/test.log
 - test/dummy/public/404.html
 - test/dummy/public/422.html
 - test/dummy/public/500.html
@@ -283,24 +258,6 @@ test_files:
 - test/dummy/Rakefile
 - test/dummy/README.rdoc
 - test/dummy/script/rails
-- test/dummy/tmp/cache/assets/CBF/9D0/sprockets%2F541895701c40c7d7fd678356b18cb59d
-- test/dummy/tmp/cache/assets/CD8/370/sprockets%2F357970feca3ac29060c1e3861e2c0953
-- test/dummy/tmp/cache/assets/CDF/870/sprockets%2Fb878faf942403e313a5b103e5d80488e
-- test/dummy/tmp/cache/assets/CE8/7E0/sprockets%2F178e2a1f9aa891d473009c7f3095df28
-- test/dummy/tmp/cache/assets/CF9/7C0/sprockets%2F40fc2f3d2a468a00e463f1d313cb1683
-- test/dummy/tmp/cache/assets/D02/220/sprockets%2F1410fa948b990522bdfeca7841d31b13
-- test/dummy/tmp/cache/assets/D04/890/sprockets%2F587335c079eef8d5a63784fc8f99905a
-- test/dummy/tmp/cache/assets/D05/D40/sprockets%2F1c9faaf28d05409b88ad3113374d613c
-- test/dummy/tmp/cache/assets/D19/710/sprockets%2F5b878936d488c1f601c231fda1d678ea
-- test/dummy/tmp/cache/assets/D32/A10/sprockets%2F13fe41fee1fe35b49d145bcc06610705
-- test/dummy/tmp/cache/assets/D4E/1B0/sprockets%2Ff7cbd26ba1d28d48de824f0e94586655
-- test/dummy/tmp/cache/assets/D4F/000/sprockets%2F25e44896aac12384727e9dab827ebef9
-- test/dummy/tmp/cache/assets/D5A/EA0/sprockets%2Fd771ace226fc8215a3572e0aa35bb0d6
-- test/dummy/tmp/cache/assets/D69/610/sprockets%2F3902e4b1ffbdb61222bf5fc45a44799a
-- test/dummy/tmp/cache/assets/D8B/F90/sprockets%2Ffe6ce696e9141eb755d8eed79128e17c
-- test/dummy/tmp/cache/assets/D98/8B0/sprockets%2Fedbef6e0d0a4742346cf479f2c522eb0
-- test/dummy/tmp/cache/assets/DDC/400/sprockets%2Fcffd775d018f68ce5dba1ee0d951a994
-- test/dummy/tmp/cache/assets/E04/890/sprockets%2F2f5173deea6c795b8fdde723bb4b63af
 - test/fixtures/config/librato.yml
 - test/fixtures/config/simple.yml
 - test/integration/custom_test.rb