seismograph 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 56e91905b4b222e1e0c31c603a79f30d74abe237
-  data.tar.gz: dd10317f3aeb103d6d1816f0321cfe52d5ef0480
+  metadata.gz: e5743575f4bdb4b9dd9f7ca25482606de38502d3
+  data.tar.gz: b47eab1c3fc019430a334e128412b705398ba7de
 SHA512:
-  metadata.gz: a692a017eff498426e72e92d616c27b8631fa30e89133f29c2476c8219874faccc7dc5536e354c353d6772a1ce4638daf872a7039920876eb190709cf6f9a91b
-  data.tar.gz: 471321f5a40efa733ccf3b3175bffa77ea65819cef7ba84107d407034cde76f76b7ef6ef1cb2d317ed0ff547d1f1e81d455c5cd436e5ae410e6905de3c92f2ff
+  metadata.gz: 9e8c3d4f2026fd9b0059d2dc122140d4c38ad41ad601d82421b6828fa143c78a461527b5686b01f41954e78b6c51be072753a6fd851a2a76062bcc722777e217
+  data.tar.gz: 6b1abff70f44c56dc656d55c5b8d76ac123269a4e3efb163ad256d6c01312c96ae80c3f41aedc208a8641a627c6f07d85891d98b114179437a7d092a8d387fde

data/README.md

@@ -77,6 +77,32 @@ def create
 end
 ```
 
+### Timing:
+
+Timing is useful for tracking how long an operation takes, when that operation
+has already been run. For example, in the subscriber to an
+`ActiveSupport::Instrumentation` event. Expects the duration argument to be in
+ms (which the ActiveSupport event.duration already is).
+
+```ruby
+class ActiveJobSubscriber < ActiveSupport::Subscriber
+
+  attach_to :active_job
+
+  def perform(event)
+    job = event.payload[:job]
+    tags = ["jobs:#{job.name}", "queue:#{job.queue_name}"]
+
+    sensor.timing "perform", event.duration, sample_rate: 0.5, tags: tags
+  end
+
+  def sensor
+    @sensor ||= Seismograph::Sensor.new("active_job")
+  end
+
+end
+```
+
 ### Incrementing/Decrementing:
 
 Simple incrementing and decrementing can be performed on a stat.  Both methods accept a numeric
@@ -87,6 +113,15 @@ sensor.increment('memberships')
 sensor.decrement('memberships', 2)
 ```
 
+### Gauge:
+
+Gauge is meant for static numbers that you want to track over time (as opposed to a rate for which
+you would use `#count`).
+
+```ruby
+sensor.gauge('collection_count', Collection.count)
+```
+
 ### Logging events:
 
 Logging can be used for tracking critical events.  Valid log methods are `info`, `warning`,

data/circle.yml

@@ -1,3 +1,3 @@
 dependencies:
   pre:
-    - gem install bundler -v 1.10.6
+    - gem install bundler -v 1.11.2

data/lib/seismograph/gateway.rb

@@ -3,10 +3,12 @@ require 'statsd'
 module Seismograph
   module Gateway
     class << self
-      [:histogram, :increment, :decrement, :time, :event].each do |method|
-        define_method(method) do |*args, &block|
-          client.send(method, *args, &block)
-        end
+      [:histogram, :increment, :decrement, :time, :timing, :event, :gauge].each do |method|
+        class_eval <<-RUBY, __FILE__, __LINE__+1
+          def #{method}(*a, &b)
+            client.send(:#{method}, *a, &b)
+          end
+        RUBY
       end
 
       private

data/lib/seismograph/log.rb

@@ -6,10 +6,12 @@ module Seismograph
       include Parameterize
 
       [:info, :error, :warning, :success].each do |alert_type|
-        define_method alert_type do |message, params = {}|
-          description = params.delete(:description) || ''
-          log(message, description, params.merge(alert_type: alert_type.to_s))
-        end
+        class_eval <<-RUBY, __FILE__, __LINE__+1
+          def #{alert_type}(message, params = {})
+            description = params.delete(:description) || ''
+            log(message, description, params.merge(alert_type: "#{alert_type}"))
+          end
+        RUBY
       end
 
       private

data/lib/seismograph/sensor.rb

@@ -23,12 +23,22 @@ module Seismograph
       Gateway.decrement(stat(description), gateway_params(params))
     end
 
+    # Record the time (in ms) when the code has already been executed. Useful for
+    # ActiveSupport::Instrumentation event.duration (which is already in ms)
+    def timing(description, duration, params = {})
+      Gateway.timing(stat(description), duration, gateway_params(params))
+    end
+
     def benchmark(description, params = {}, &block)
       with_success_and_failure(description, params) do
         Gateway.time(stat(description), gateway_params(params), &block)
       end
     end
 
+    def gauge(description, value, params = {})
+      Gateway.gauge(stat(description), value, gateway_params(params))
+    end
+
     private
 
     def track(description, amount, params = {})

data/lib/seismograph/version.rb

@@ -1,3 +1,3 @@
 module Seismograph
-  VERSION = '0.3.0'
+  VERSION = '0.3.1'
 end

data/seismograph.gemspec

@@ -21,7 +21,7 @@ Gem::Specification.new do |spec|
   spec.add_runtime_dependency 'dogstatsd-ruby', '~> 1.5'
 
   spec.add_development_dependency 'pry-nav'
-  spec.add_development_dependency 'bundler', '~> 1.10.0'
+  spec.add_development_dependency 'bundler', '~> 1.11.0'
   spec.add_development_dependency 'rake', '~> 10.0'
   spec.add_development_dependency 'rspec', '~> 3.2'
   spec.add_development_dependency 'rspec-its', '~> 1.2'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: seismograph
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Brandon Croft
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-10-08 00:00:00.000000000 Z
+date: 2016-01-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dogstatsd-ruby
@@ -45,14 +45,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.10.0
+        version: 1.11.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.10.0
+        version: 1.11.0
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement