jobtick 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ef3818e1dd990c8e9eb1a46b5ed83dcd91fa62e7487adecc999173a855de990a
-  data.tar.gz: 1f5fa1a374a40d710d6ba193e46b0adef866546ec9f4e7b192d4801040c9975f
+  metadata.gz: dff65ac46c3a2ce39e670a9b940726f11e7f72ab5695812031417097fbf6e2d6
+  data.tar.gz: bb6044dd0c4c43c9e956de1eec4a5f2032ba6787aebfb9f1ddae8267ff79c35a
 SHA512:
-  metadata.gz: af465b7b4d392967a684e066c018d8f288b032a22590aa37f66e332b293fb0fb9c2964dc6e43ec5513b89d7e99150542cb0c475fd48b1dfe1dc25c582bd65dcd
-  data.tar.gz: 1c42f458a2ba090e5afca3de65dba113e0fdf1c0db466fe411b97cdc068cba45a65c913bacce13bfa05ebe4724fd001f8fee9568fbd72da2490f0714f5c3e45d
+  metadata.gz: 80ac95fe4fa508de3656ed0cc187657e9e3c2be0f68a76451dc4e1b0633a51b81e4f86ec0665163278daeb12d64e374f0496f6a1c1c7596aac673519cdc6fc87
+  data.tar.gz: c0ce19f6cc1b5cf3f7bad98a38448bf012dafb09dd74fade6934b797ab94f05f82971d5e49cad5a3067f862b29d3cb65f373d8b139468d5912cbc7f7cdb15271

data/README.md

@@ -61,21 +61,6 @@ No changes to individual job files. No manual monitor creation. No names to keep
 
 ## What gets monitored
 
-### Whenever (`config/schedule.rb`)
-
-```ruby
-# Your existing schedule.rb — no changes needed
-every 1.day, at: '2:00 am' do
-  runner 'InvoiceJob.perform_later'
-end
-
-every :hour do
-  runner 'SyncInventoryJob.perform_later'
-end
-```
-
-JobTick reads this file at deploy time and creates a monitor for each job automatically.
-
 ### Solid Queue (`config/recurring.yml`)
 
 ```yaml
@@ -89,12 +74,17 @@ sync_exchange_rates:
   schedule: every hour
 ```
 
-Each entry becomes a monitor. If `NightlyReportJob` doesn't run within its expected window, you get an alert.
+At boot, JobTick reads this file and registers a monitor for each entry. It then installs an `around_perform` hook into `ActiveJob::Base` so every job execution automatically sends `started`, `completed`, and `failed` pings. No changes to your job files.
 
 ### Sidekiq periodic jobs
 
+Supports both **sidekiq-cron** and **Sidekiq::Periodic**:
+
 ```ruby
-# Your existing Sidekiq config — no changes needed
+# sidekiq-cron — loaded from config/sidekiq_cron.yml or in an initializer
+Sidekiq::Cron::Job.create(name: 'Nightly Cleanup', cron: '0 2 * * *', class: 'NightlyCleanupWorker')
+
+# Sidekiq::Periodic
 Sidekiq.configure_server do |config|
   config.periodic do |mgr|
     mgr.register('0 * * * *', HourlyDigestWorker)
@@ -103,6 +93,30 @@ Sidekiq.configure_server do |config|
 end
 ```
 
+JobTick installs a server middleware that wraps every job execution. For native Sidekiq workers (`Sidekiq::Worker` subclasses) pings are sent by the middleware. For Active Job workers dispatched through Sidekiq, pings are sent by the `around_perform` hook instead, so nothing is double-counted.
+
+### Whenever (`config/schedule.rb`)
+
+Whenever schedules jobs as cron shell commands, so there is no Ruby hook point to instrument automatically. One setup step is required: run the generator and update your `config/schedule.rb` to use the `jobtick_runner` and `jobtick_rake` job types instead of the built-in `runner` and `rake`:
+
+```
+bundle exec rake jobtick:whenever:setup
+```
+
+This prints the two `job_type` definitions to add to the top of your schedule file, then use them in place of the standard types:
+
+```ruby
+every 1.day, at: '2:00 am' do
+  jobtick_runner 'InvoiceJob.perform_later', monitor_key: 'whenever.invoice_job'
+end
+
+every :hour do
+  jobtick_rake 'reports:sync', monitor_key: 'whenever.reports_sync'
+end
+```
+
+The job types wrap execution with `curl` pings to the JobTick API, so no changes to individual job classes are needed.
+
 ---
 
 ## What you get
@@ -121,7 +135,7 @@ end
 
 ## Requirements
 
-- Ruby >= 3.2
+- Ruby >= 3.3
 - Rails >= 7.0
 - One or more of: Whenever, Solid Queue, Sidekiq
 

data/lib/jobtick/hooks/active_job.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module JobTick
+  module Hooks
+    module ActiveJob
+      def self.included(base)
+        base.around_perform do |job, block|
+          key = JobTick.monitor_key_for(job.class.name)
+          if key
+            JobTick::Monitor.run(key) { block.call }
+          else
+            block.call
+          end
+        end
+      end
+    end
+  end
+end

data/lib/jobtick/middleware/sidekiq.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module JobTick
+  module Middleware
+    class Sidekiq
+      def call(_worker, job, _queue)
+        # Active Job wrappers are handled by the around_perform hook
+        return yield if job["wrapped"]
+
+        key = JobTick.monitor_key_for(job["class"])
+        return yield unless key
+
+        JobTick::Monitor.run(key) { yield }
+      end
+
+      def self.install
+        ::Sidekiq.configure_server do |config|
+          config.server_middleware do |chain|
+            chain.add(JobTick::Middleware::Sidekiq)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/jobtick/railtie.rb

@@ -7,6 +7,9 @@ module JobTick
         next unless JobTick.config.enabled
 
         JobTick::Registry.sync
+
+        ::ActiveJob::Base.include(JobTick::Hooks::ActiveJob) if defined?(::ActiveJob::Base)
+        JobTick::Middleware::Sidekiq.install if defined?(::Sidekiq)
       end
     end
 

data/lib/jobtick/registry.rb

@@ -9,6 +9,10 @@ module JobTick
         Parsers::Sidekiq.parse
       ].flatten.compact
 
+      JobTick.monitor_map = monitors.each_with_object({}) do |m, map|
+        map[m[:task]] = m[:key] if m[:task]
+      end
+
       return [] if monitors.empty?
 
       app_name = Rails.application.class.module_parent_name if defined?(Rails)

data/lib/jobtick/version.rb

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

data/lib/jobtick.rb

@@ -9,6 +9,8 @@ require_relative "jobtick/parsers/whenever"
 require_relative "jobtick/parsers/solid_queue"
 require_relative "jobtick/parsers/sidekiq"
 require_relative "jobtick/registry"
+require_relative "jobtick/hooks/active_job"
+require_relative "jobtick/middleware/sidekiq"
 require_relative "jobtick/railtie" if defined?(Rails::Railtie)
 
 module JobTick
@@ -31,9 +33,22 @@ module JobTick
       defined?(Rails) ? Rails.logger : Logger.new($stdout)
     end
 
+    def monitor_map
+      @monitor_map ||= {}
+    end
+
+    def monitor_map=(map)
+      @monitor_map = map
+    end
+
+    def monitor_key_for(class_name)
+      monitor_map[class_name.to_s]
+    end
+
     def reset!
       @config = nil
       @client = nil
+      @monitor_map = {}
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jobtick
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Clearstack Labs
@@ -39,6 +39,8 @@ files:
 - lib/jobtick.rb
 - lib/jobtick/client.rb
 - lib/jobtick/configuration.rb
+- lib/jobtick/hooks/active_job.rb
+- lib/jobtick/middleware/sidekiq.rb
 - lib/jobtick/monitor.rb
 - lib/jobtick/parsers/sidekiq.rb
 - lib/jobtick/parsers/solid_queue.rb