sigdump 0.2.2 → 0.2.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 20e16e2f6471680f7163393c866dce385f1f1d3f
+  data.tar.gz: 61638fe8baf560c431eb59751f072e1c992d0614
+SHA512:
+  metadata.gz: c49d03384c0dd3410e38abb7b08f621689419adee7c365e01ef683ff94cdede5bb6f2fa87b5810da811db4282a57b79c54a71c56adf71b2ad05284fb76ffd0d2
+  data.tar.gz: d1eb8bd6df734dd9c24617ad01c192243c614c2b5cb9ed882eb64cf8363a1817962dee78420a23d6c0f98597891435db5eeee2f4236e1b2a447eb19bd1012f83

data/ChangeLog

@@ -1,4 +1,8 @@
 
+2015-05-21 version 0.2.3:
+
+* Signal handler shows GC.stat (by @sonots / Naotoshi Seo)
+
 2013-04-27 version 0.2.2:
 
 * Fixed SIGDUMP_PATH=- handling (by @yu74n / Yuta Hongo)

data/README.md

@@ -1,26 +1,43 @@
 # sigdump
 
+In short: *SIGQUIT of Java VM for Ruby.*
+
 Server applications (like Rails app) cause performance problems, deadlock or memory swapping from time to time. But it's painful to reproduce such kind of problems. If we can get information from a running process without restarting it, it's really helpful.
 
-`sigdump` gem installs a signal handler which dumps backtrace of running threads and number of allocated objects per class.
+`sigdump` gem installs a signal handler which dumps backtrace of running threads, number of allocated objects per class, and GC statistics.
 
-If GC profiler is enabled (`GC::Profiler.enable` is called), it also dumps GC statistics.
+If GC profiler is enabled (`GC::Profiler.enable` is called), it also dumps GC profiler reports.
 
 ## Install
 
 Just install one gem `sigdump` and require `sigdump/setup`:
 
-    gem 'sigdump', :require => 'sigdump/setup'
+```ruby
+gem 'sigdump', :require => 'sigdump/setup'
+```
+
+### Resque
+
+Because Resque traps `SIGCONT`, you need to change the signal to another signal such as TSTP.
+In environment.rb:
+
+```ruby
+# setup sigdump: https://github.com/frsyuki/sigdump
+ENV['SIGDUMP_SIGNAL'] = 'TSTP'
+require 'sigdump/setup'
+```
 
 ## Usage
 
 Send `SIGCONT` signal to dump backtrace and heap status to `/tmp/sigdump-<pid>.log`:
 
-    $ kill -CONT <pid>
+```shell
+$ kill -CONT <pid>
+```
 
 Set `SIGDUMP_SIGNAL` environment variable to change the signal (default: SIGCONT).
 
-Set `SIGDUMP_PATH` environment variable to change the output path (default: /tmp/sigdump-\<pid\>.log). You can set "-" here to dump to STDOUT, "+" to dump to STDERR.
+Set `SIGDUMP_PATH` environment variable to change the output path (default: /tmp/sigdump-\<pid\>.log). You can set "-" here to dump to STDOUT, or "+" to STDERR.
 
 ## Sample outout
 
@@ -43,6 +60,30 @@ Set `SIGDUMP_PATH` environment variable to change the output path (default: /tmp
           /srv/staging/current/vendor/bundle/ruby/1.9.1/gems/unicorn-4.3.1/bin/unicorn:121:in `<top (required)>'
           /srv/staging/current/vendor/bundle/ruby/1.9.1/bin/unicorn:23:in `load'
           /srv/staging/current/vendor/bundle/ruby/1.9.1/bin/unicorn:23:in `<main>'
+      GC stat:
+          count: 34
+          heap_allocated_pages: 1366
+          heap_sorted_length: 1368
+          heap_allocatable_pages: 0
+          heap_available_slots: 556777
+          heap_live_slots: 551708
+          heap_free_slots: 5069
+          heap_final_slots: 0
+          heap_marked_slots: 363350
+          heap_swept_slots: 58807
+          heap_eden_pages: 1366
+          heap_tomb_pages: 0
+          total_allocated_pages: 1367
+          total_freed_pages: 1
+          total_allocated_objects: 2438499
+          total_freed_objects: 1886791
+          malloc_increase_bytes: 650416
+          malloc_increase_bytes_limit: 16777216
+          minor_gc_count: 25
+          major_gc_count: 9
+          remembered_wb_unprotected_objects: 5122
+          remembered_wb_unprotected_objects_limit: 5222
+          old_objects: 348964
       Built-in objects:
        367,492: TOTAL
        208,193: T_STRING

data/lib/sigdump.rb

@@ -1,5 +1,5 @@
 module Sigdump
-  VERSION = "0.2.2"
+  VERSION = "0.2.3"
 
   def self.setup(signal=ENV['SIGDUMP_SIGNAL'] || 'SIGCONT', path=ENV['SIGDUMP_PATH'])
     Kernel.trap(signal) do
@@ -14,6 +14,7 @@ module Sigdump
     _open_dump_path(path) do |io|
       io.write "Sigdump at #{Time.now} process #{Process.pid} (#{$0})\n"
       dump_all_thread_backtrace(io)
+      dump_gc_stat(io)
       dump_object_count(io)
       dump_gc_profiler_result(io)
     end
@@ -78,6 +79,17 @@ module Sigdump
     nil
   end
 
+  def self.dump_gc_stat(io)
+    io.write "  GC stat:\n"
+
+    GC.stat.each do |key, val|
+      io.write "      #{key}: #{val}\n"
+    end
+
+    io.flush
+    nil
+  end
+
   def self.dump_gc_profiler_result(io)
     return unless defined?(GC::Profiler) && GC::Profiler.enabled?
 

data/sigdump.gemspec

@@ -10,6 +10,7 @@ Gem::Specification.new do |gem|
   gem.version     = Sigdump::VERSION
   gem.authors     = ["Sadayuki Furuhashi"]
   gem.email       = ["frsyuki@gmail.com"]
+  gem.license     = "MIT"
   gem.has_rdoc    = false
   gem.files       = `git ls-files`.split("\n")
   gem.test_files  = `git ls-files -- {test,spec,features}/*`.split("\n")

metadata

@@ -1,30 +1,27 @@
 --- !ruby/object:Gem::Specification
 name: sigdump
 version: !ruby/object:Gem::Version
-  version: 0.2.2
-  prerelease: 
+  version: 0.2.3
 platform: ruby
 authors:
 - Sadayuki Furuhashi
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-04-28 00:00:00.000000000 Z
+date: 2015-05-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.9.2
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.9.2
 description: Setup signal handler which dumps backtrace of running threads and number
@@ -35,7 +32,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
+- ".gitignore"
 - ChangeLog
 - Gemfile
 - LICENSE
@@ -45,29 +42,28 @@ files:
 - lib/sigdump/setup.rb
 - sigdump.gemspec
 homepage: https://github.com/frsyuki/sigdump
-licenses: []
+licenses:
+- MIT
+metadata: {}
 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.23
+rubygems_version: 2.4.5
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Setup signal handler which dumps backtrace of running threads and number
   of allocated objects per class. Require 'sigdump/setup', send SIGCONT, and see /tmp/sigdump-<pid>.log.
 test_files: []
-has_rdoc: false