memory-profiler 1.1.15 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cce184966c5eb2b104059f419fb7f220b2bea168b5359adacc90923079332241
-  data.tar.gz: 436690f9e75f5ba72546604fd58d71efccb56d4dc8b8880feaa3b4ecab03c918
+  metadata.gz: 44131407c83cd30a000572173db2bd27a1b2cc226090fe5b2ab5b9452671676a
+  data.tar.gz: 76c488be0ca9902ac543a21941b3ebd4d5fd5ea807e958289452044021ba8f0c
 SHA512:
-  metadata.gz: 54d4d1e2f8d19da788e53ffa0c5e69dcaf5db708d5d1de0336bccc79c6311330a56b0c8cb605b7bb7dbc116b91b91a752cacf317d4403e5188517ddcdded12a2
-  data.tar.gz: 4994f81f0b6dd2b0c46bc3aa3e415dbc16ffb633d9fefdeafd67d10df522aaccc5003dd632a664b8eb69e476053bac5f51d0979c69c4daa97965356b1bb2ca9c
+  metadata.gz: 98eba2b7e667ad5d9e9ea01a528de98a4525074580e66178b91f246932183557d0a826a8693e773147977e694f7ef9a15af47d0d8f954c4352bb77ada9d5e558
+  data.tar.gz: 71424607c4a188ef16da5436c4bd7b0ebc6640b3bbc1b182f0a9cc64c15b940bb4cf81a3f1cc47f00cfb5b7dc596565a3f22df88cd6c9ccb80b7866122c6bb53

data/lib/memory/profiler/sampler.rb

@@ -93,12 +93,15 @@ module Memory
 			# @parameter increases_threshold [Integer] Number of increases before enabling detailed tracking.
 			# @parameter prune_limit [Integer] Keep only top N children per node during pruning (default: 5).
 			# @parameter prune_threshold [Integer] Number of insertions before auto-pruning (nil = no auto-pruning).
-			def initialize(depth: 4, filter: nil, increases_threshold: 10, prune_limit: 5, prune_threshold: nil)
+			# @parameter gc [Hash | Nil] Run GC with these options before each sample (nil = don't run GC).
+			def initialize(depth: 4, filter: nil, increases_threshold: 10, prune_limit: 5, prune_threshold: nil, gc: nil)
 				@depth = depth
 				@filter = filter || default_filter
 				@increases_threshold = increases_threshold
 				@prune_limit = prune_limit
 				@prune_threshold = prune_threshold
+				@gc = gc
+				
 				@capture = Capture.new
 				@call_trees = {}
 				@samples = {}
@@ -150,6 +153,9 @@ module Memory
 				while true
 					start_time = Process.clock_gettime(Process::CLOCK_MONOTONIC)
 					
+					# Optional garbage collection before sampling can help reduce noise:
+					GC.start(**@gc) if @gc
+					
 					sample!(&block)
 					
 					# Log capture statistics to detect issues like missing FREEOBJ events:
@@ -169,15 +175,22 @@ module Memory
 				@capture.each do |klass, allocations|
 					count = allocations.retained_count
 					sample = @samples[klass] ||= Sample.new(klass, count)
+					increased = false
 					
 					if sample.sample!(count)
+						increased = true
+						
 						# Check if we should enable detailed tracking
-						if sample.increases >= @increases_threshold && !@call_trees.key?(klass)
-							track(klass, allocations)
+						if sample.increases >= @increases_threshold
+							# Start tracking with call path analysis if not already doing so:
+							unless tracking?(klass)
+								track(klass, allocations)
+							end
 						end
-						
-						# Notify about growth if block given
-						yield sample if block_given?
+					end
+					
+					if block_given?
+						yield sample, increased
 					end
 				end
 				
@@ -188,14 +201,12 @@ module Memory
 			# Start tracking with call path analysis.
 			#
 			# @parameter klass [Class] The class to track with detailed analysis.
-			def track(klass, allocations = nil)
+			def track(klass, allocations = nil, filter: @filter, depth: @depth)
 				# Track the class and get the allocations object
 				allocations ||= @capture.track(klass)
 				
 				# Set up call tree for this class
 				tree = @call_trees[klass] = CallTree.new
-				depth = @depth
-				filter = @filter
 				
 				# Register callback on allocations object:
 				# - On :newobj - returns state (leaf node) which C extension stores
@@ -293,8 +304,9 @@ module Memory
 			
 		private
 			
+			# Default filter to include all locations.
 			def default_filter
-				->(location) {!location.path.match?(%r{/(gems|ruby)/|\A\(eval\)})}
+				->(location) {true}
 			end
 			
 			def prune_call_trees!

data/lib/memory/profiler/version.rb

@@ -7,7 +7,7 @@
 module Memory
 	# @namespace
 	module Profiler
-		VERSION = "1.1.15"
+		VERSION = "1.2.0"
 	end
 end
 

data/readme.md

@@ -22,6 +22,13 @@ Please see the [project documentation](https://socketry.github.io/memory-profile
 
 Please see the [project releases](https://socketry.github.io/memory-profiler/releases/index) for all releases.
 
+### v1.2.0
+
+  - Enable custom `depth:` and `filter:` options to `Sampler#track`.
+  - Change default filter to no-op.
+  - Add option to run GC with custom options before each sample to reduce noise.
+  - Always report sampler statistics after each sample.
+
 ### v1.1.15
 
   - Ignore `freeobj` for classes that are not being tracked.
@@ -64,12 +71,6 @@ Please see the [project releases](https://socketry.github.io/memory-profiler/rel
 
   - Expose `Capture#statistics` for debugging internal memory tracking state.
 
-### v1.1.6
-
-  - Write barriers all the things.
-  - Better state handling and object increment/decrement counting.
-  - Better call tree handling - including support for `prune!`.
-
 ## Contributing
 
 We welcome contributions to this project.

data/releases.md

@@ -1,5 +1,12 @@
 # Releases
 
+## v1.2.0
+
+  - Enable custom `depth:` and `filter:` options to `Sampler#track`.
+  - Change default filter to no-op.
+  - Add option to run GC with custom options before each sample to reduce noise.
+  - Always report sampler statistics after each sample.
+
 ## v1.1.15
 
   - Ignore `freeobj` for classes that are not being tracked.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: memory-profiler
 version: !ruby/object:Gem::Version
-  version: 1.1.15
+  version: 1.2.0
 platform: ruby
 authors:
 - Samuel Williams