derailed_benchmarks 1.1.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 64e1d95c4daabc83570c1b4414e12e825d412224
-  data.tar.gz: a199e5d200e859f53aaeb25326d98325a860e959
+  metadata.gz: 375f243912a424ba45e64e6fd2c1aeb7c1349f1d
+  data.tar.gz: 65bc16f1ba1b5fe109c5971eac8e67c73ba30057
 SHA512:
-  metadata.gz: 5e0e983995112c57ce5925e75ff3e2fc1491ecad771f6445158688872625887710299e42cc20650a323f39c891459b99520b61475059efc97e8ebf5f2598dc70
-  data.tar.gz: b4f2972a0bb9cd35a6bd7b26fd070638b34c4a0e1f403bb2dee84f0dc913df5aae9dfb465a549097c55c9fa54504bc25dbc54f1455e3037da0c1f254e49b4423
+  metadata.gz: 7af36f99ed23a45e684fd220c497673f529227530194693fea67cffc3f9ecbecac720adda9e1fa9576f26e3051834b14584d0135e290a3b5148b1c7fd7d75001
+  data.tar.gz: 97c8617852ade4dfbf9eabfe995431be69dabf860de03d8066205ed960313d17024722cc9ae5847b5835c280e174f6fdc3661cfeb923491a80b3cf9921950280

data/CHANGELOG.md

@@ -1,24 +1,28 @@
 # A Log of Changes!
 
+## [1.1.1] - 2015-10-01
+
+- Added ability to create a heap dump `perf:heap`.
+
 ## [1.1.0] - 2015-09-09
 
 - Set custom auth user using a lambda in perf.rake
 - Changed `perf:ram_over_time` changed to `perf:mem_over_time`
 - Fixed gem warnings
 
-## [1.0.1] - 2015-20-06
+## [1.0.1] - 2015-06-20
 
 - `bundle:mem` and similar tasks now keep track of duplicate requires and display them along side of memory requirements. This makes it easier to identify where components are used by multiple libraries
 - Add rake to gemspec which gets rid of `Unresolved specs during Gem::Specification.reset:` warning
 - Outputs of memory are now done in [mebibytes](https://en.wikipedia.org/wiki/Mebibyte), a more accurate unit for the value we're measuring (hint: it's what you think MB is).
 
-## [1.0.0] - 2015-15-05
+## [1.0.0] - 2015-05-14
 
 - Added `derailed` command line utility. Can be used with just a Gemfile using command `$ derailed bundle:mem` and `$ derailed bundle:objects`. All existing Rake tasks can now be called with `$ derailed exec` such as `$ derailed exec perf:mem`.
 - Changed memory_profiler task to be `perf:objects` instead of `perf:mem`.
 - Changed boot time memory measurement to `perf:mem` instead of `perf:require_bench`
 - Released seperate [derailed](https://github.com/schneems/derailed) gem that is a wrapper for this gem. I.e. installing that gem installs this one. Easier to remember, less words to type. Also means there's no colision using the `derailed` namespace for executables inside of the `derailed_benchmarks`.
 
-## [0.0.0] - 2014-15-08
+## [0.0.0] - 2014-08-15
 
 - Initial release

data/Gemfile.lock

@@ -1,9 +1,10 @@
 PATH
   remote: .
   specs:
-    derailed_benchmarks (1.1.0)
+    derailed_benchmarks (1.1.1)
       benchmark-ips (~> 2)
       get_process_mem (~> 0)
+      heap_inspect (~> 0)
       memory_profiler (~> 0)
       rack (~> 1)
       rake (~> 10)
@@ -58,6 +59,7 @@ GEM
       warden (~> 1.2.3)
     erubis (2.7.0)
     get_process_mem (0.2.0)
+    heap_inspect (0.1.0)
     hike (1.2.3)
     i18n (0.7.0)
     journey (1.0.4)

data/README.md

@@ -271,6 +271,32 @@ This is an expensive operation, so you likely want to keep the count lowish. Onc
 
 This is is similar to `$ bundle exec derailed bundle:objects` however it includes objects created at runtime. It's much more useful for actual production performance debugging, the other is more useful for library authors to debug.
 
+## I want a Heap Dump
+
+If you're still struggling with runtime memory you can generate a heap dump that can later be analyzed using [heap_inspect](https://github.com/schneems/heap_inspect).
+
+
+```
+$ bundle exec derailed exec perf:heap
+Booting: production
+Heap file generated: "tmp/2015-10-01T12:31:03-05:00-heap.dump"
+
+Analyzing Heap
+==============
+Generation:  0 object count: 209307
+Generation: 35 object count: 31236
+Generation: 36 object count: 36705
+Generation: 37 object count: 1301
+Generation: 38 object count: 8
+
+Try uploading "tmp/2015-10-01T12:31:03-05:00-heap.dump" to http://tenderlove.github.io/heap-analyzer/
+```
+
+For more help on getting data from a heap dump see
+
+```
+$ heap_inspect --help
+```
 
 ### Memory Is large at boot.
 
@@ -410,7 +436,7 @@ change this if your app doesn't run locally with `RAILS_ENV` set to
 `production`. For example:
 
 ```
-$ RAILS_ENV=development bundle exec derailed exec perf:mem 
+$ RAILS_ENV=development bundle exec derailed exec perf:mem
 ```
 
 ## perf.rake
@@ -464,6 +490,26 @@ end
 
 Set the constant `DERAILED_APP` to your Rack app. See [schneems/derailed_benchmarks#1](https://github.com/schneems/derailed_benchmarks/pull/1) for more info.
 
+An example of setting this up could look like:
+
+
+```ruby
+# perf.rake
+
+require 'bundler'
+Bundler.setup
+
+require 'derailed_benchmarks'
+require 'derailed_benchmarks/tasks'
+
+namespace :perf do
+  task :rack_load do
+    require_relative 'lib/application'
+    DERAILED_APP = MyApplication::Routes
+  end
+end
+```
+
 ## Authentication
 
 If you're trying to test an endpoint that has authentication you'll need to tell your task how to bypass that authentication. Authentication is controlled by the `DerailedBenchmarks.auth` object. There is a built in support for Devise. If you're using some other authentication method, you can write your own authentication strategy.

data/derailed_benchmarks.gemspec

@@ -18,6 +18,7 @@ Gem::Specification.new do |gem|
   gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
   gem.require_paths = ["lib"]
 
+  gem.add_dependency "heap_inspect",    "~> 0"
   gem.add_dependency "memory_profiler", "~> 0"
   gem.add_dependency "get_process_mem", "~> 0"
   gem.add_dependency "benchmark-ips",   "~> 2"

data/lib/derailed_benchmarks/tasks.rb

@@ -263,4 +263,24 @@ namespace :perf do
     end
     report.pretty_print
   end
+
+  desc "heap analyzer"
+  task :heap => [:setup] do
+    require 'objspace'
+
+    file_name = "tmp/#{Time.now.iso8601}-heap.dump"
+    ObjectSpace.trace_object_allocations_start
+    call_app
+    GC.start
+
+    puts "Heap file generated: #{ file_name.inspect }"
+    ObjectSpace.dump_all(output: File.open(file_name, 'w'))
+
+    require 'heap_inspect'
+
+    HeapInspect::Analyzer.new(file_name).analyze
+
+    puts ""
+    puts "Try uploading #{file_name.inspect} to http://tenderlove.github.io/heap-analyzer/"
+  end
 end

data/lib/derailed_benchmarks/version.rb

@@ -1,3 +1,3 @@
 module DerailedBenchmarks
-  VERSION = "1.1.0"
+  VERSION = "1.1.1"
 end

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: derailed_benchmarks
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.1.1
 platform: ruby
 authors:
 - Richard Schneeman
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-09-09 00:00:00.000000000 Z
+date: 2015-10-01 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: heap_inspect
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: memory_profiler
   requirement: !ruby/object:Gem::Requirement