process-metrics 0.5.1 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e289675208cb093fe76b4a7041534a8bb835be238a6fadae2aafb0c030c62c69
-  data.tar.gz: 499bb3b23d66671225a321ac7fd3e3a32bfdbf2a39bd44f976ff9cfbc89f953e
+  metadata.gz: ca29ce7e69894dd4f9f766caa5ee6055c1a25c06d1b764960ffe72c15dfb1958
+  data.tar.gz: 4723276718e25bc09053ba004357f33a720d3da342b384277f07b5a3eebe898e
 SHA512:
-  metadata.gz: caa4d0e83a16610d6160d1ed845ad9ad2ecc79fc19f7b89cdc7d1d8e26a634febec374c149ce5608239035985b55d1eb417c153e6dcf73c733642fdb552336e9
-  data.tar.gz: e3cb7f4fcb5ce25d6146f272d8ab4148542c56d2559b06dabe9ed1f630cb8580b79d08f8b50a39e5c19fa4ea59f9df62e2af9e93d7fae6995ae4e77eea64699a
+  metadata.gz: b6548743e1120c91c17cf5aa6255bb14991c68ac7b28861325ea3376061e7a3da18f4d1bfc7762f83eb48e46f2e1ce792e1550e3fc16cae13254f5c8189e9650
+  data.tar.gz: 53cbcbabaef2f8d414e877eeb5b3d1dbc286f87cbb01ce4a6afee588527440e94c9ea144af4e13d5bb7f085971b2da91f373684bbc8076980cafe02c6aa8f7f6

data/context/getting-started.md

@@ -0,0 +1,90 @@
+# Getting Started
+
+This guide explains how to use the `process-metrics` gem to collect and analyze process metrics including processor and memory utilization.
+
+## Installation
+
+Add the gem to your project:
+
+``` bash
+$ bundle add process-metrics
+```
+
+Or, if you prefer, install it globally:
+
+``` bash
+$ gem install process-metrics
+```
+
+## Core Concepts
+
+The `process-metrics` gem provides a simple interface to collect and analyze process metrics.
+
+- {ruby Process::Metrics::General} is the main entry point for process metrics. Use {ruby Process::Metrics::General.capture} to collect metrics for one or more processes.
+- {ruby Process::Metrics::Memory} provides additional methods for collecting memory metrics when the host operating system provides the necessary information.
+
+## Usage
+
+To collect process metrics, use the {ruby Process::Metrics::General.capture} method:
+
+``` ruby
+Process::Metrics::General.capture(pid: Process.pid)
+# => 
+# {3517456=>
+#   #<struct Process::Metrics::General
+#    pid=3517456,
+#    ppid=3517432,
+#    pgid=3517456,
+#    processor_utilization=0.0,
+#    vsz=0,
+#    rss=486892,
+#    time=29928,
+#    etime=2593,
+#    command="irb",
+#    memory=
+#     #<struct Process::Metrics::Memory
+#      map_count=193,
+#      total_size=486896,
+#      resident_size=30556,
+#      proportional_size=25672,
+#      shared_clean_size=5008,
+#      shared_dirty_size=0,
+#      private_clean_size=5180,
+#      private_dirty_size=20368,
+#      referenced_size=30548,
+#      anonymous_size=20376,
+#      swap_size=0,
+#      proportional_swap_size=0>>}
+```
+
+If you want to capture a tree of processes, you can specify the `ppid:` option instead.
+
+### Fields
+
+The {ruby Process::Metrics::General} struct contains the following fields:
+
+- `process_id` - Process ID, a unique identifier for the process.
+- `parent_process_id` - Parent Process ID, the process ID of the process that started this process.
+- `process_group_id` - Process Group ID, the process group ID of the process, which can be shared by multiple processes.
+- `processor_utilization` - Processor Utilization (%), the percentage of CPU time used by the process (over a system-specific duration).
+- `total_size` - Memory Size (KB), the total size of the process's memory space (usually over-estimated as it doesn't take into account shared memory).
+- `resident_size` - Resident (Set) Size (KB), the amount of physical memory used by the process.
+- `processor_time` - CPU Time (s), the amount of CPU time used by the process.
+- `elapsed_time` - Elapsed Time (s), the amount of time the process has been running.
+- `command` - Command Name, the name of the command that started the process.
+
+The {ruby Process::Metrics::Memory} struct contains the following fields:
+
+- `map_count` - Number of Memory Mappings, e.g. number of thread stacks, fiber stacks, shared libraries, memory mapped files, etc.
+- `resident_size` - Resident Memory Size (KB), the amount of physical memory used by the process.
+- `proportional_size` - Proportional Memory Size (KB), the amount of memory that the process is using, taking into account shared memory.
+- `shared_clean_size` - Shared Clean Memory Size (KB), the amount of shared memory that is clean (not modified).
+- `shared_dirty_size` - Shared Dirty Memory Size (KB), the amount of shared memory that is dirty (modified).
+- `private_clean_size` - Private Clean Memory Size (KB), the amount of private memory that is clean (not modified).
+- `private_dirty_size` - Private Dirty Memory Size (KB), the amount of private memory that is dirty (modified).
+- `referenced_size` - Referenced Memory Size (KB), active page-cache that isn't going to be reclaimed any time soon.
+- `anonymous_size` - Anonymous Memory Size (KB), mapped memory that isn't backed by a file.
+- `swap_size` - Swap Memory Size (KB), the amount of memory that has been swapped to disk.
+- `proportional_swap_size` - Proportional Swap Memory Size (KB), the amount of memory that has been swapped to disk, excluding shared memory.
+
+In general, the interpretation of these fields is operating system specific. At best, they provide a rough estimate of the process's memory usage, but you should consult the documentation for your operating system for more details on exactly what each field represents.

data/context/index.yaml

@@ -0,0 +1,13 @@
+# Automatically generated context index for Utopia::Project guides.
+# Do not edit then files in this directory directly, instead edit the guides and then run `bake utopia:project:agent:context:update`.
+---
+description: Provide detailed OS-specific process metrics.
+metadata:
+  documentation_uri: https://socketry.github.io/process-metrics/
+  funding_uri: https://github.com/sponsors/ioquatix
+  source_code_uri: https://github.com/socketry/process-metrics.git
+files:
+- path: getting-started.md
+  title: Getting Started
+  description: This guide explains how to use the `process-metrics` gem to collect
+    and analyze process metrics including processor and memory utilization.

data/lib/process/metrics/command/summary.rb

@@ -12,6 +12,7 @@ require "console/terminal"
 module Process
 	module Metrics
 		module Command
+			# Helper module for rendering horizontal progress bars using Unicode block characters.
 			module Bar
 				BLOCK = [
 					" ",
@@ -25,6 +26,10 @@ module Process
 					"█",
 				]
 				
+				# Format a fractional value as a horizontal bar.
+				# @parameter value [Float] A value between 0.0 and 1.0 representing the fill level.
+				# @parameter width [Integer] The width of the bar in characters.
+				# @returns [String] A string of Unicode block characters representing the filled bar.
 				def self.format(value, width)
 					blocks = width * value
 					full_blocks = blocks.floor
@@ -38,16 +43,19 @@ module Process
 				end
 			end
 			
+			# Command that displays a formatted summary of memory usage statistics for processes.
 			class Summary < Samovar::Command
 				self.description = "Display a summary of memory usage statistics."
 				
 				options do
-					option "--pid <integer>", "Report on a single process id.", type: Integer, required: true
-					option "-p/--ppid <integer>", "Report on all children of this process id.", type: Integer, required: true
+					option "--pid <integer>", "Report on a single process id.", type: Integer
+					option "-p/--ppid <integer>", "Report on all children of this process id.", type: Integer
 					
 					option "--total-memory <integer>", "Set the total memory relative to the usage (MiB).", type: Integer
 				end
 				
+				# Get the configured terminal for styled output.
+				# @returns [Console::Terminal] A terminal object with color/style definitions.
 				def terminal
 					terminal = Console::Terminal.for($stdout)
 					
@@ -62,6 +70,9 @@ module Process
 					return terminal
 				end
 				
+				# Format a processor utilization percentage with color-coded bar.
+				# @parameter value [Float] The CPU utilization percentage (0.0-100.0).
+				# @parameter terminal [Console::Terminal] The terminal to output styled text.
 				def format_processor_utilization(value, terminal)
 					if value > 80.0
 						intensity = :high
@@ -78,6 +89,10 @@ module Process
 				
 				UNITS = ["KiB", "MiB", "GiB"]
 				
+				# Format a memory size value in human-readable units.
+				# @parameter value [Numeric] The size value in kilobytes.
+				# @parameter units [Array(String)] The unit labels to use for scaling.
+				# @returns [String] A formatted string with value and unit (e.g., "512KiB", "1.5MiB").
 				def format_size(value, units: UNITS)
 					unit = 0
 					
@@ -89,6 +104,10 @@ module Process
 					return "#{value.round(unit)}#{units[unit]}"
 				end
 				
+				# Format a memory value with a horizontal bar showing utilization relative to total.
+				# @parameter value [Numeric] The memory value in kilobytes.
+				# @parameter total [Numeric] The total memory available in kilobytes.
+				# @parameter terminal [Console::Terminal] The terminal to output styled text.
 				def format_memory(value, total, terminal)
 					if value > (total * 0.8)
 						intensity = :high
@@ -103,6 +122,8 @@ module Process
 					terminal.print(formatted, intensity, "[", Bar.format(value / total.to_f, 60), "]", :reset)
 				end
 				
+				# Get the total memory to use for percentage calculations.
+				# @returns [Integer] Total memory in kilobytes.
 				def total_memory
 					if total_memory = @options[:total_memory]
 						return total_memory * 1024
@@ -111,7 +132,13 @@ module Process
 					end
 				end
 				
+				# Execute the summary command, capturing and displaying process metrics.
 				def call
+					# Validate required arguments: at least one of --pid or --ppid must be provided:
+					unless @options[:pid] || @options[:ppid]
+						raise Samovar::MissingValueError.new(self, "pid or ppid")
+					end
+					
 					terminal = self.terminal
 					
 					summary = Process::Metrics::General.capture(pid: @options[:pid], ppid: @options[:ppid])

data/lib/process/metrics/command/top.rb

@@ -11,6 +11,7 @@ require_relative "../version"
 module Process
 	module Metrics
 		module Command
+			# Top-level command entry point for the process-metrics CLI.
 			class Top < Samovar::Command
 				self.description = "Collect memory usage statistics."
 				
@@ -23,6 +24,7 @@ module Process
 					"summary" => Summary,
 				}, default: "summary"
 				
+				# Execute the top command, dispatching to nested commands.
 				def call
 					if @options[:version]
 						puts "#{self.name} v#{VERSION}"

data/lib/process/metrics/command.rb

@@ -7,7 +7,10 @@ require_relative "command/top"
 
 module Process
 	module Metrics
+		# @namespace
 		module Command
+			# Call the default command (Top).
+			# @parameter arguments [Array] Command-line arguments to pass through.
 			def self.call(*arguments)
 				Top.call(*arguments)
 			end

data/lib/process/metrics/general.rb

@@ -84,12 +84,20 @@ module Process
 			
 			alias memory_usage total_size
 			
+			# Recursively expand a set of child PIDs into a collection.
+			# @parameter children [Array<Integer>] The list of child process IDs to expand.
+			# @parameter hierarchy [Hash<Integer, Array<Integer>>] The parent-to-children process hierarchy.
+			# @parameter pids [Set<Integer>] The set to populate with process IDs.
 			def self.expand_children(children, hierarchy, pids)
 				children.each do |pid|
 					self.expand(pid, hierarchy, pids)
 				end
 			end
 			
+			# Recursively expand a process and its descendants into a collection.
+			# @parameter pid [Integer] The process ID to expand.
+			# @parameter hierarchy [Hash<Integer, Array<Integer>>] The parent-to-children process hierarchy.
+			# @parameter pids [Set<Integer>] The set to populate with process IDs.
 			def self.expand(pid, hierarchy, pids)
 				unless pids.include?(pid)
 					pids << pid
@@ -100,6 +108,9 @@ module Process
 				end
 			end
 			
+			# Build a parent-to-children process hierarchy from a set of processes.
+			# @parameter processes [Hash<Integer, General>] A hash mapping PIDs to General instances.
+			# @returns [Hash<Integer, Array<Integer>>] A hash mapping each parent PID to an array of child PIDs.
 			def self.build_tree(processes)
 				hierarchy = Hash.new{|h,k| h[k] = []}
 				
@@ -112,6 +123,8 @@ module Process
 				return hierarchy
 			end
 			
+			# Capture detailed memory metrics for each process in the given collection.
+			# @parameter processes [Hash<Integer, General>] A hash mapping PIDs to General instances.
 			def self.capture_memory(processes)
 				count = processes.size
 				

data/lib/process/metrics/memory/darwin.rb

@@ -5,6 +5,7 @@
 
 module Process
 	module Metrics
+		# Darwin (macOS) implementation of memory metrics using vmmap.
 		class Memory::Darwin
 			VMMAP = "/usr/bin/vmmap"
 			
@@ -25,7 +26,9 @@ module Process
 				end
 			end
 			
-			# Parse a size string into kilobytes.
+			# Parse a size string from vmmap output into kilobytes.
+			# @parameter string [String | Nil] The size string (e.g., "4K", "1.5M", "2G").
+			# @returns [Integer] The size in kilobytes.
 			def self.parse_size(string)
 				return 0 unless string
 				
@@ -93,14 +96,22 @@ module Process
 		
 		if Memory::Darwin.supported?
 			class << Memory
+				# Whether memory capture is supported on this platform.
+				# @returns [Boolean] True if vmmap is available.
 				def supported?
 					return true
 				end
 				
+				# Get total system memory size.
+				# @returns [Integer] Total memory in kilobytes.
 				def total_size
 					return Memory::Darwin.total_size
 				end
 				
+				# Capture memory metrics for a process.
+				# @parameter pid [Integer] The process ID.
+				# @parameter options [Hash] Additional options (e.g., count for proportional estimates).
+				# @returns [Memory] A Memory instance with captured metrics.
 				def capture(...)
 					return Memory::Darwin.capture(...)
 				end

data/lib/process/metrics/memory/linux.rb

@@ -5,7 +5,28 @@
 
 module Process
 	module Metrics
+		# Linux implementation of memory metrics using `/proc/[pid]/smaps` and `/proc/[pid]/stat`.
 		class Memory::Linux
+			# Extract minor/major page fault counters from `/proc/[pid]/stat` and assign to usage.
+			# @parameter pid [Integer] The process ID.
+			# @parameter usage [Memory] The Memory instance to populate with fault counters.
+			def self.capture_faults(pid, usage)
+				begin
+					stat = File.read("/proc/#{pid}/stat")
+					# The comm field can contain spaces and parentheses; find the closing ')':
+					rparen_index = stat.rindex(")")
+					return unless rparen_index
+					fields = stat[(rparen_index+2)..-1].split(/\s+/)
+					# proc(5): field 10=minflt, 12=majflt; our fields array is 0-indexed from field 3.
+					usage.minor_faults = fields[10-3].to_i
+					usage.major_faults = fields[12-3].to_i
+				rescue Errno::ENOENT, Errno::EACCES
+					# The process may have exited or permissions are insufficient; ignore.
+				rescue => error
+					# Be robust to unexpected formats; ignore errors silently.
+				end
+			end
+			
 			# @returns [Numeric] Total memory size in kilobytes.
 			def self.total_size
 				File.read("/proc/meminfo").each_line do |line|
@@ -34,7 +55,7 @@ module Process
 				def self.supported?
 					true
 				end
-			
+				
 				# Capture memory usage for the given process IDs.
 				def self.capture(pid, **options)
 					usage = Memory.zero
@@ -49,6 +70,8 @@ module Process
 						end
 						
 						usage.map_count += File.readlines("/proc/#{pid}/maps").size
+						# Also capture fault counters:
+						self.capture_faults(pid, usage)
 					rescue Errno::ENOENT => error
 						# Ignore.
 					end
@@ -79,6 +102,8 @@ module Process
 								usage.map_count += 1
 							end
 						end
+						# Also capture fault counters:
+						self.capture_faults(pid, usage)
 					rescue Errno::ENOENT => error
 						# Ignore.
 					end
@@ -94,14 +119,22 @@ module Process
 		
 		if Memory::Linux.supported?
 			class << Memory
+				# Whether memory capture is supported on this platform.
+				# @returns [Boolean] True if /proc/[pid]/smaps or smaps_rollup is readable.
 				def supported?
 					return true
 				end
 				
+				# Get total system memory size.
+				# @returns [Integer] Total memory in kilobytes.
 				def total_size
 					return Memory::Linux.total_size
 				end
 				
+				# Capture memory metrics for a process.
+				# @parameter pid [Integer] The process ID.
+				# @parameter options [Hash] Additional options.
+				# @returns [Memory] A Memory instance with captured metrics.
 				def capture(...)
 					return Memory::Linux.capture(...)
 				end

data/lib/process/metrics/memory.rb

@@ -8,7 +8,7 @@ require "json"
 module Process
 	module Metrics
 		# Represents memory usage for a process, sizes are in kilobytes.
-		class Memory < Struct.new(:map_count, :resident_size, :proportional_size, :shared_clean_size, :shared_dirty_size, :private_clean_size, :private_dirty_size, :referenced_size, :anonymous_size, :swap_size, :proportional_swap_size)
+		class Memory < Struct.new(:map_count, :resident_size, :proportional_size, :shared_clean_size, :shared_dirty_size, :private_clean_size, :private_dirty_size, :referenced_size, :anonymous_size, :swap_size, :proportional_swap_size, :minor_faults, :major_faults)
 			
 			alias as_json to_h
 			
@@ -27,8 +27,10 @@ module Process
 				self.private_clean_size + self.private_dirty_size
 			end
 			
+			# Create a zero-initialized Memory instance.
+			# @returns [Memory] A new Memory object with all fields set to zero.
 			def self.zero
-				self.new(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0)
+				self.new(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0)
 			end
 			
 			# Whether the memory usage can be captured on this system.

data/lib/process/metrics/version.rb

@@ -1,10 +1,12 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2024, by Samuel Williams.
+# Copyright, 2019-2025, by Samuel Williams.
 
+# @namespace
 module Process
+	# @namespace
 	module Metrics
-		VERSION = "0.5.1"
+		VERSION = "0.6.0"
 	end
 end

data/readme.md

@@ -12,6 +12,67 @@ Please see the [project documentation](https://socketry.github.io/process-metric
 
   - [Getting Started](https://socketry.github.io/process-metrics/guides/getting-started/index) - This guide explains how to use the `process-metrics` gem to collect and analyze process metrics including processor and memory utilization.
 
+## Releases
+
+Please see the [project releases](https://socketry.github.io/process-metrics/releases/index) for all releases.
+
+### v0.6.0
+
+  - Add support for major and minor page faults on Linux: `Process::Metrics::Memory#major_faults` and `#minor_faults`. Unfortunately these metrics are not available on Darwin (macOS).
+
+### v0.5.1
+
+  - Fixed Linux memory usage capture to correctly read memory statistics.
+
+### v0.5.0
+
+  - Added `--total-memory` option for scaling memory usage graphs, allowing users to set custom total memory values.
+  - Improved support for proportional memory usage (PSS).
+  - Exposed total system memory information.
+
+### v0.4.0
+
+  - Fixed command formatting in output display.
+  - Modernized codebase to use current Ruby conventions.
+  - Improved Darwin (macOS) support with better platform-specific handling.
+
+### v0.3.0
+
+  - Added support for `smaps_rollup` on Linux for more efficient memory statistics collection.
+  - Fixed `smaps_rollup` detection (corrected file path).
+  - Removed `sz` metric (not supported on Darwin).
+  - Expanded test coverage.
+  - Improved documentation with better syntax highlighting and fixed links.
+  - Avoided abbreviations in naming conventions for better code clarity.
+  - Added missing dependencies: `bake-test-external` and `json` gem.
+  - Added summary lines for PSS (Proportional Set Size) and USS (Unique Set Size).
+
+### v0.2.1
+
+  - Added missing dependency to gemspec.
+  - Added example of command line usage to documentation.
+  - Renamed `rsz` to `rss` (Resident Set Size) for consistency across Darwin and Linux platforms.
+
+### v0.2.0
+
+  - Added `process-metrics` command line interface for monitoring processes.
+  - Implemented structured data using Ruby structs for better performance and clarity.
+  - Added documentation about PSS (Proportional Set Size) and USS (Unique Set Size) metrics.
+
+### v0.1.1
+
+  - Removed `Gemfile.lock` from version control.
+  - Fixed process metrics to exclude the `ps` command itself from measurements.
+  - Fixed documentation formatting issues.
+
+### v0.1.0
+
+  - Initial release with support for process and memory metrics on Linux and Darwin (macOS).
+  - Support for selecting processes based on PID or PPID (process group).
+  - Implementation of memory statistics collection using `/proc` filesystem on Linux.
+  - Better handling of process hierarchies.
+  - Support for older Ruby versions.
+
 ## Contributing
 
 We welcome contributions to this project.

data/releases.md

@@ -0,0 +1,58 @@
+# Releases
+
+## v0.6.0
+
+  - Add support for major and minor page faults on Linux: `Process::Metrics::Memory#major_faults` and `#minor_faults`. Unfortunately these metrics are not available on Darwin (macOS).
+
+## v0.5.1
+
+  - Fixed Linux memory usage capture to correctly read memory statistics.
+
+## v0.5.0
+
+  - Added `--total-memory` option for scaling memory usage graphs, allowing users to set custom total memory values.
+  - Improved support for proportional memory usage (PSS).
+  - Exposed total system memory information.
+
+## v0.4.0
+
+  - Fixed command formatting in output display.
+  - Modernized codebase to use current Ruby conventions.
+  - Improved Darwin (macOS) support with better platform-specific handling.
+
+## v0.3.0
+
+  - Added support for `smaps_rollup` on Linux for more efficient memory statistics collection.
+  - Fixed `smaps_rollup` detection (corrected file path).
+  - Removed `sz` metric (not supported on Darwin).
+  - Expanded test coverage.
+  - Improved documentation with better syntax highlighting and fixed links.
+  - Avoided abbreviations in naming conventions for better code clarity.
+  - Added missing dependencies: `bake-test-external` and `json` gem.
+  - Added summary lines for PSS (Proportional Set Size) and USS (Unique Set Size).
+
+## v0.2.1
+
+  - Added missing dependency to gemspec.
+  - Added example of command line usage to documentation.
+  - Renamed `rsz` to `rss` (Resident Set Size) for consistency across Darwin and Linux platforms.
+
+## v0.2.0
+
+  - Added `process-metrics` command line interface for monitoring processes.
+  - Implemented structured data using Ruby structs for better performance and clarity.
+  - Added documentation about PSS (Proportional Set Size) and USS (Unique Set Size) metrics.
+
+## v0.1.1
+
+  - Removed `Gemfile.lock` from version control.
+  - Fixed process metrics to exclude the `ps` command itself from measurements.
+  - Fixed documentation formatting issues.
+
+## v0.1.0
+
+  - Initial release with support for process and memory metrics on Linux and Darwin (macOS).
+  - Support for selecting processes based on PID or PPID (process group).
+  - Implementation of memory statistics collection using `/proc` filesystem on Linux.
+  - Better handling of process hierarchies.
+  - Support for older Ruby versions.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: process-metrics
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 0.6.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -37,7 +37,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2025-02-21 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: console
@@ -87,6 +87,8 @@ extensions: []
 extra_rdoc_files: []
 files:
 - bin/process-metrics
+- context/getting-started.md
+- context/index.yaml
 - lib/process/metrics.rb
 - lib/process/metrics/command.rb
 - lib/process/metrics/command/summary.rb
@@ -98,6 +100,7 @@ files:
 - lib/process/metrics/version.rb
 - license.md
 - readme.md
+- releases.md
 homepage: https://github.com/socketry/process-metrics
 licenses:
 - MIT
@@ -112,14 +115,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.1'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.7.2
 specification_version: 4
 summary: Provide detailed OS-specific process metrics.
 test_files: []