Introduce UtilizationMonitor.

Author: samuel-williams-shopify

context/utilization-monitor.md

@@ -31,7 +31,7 @@ service "supervisor" do
 		[
 			Async::Service::Supervisor::UtilizationMonitor.new(
 				path: File.expand_path("utilization.shm", root),
-				interval: 10  # Aggregate and emit metrics every 10 seconds
+				interval: 10 # Aggregate and emit metrics every 10 seconds
 			)
 		]
 	end
@@ -116,14 +116,6 @@ monitors do
 end
 ```
 
-For a custom location under your application root:
-
-```ruby
-path: File.expand_path("tmp/utilization.shm", root)
-```
-
-Ensure the path is writable by both supervisor and workers.
-
 ### `interval`
 
 The interval (in seconds) at which to aggregate and emit utilization metrics. Default: `10` seconds.

guides/utilization-monitor/readme.md

@@ -31,7 +31,7 @@ service "supervisor" do
 		[
 			Async::Service::Supervisor::UtilizationMonitor.new(
 				path: File.expand_path("utilization.shm", root),
-				interval: 10  # Aggregate and emit metrics every 10 seconds
+				interval: 10 # Aggregate and emit metrics every 10 seconds
 			)
 		]
 	end
@@ -116,14 +116,6 @@ monitors do
 end
 ```
 
-For a custom location under your application root:
-
-```ruby
-path: File.expand_path("tmp/utilization.shm", root)
-```
-
-Ensure the path is writable by both supervisor and workers.
-
 ### `interval`
 
 The interval (in seconds) at which to aggregate and emit utilization metrics. Default: `10` seconds.

readme.md

@@ -30,6 +30,10 @@ Please see the [project documentation](https://socketry.github.io/async-service-
 
 Please see the [project releases](https://socketry.github.io/async-service-supervisor/releases/index) for all releases.
 
+### Unreleased
+
+  - Introduce `UtilizationMonitor`, that uses shared memory to track worker utilization metrics, like total and active requests, connections, etc.
+
 ### v0.11.0
 
   - Add `state` attribute to `SupervisorController` to store per-worker metadata (e.g., service name).
@@ -75,10 +79,6 @@ Please see the [project releases](https://socketry.github.io/async-service-super
 
   - Fix timed out RPCs and subsequent responses which should be ignored.
 
-### v0.6.0
-
-  - Add `async:container:supervisor:reload` command to restart the container (blue/green deployment).
-
 ## Contributing
 
 We welcome contributions to this project.

releases.md

@@ -1,5 +1,9 @@
 # Releases
 
+## Unreleased
+
+- Introduce `UtilizationMonitor`, that uses shared memory to track worker utilization metrics, like total and active requests, connections, etc.
+
 ## v0.11.0
 
   - Add `state` attribute to `SupervisorController` to store per-worker metadata (e.g., service name).