fast_stack 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f5d6bf89b44f458eee3423d52a00738e01775dbb
-  data.tar.gz: e5a1f5edd19dd540976f792f8a12f4c03cc6ed7e
+  metadata.gz: a7b203e805558207a896a66af413dfbbf48fbf0d
+  data.tar.gz: f8aaa3a556df3007d936e21c7983512ab04f1eea
 SHA512:
-  metadata.gz: ceab9df8d2414a03f97ae9b7fd08f4c4970a52f32782603b391aa22cbd2c1347610dbd3e0c3b46f5a3ed5e213541e573ba2fffdf8b8232e89a6e944074deaa46
-  data.tar.gz: f42ea3067770e197cfe00adcff3f0c7ec96507021db7f9690d24b4ebd741e2a70d2b8e5864b610abb256bc53d72be75fdef6968b15649664448318f815999c60
+  metadata.gz: 6eef1b4399175be510fc9a93c5948d0791b6d2139b3da100cbecd39fabe1fb3d33397d198faf91d2218fe6e20570e843dd71de9478f5fd2430cc8b6da21c7b02
+  data.tar.gz: fd2f07f355adb448f7feeeb716a5c9f748d9fccfe1baf9ad26bebea1bf9ff0894ea7eaddd61bd37a18f9d66aa19ed324e6308061d47ebcf9841bb7d21788cc09

data/README.md

@@ -1,5 +1,6 @@
 ### Fast stack
 
+Very efficient collection of ruby backtraces, even under heavy CPU load
 
 ### How do you use it?
 
@@ -8,4 +9,25 @@
 ### Usage
 
 
+```
+  def fib( n )
+    return  n  if ( 0..1 ).include? n
+    ( fib( n - 1 ) + fib( n - 2 ) )
+  end
+
+  stacks = FastStack.profile do
+    fib(30)
+  end
+  
+  puts stacks.count
+  # 30 
+  
+```
+
+### Notes
+
+This technique was conceived by https://github.com/tmm1 , big thank you. 
+
+Ruby 2.0 uses #backtrace_locations, 1.9.3 uses #backtrace
+
 (gem template based on https://github.com/CodeMonkeySteve/fast_xor )

data/lib/fast_stack.rb

@@ -1,14 +1,54 @@
 require 'fast_stack/fast_stack'
 module FastStack
   def self.profile(millisecs=1, &blk)
+    done = false
     stacks = []
     thread = Thread.current
+    delta = millisecs / 1000.0
+    last_time = Time.new
+
+    new_api = thread.respond_to?(:backtrace_locations)
+
+    # NOTE not extracting to another method to avoid adding a frame
+    #  to the stack
+
+    # this thread catches stuff fast stack does not
+    # the main case is catching sleeping threads
+    profile_thread = Thread.new do
+      until done
+        start = Time.new
+        if last_time < start - delta
+          last_time = start
+          stacks << (new_api ? thread.backtrace_locations : thread.backtrace)
+        end
+
+        sleep(delta)
+      end
+    end
 
     trap('PROF') do
-      stacks << thread.backtrace_locations
+      start = Time.new
+      if last_time < start - delta
+        last_time = start
+        stack = (new_api ? thread.backtrace_locations : thread.backtrace)
+        # I am not sure if this is ensured to run in the thread
+        # though in my samples it does
+        if thread == Thread.current
+          stack = stack[2..-1]
+          # since we are in the same thread, might as well remove
+          #  our overhead
+          start = Time.new
+        end
+        stacks << stack
+      end
     end
 
-    profile_block(millisecs * 1000, &blk)
+    begin
+      profile_block(millisecs * 1000, &blk)
+    ensure
+      done = true
+      profile_thread.join
+    end
 
     stacks
   end

data/spec/fast_stack_spec.rb

@@ -23,8 +23,6 @@ describe String do
       fib(30)
     end
 
-    p s.count
-
     expect(s.count).to be > 10
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fast_stack
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - Sam Saffron