deployangel 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b1740b8bdbebb7cf89db6fe0a93eb1e09f3452492c88ee0d13bac1d6060e6778
-  data.tar.gz: 95bf36dc26fdf153a4783172dd3296a92e004f0109068ade65716d46ffa18590
+  metadata.gz: bd9c6a1966ad36b07d9544c19cfc0b431afd75794ec53f8710792b078e6370ba
+  data.tar.gz: 7048de09969cb804f374efbe9e3117402b9e7d048faceb45ad8390707d1e01ac
 SHA512:
-  metadata.gz: fc6ba275f576aa06da811002891c7d158008fc729462c3c6cec9a30792a62f891469cffb41e8a9538cf863611d348d94c451d6735c41a9b9a0c63fb2fee692ac
-  data.tar.gz: 6a85b7eef1c4989d5dcab0790d226e21a9acaee7a5c40592d11c1608eb5f5bef06452dcd01ae41e988d91ce9a6d6a475c0d32bc74051ecf23a18d4346ea002ec
+  metadata.gz: 0d11c1b1a206d317f433af474f908fabdc0aae002d36b5977577c5691c9756a0717b2377a4e09815b299ea9c9e096402f74742ca7bb204ae2f2be97bd277b581
+  data.tar.gz: 3fa2290369ffdb891d9eb575e4ba90187b3576146a46310e31319352b4ae408b0aae7e1659e5bb45adaf400eea6ca6dab02c032f143d527daf0212a6c5505f17

data/CHANGELOG.md

@@ -1,5 +1,25 @@
 # 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
+  in (`SolidQueue.time_zone`, which defaults to `config.time_zone`), so
+  DeployAngel expects a job scheduled "at 4am every day" at the right hour.
+  Without it, a release could fail for a recurring job that wasn't due yet
+  when the app's time zone in the dashboard differed from the app's own.
+- `deployangel verify` prints a missing recurring job as "didn't run" and
+  when it was expected, instead of its interval as a percentage.
+- The README describes registering deploys on every host before the Heroku
+  add-on.
+
 ## 0.1.0 (2026-10-01)
 
 - Release identity on Kamal (`KAMAL_VERSION`), Render (`RENDER_GIT_COMMIT`),

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:
@@ -130,9 +137,10 @@ including IDs, since only 100 distinct names are counted per minute.
 
 ## Registering deploys
 
-On Heroku, the add-on registers every release for you. Anywhere else,
-DeployAngel notices a new release when the agent first reports it, and verifies
-it from there. The releases running when you install the agent are the baseline.
+DeployAngel notices a new release when the agent first reports it, and
+verifies it from there, with nothing to set up. The releases running when you
+install the agent are the baseline. On Heroku, the add-on also registers every
+release for you.
 
 Registering deploys yourself adds a link to the CI run and a label of your
 choice, and starts verification as soon as the deploy finishes. Use an API

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/cli/formatter.rb

@@ -70,6 +70,9 @@ module DeployAngel
         label = "#{LABELS.fetch(finding["signal"], finding["signal"])} on #{finding["scope"]}"
         if COUNTS.include?(finding["signal"])
           "#{label}: #{finding["observed_value"].to_i} occurrences"
+        elsif finding["signal"] == "missing_recurring_job"
+          # Its value is the job's interval in seconds, not a rate.
+          "#{label}: #{finding["status"] == "pass" ? "ran" : "didn't run"}, #{finding["threshold"]}"
         elsif finding["baseline_value"].nil? && finding["observed_value"].nil?
           "#{label}: #{finding["threshold"]}"
         else

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/rails/metadata.rb

@@ -68,12 +68,23 @@ module DeployAngel
         Array(tasks).filter_map do |key, task|
           next unless task.is_a?(Hash) && task["schedule"]
 
-          { "key" => key.to_s, "class" => task["class"]&.to_s, "schedule" => task["schedule"].to_s, "source" => "solid_queue" }
+          { "key" => key.to_s, "class" => task["class"]&.to_s, "schedule" => task["schedule"].to_s, "source" => "solid_queue",
+            "time_zone" => scheduler_time_zone }
         end
       rescue StandardError
         []
       end
 
+      # The zone Solid Queue reads a schedule in when the schedule names
+      # none: its own setting, config.time_zone by default. nil when that's
+      # the system's local time or Solid Queue predates the setting, and
+      # DeployAngel then doesn't assume one.
+      def scheduler_time_zone
+        ::SolidQueue.time_zone if defined?(::SolidQueue) && ::SolidQueue.respond_to?(:time_zone)
+      rescue StandardError
+        nil
+      end
+
       def file_manifest
         @file_manifest ||= begin
           if @config.file_digests

data/lib/deployangel/version.rb

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

metadata

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