deployangel 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f2cfd7db0190a370bcb7e464ee8f43edf3674b46035db0c18836826f489bd760
-  data.tar.gz: 061c91c247bd1633fa5ab5b36c04b89f3e5fb74d8217c5cca66401d101c5332d
+  metadata.gz: bd9c6a1966ad36b07d9544c19cfc0b431afd75794ec53f8710792b078e6370ba
+  data.tar.gz: 7048de09969cb804f374efbe9e3117402b9e7d048faceb45ad8390707d1e01ac
 SHA512:
-  metadata.gz: c07d0699f4927f133484e6521894da8abb59e1f26b5271e3d21ca8b820fd39093a66036887c17a65079a326d487247c2fbd95dc7d7fb92d98185487814fb027f
-  data.tar.gz: 47c69848596e777ff7555a6c9ee9f5b12e38c4186fdb70bf48d9c8b25ff143c0c8a6abb2070a8e9b696fea0583697c148d91260f6426e73a79defe725bf2ca50
+  metadata.gz: 0d11c1b1a206d317f433af474f908fabdc0aae002d36b5977577c5691c9756a0717b2377a4e09815b299ea9c9e096402f74742ca7bb204ae2f2be97bd277b581
+  data.tar.gz: 3fa2290369ffdb891d9eb575e4ba90187b3576146a46310e31319352b4ae408b0aae7e1659e5bb45adaf400eea6ca6dab02c032f143d527daf0212a6c5505f17

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.1.2 (2026-10-02)
+
+- Unsent minutes wait in the buffer as gzipped JSON rather than Ruby objects.
+  With every list at its cap, 10 minutes queued while DeployAngel was
+  unreachable took about 20 MB; they now take well under 1 MB.
+- `rake bench` measures the agent's overhead: time and allocations per
+  request, memory with every list at its cap, and the file digest pass.
+
 ## 0.1.1 (2026-10-02)
 
 - Declared Solid Queue schedules carry the time zone Solid Queue reads them

data/README.md

@@ -78,11 +78,18 @@ user data.
   in-memory counters.
 - Payloads are sent from a background thread, once a minute, with short
   timeouts.
-- When DeployAngel is unreachable, the buffer is bounded (10 payloads) and the
-  oldest are dropped. Your app is never blocked or failed.
+- When DeployAngel is unreachable, the buffer is bounded (10 payloads, kept as
+  gzipped JSON) and the oldest are dropped. Your app is never blocked or failed.
 - Safe across forks (Puma cluster mode and similar), and the minute in progress
   is flushed at shutdown.
 
+`bundle exec rake bench` measures this: the time and allocations each request
+adds, memory with every list at its cap, and the one-time file digest pass
+(`APP_ROOT=path/to/app` to digest your own app). On an Apple M-series laptop
+with Ruby 3.4, recording a request adds about 1.6 µs and 6 objects, and with
+every route, job, checkpoint, and exception list at its cap the agent holds
+about 3 MB, including 10 unsent minutes.
+
 ## Configuration
 
 Environment variables are enough for most apps. To override in code:

data/lib/deployangel/agent.rb

@@ -97,13 +97,14 @@ module DeployAngel
       DeployAngel.capabilities
     end
 
-    # Drains completed minutes into the buffer and sends what it can.
+    # Drains completed minutes into the buffer, encoded so unsent minutes stay
+    # small while DeployAngel is unreachable, and sends what it can.
     def flush(include_current: false)
       return 0 unless @active
 
       @aggregator.drain(include_current: include_current, max_periods: config.max_queued_payloads).each do |period|
-        @buffer.push(Protocol.telemetry(period, instance: @instance, release: @release, runtime: @runtime,
-          capabilities: capabilities))
+        @buffer.push(Transport.encode(Protocol.telemetry(period, instance: @instance, release: @release,
+          runtime: @runtime, capabilities: capabilities)))
       end
       send_buffered
     rescue StandardError => e

data/lib/deployangel/core/transport.rb

@@ -16,10 +16,28 @@ module DeployAngel
       end
     end
 
+    # A payload already encoded as gzipped JSON. Queued telemetry is kept
+    # this way: a full minute is megabytes as Ruby objects but kilobytes
+    # compressed.
+    Encoded = Struct.new(:bytes)
+
+    def self.encode(body)
+      Encoded.new(gzip(JSON.generate(body)))
+    end
+
+    def self.gzip(string)
+      io = StringIO.new
+      writer = Zlib::GzipWriter.new(io)
+      writer.write(string)
+      writer.close
+      io.string
+    end
+
     def initialize(config)
       @config = config
     end
 
+    # body is a Hash, or an Encoded payload sent as is.
     # :ok (2xx), :retry (network error or 5xx), or :drop (any other status,
     # including 429 rate limiting, which the agent honors by pausing).
     def post(path, body)
@@ -29,7 +47,7 @@ module DeployAngel
       request["Content-Type"] = "application/json"
       request["Content-Encoding"] = "gzip"
       request["User-Agent"] = "deployangel-ruby/#{DeployAngel::VERSION} ruby/#{RUBY_VERSION}"
-      request.body = gzip(JSON.generate(body))
+      request.body = (body.is_a?(Encoded) ? body : self.class.encode(body)).bytes
 
       response = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https",
         open_timeout: @config.open_timeout, read_timeout: @config.read_timeout,
@@ -54,13 +72,5 @@ module DeployAngel
       rescue JSON::ParserError
         {}
       end
-
-      def gzip(string)
-        io = StringIO.new
-        writer = Zlib::GzipWriter.new(io)
-        writer.write(string)
-        writer.close
-        io.string
-      end
   end
 end

data/lib/deployangel/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DeployAngel
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: deployangel
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Jordan Owens