railwatch 0.9.0 → 0.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3cd11714c7a290f5f6717f3b8f239b72b669fce39a2797a59fcb862595925778
-  data.tar.gz: 147d3416d6d047a6c87b8ccdb9d2b67b8e2a6058f881956241f65dff0ea239c5
+  metadata.gz: 5e6d353ab28ad688da0cd8f6cce5795101736d0e4ff9ca754aac49ba307a6614
+  data.tar.gz: 51558d4fa45d0f53a33c426e844ab4312704d2a82a6438070c1ad8bdcb5bfc6a
 SHA512:
-  metadata.gz: 774a7cbf876e5220af985a97a2cc6919ebb91ff9ea7a38e414956b1c0cbf3cedb723cbc470baaa807fa7343295117576df15485923502d855212e83698bee592
-  data.tar.gz: c0d3106cd7c800cf938daf056ce9c279b10e5013af618b39e4e31411517dc578a4e71fd711b5a4158e3b4acdb76964476ca298377f792c0b8f40319ad13c877e
+  metadata.gz: 498984621aca78d24b668d15d8d77366b826335d7143b9e9e1ececfb8feab881a287dadb3ddae809c87597940cac05a34e1728ffdb9ecce073d4e4ffdabdcd46
+  data.tar.gz: 0e03f832ba5fc1d5a52168136252d5d789837d4a29f675a824f7d0577a5eb1f66cc35cc7d1f86f470d6afc7ebfc4d97978b3542b974de71a542ac92079e273d6

data/CHANGELOG.md

@@ -6,6 +6,15 @@
      filled in by the release commit, which is also the only commit that
      touches lib/railwatch/version.rb and Gemfile.lock. See CONTRIBUTING.md. -->
 
+## 0.9.1 (2026-10-10)
+
+- Sampling (or reporter backpressure, which divides every rate by up to 8)
+  no longer drops a scheduled task's `scheduled_task` record: a sampled-out
+  run still queues it, alone, and only its child records are dropped. The
+  record is the run's check-in, and a sampled-out run read as "missed its
+  run" for a task that ran on time. Once queued it is subject to the same
+  reporter-buffer and delivery limits as any other record.
+
 ## 0.9.0 (2026-10-08)
 
 - An `outgoing_request` now says whether it was made inside a database

data/docs/configuration.md

@@ -50,7 +50,9 @@ proxy with `Forwarded` or `X-Forwarded-*` headers.
 is decided once per execution, not per record, by
 `Railwatch::Sampler.decide` in `lib/railwatch/sampler.rb`. A sampled-in
 execution ships every child record it buffered. A sampled-out one ships
-nothing except an unhandled exception. That exception is governed by its
+nothing except an unhandled exception. A sampled-out scheduled task also
+ships its `scheduled_task` record alone: that record is the run's check-in,
+and without it the missed-run check would flag a task that ran. That exception is governed by its
 own `exceptions` rate, decided once and memoized per execution. See
 `docs/records.md`'s `exception` section.
 

data/lib/railwatch/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Railwatch
-  VERSION = "0.9.0"
+  VERSION = "0.9.1"
 end

data/lib/railwatch.rb

@@ -161,6 +161,12 @@ module Railwatch
     # unless the tail decision (tail_keep?) rescues the whole tree, which is
     # also how a failure-context ring is promoted.
     #
+    # A scheduled_task parent ships whatever the sampling decision, alone
+    # when sampled out: it is the run's check-in, and the missed-run detector
+    # reads its absence as "the scheduler did not run this". Sampling it out
+    # (backpressure divides the rate by up to 8) raised "missed its run" for
+    # tasks that ran on time. One small record per run is the price.
+    #
     # The parent's fields may be given as a block instead of keywords. It is
     # called only when a parent is actually going to ship, so a caller whose
     # fields are expensive to assemble (the request middleware: an
@@ -178,7 +184,7 @@ module Railwatch
       # either way: a profiler left running would outlive the execution.
       profiled = exe.profiler_handle && ship_profile(exe, shipping)
       parent = nil
-      if parent_type && (shipping || exe.exception_sampled)
+      if parent_type && (shipping || exe.exception_sampled || parent_type == :scheduled_task)
         fields.merge!(yield) if block_given?
         group ||= fields.delete(:group)
         fields[:tail_sampled] = true if tail
@@ -197,7 +203,8 @@ module Railwatch
         reporter.write(parent) if parent
       elsif parent
         # Head-sampled out, but an unhandled exception rolled the exceptions
-        # sample in: the exception needs its parent, and only its parent.
+        # sample in (the exception needs its parent, and only its parent), or
+        # it is a scheduled task's check-in, which always ships.
         reporter.write(parent)
       end
       parent

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: railwatch
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.9.1
 platform: ruby
 authors:
 - Cole Robertson