deployangel 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f2cfd7db0190a370bcb7e464ee8f43edf3674b46035db0c18836826f489bd760
-  data.tar.gz: 061c91c247bd1633fa5ab5b36c04b89f3e5fb74d8217c5cca66401d101c5332d
+  metadata.gz: 5169af9bd2d83ec8ec1446d4ddf641a8908428bc8d50be14fc124a76cfdca936
+  data.tar.gz: 466bff7d697f32e27362394130e2e1e0fc0f4e7c62a098740b3c38598443b0fe
 SHA512:
-  metadata.gz: c07d0699f4927f133484e6521894da8abb59e1f26b5271e3d21ca8b820fd39093a66036887c17a65079a326d487247c2fbd95dc7d7fb92d98185487814fb027f
-  data.tar.gz: 47c69848596e777ff7555a6c9ee9f5b12e38c4186fdb70bf48d9c8b25ff143c0c8a6abb2070a8e9b696fea0583697c148d91260f6426e73a79defe725bf2ca50
+  metadata.gz: 5be25747e622d3556d6f2b6d04351f1d3402f910045ad36e15b1e181b393955acee510906c37abafde57f7cfdde4b41d4742bcf6bcf6e90c549914a033f1205d
+  data.tar.gz: ed4075d93e23c0a96b813bb385384de53cd05ca878e3e77140af6cae1eeb827e52c5fef5bb8fcfd40e162cac62ead212ea74a019c93bae629ad55fc1dbbd0365

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 0.1.3 (2026-10-02)
+
+- Each process sends its minute of telemetry 1 to 50 seconds after the
+  minute ends, chosen once per process, instead of within the first 10
+  seconds. Apps' batches reach DeployAngel spread across the minute rather
+  than all at once.
+
+## 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

@@ -9,6 +9,12 @@ module DeployAngel
     METADATA_PATH = "/api/v1/application_metadata"
     SHUTDOWN_TIMEOUT = 2
     DEFAULT_PAUSE = 60
+    # Seconds past each minute a process waits before sending, chosen once
+    # per process so the cloud gets a steady stream instead of a burst at
+    # the top of the minute. The cloud reads a minute 2 minutes after it
+    # ends, so a send that times out (5 seconds) and goes again a minute
+    # later still lands in time.
+    FLUSH_JITTER = 1.0..50.0
 
     attr_reader :config, :release, :instance
     attr_writer :metadata
@@ -97,13 +103,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
@@ -172,8 +179,7 @@ module DeployAngel
         @paused_until = nil
         @metadata_sent = false
         @thread = nil
-        # Spread processes across the first seconds of each minute.
-        @jitter = rand(1.0..10.0)
+        @jitter = rand(FLUSH_JITTER)
       end
 
       def run_reporter

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.3"
 end

metadata

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