jobtick 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e01eac085feb7343b0410a4d7f4de783df293e27853ac8c1aae3428db83975b3
-  data.tar.gz: 76beab20811235bf0f47bd36015b3185d1b9515fb2d28fe9e465e518653481ee
+  metadata.gz: dff65ac46c3a2ce39e670a9b940726f11e7f72ab5695812031417097fbf6e2d6
+  data.tar.gz: bb6044dd0c4c43c9e956de1eec4a5f2032ba6787aebfb9f1ddae8267ff79c35a
 SHA512:
-  metadata.gz: d3107ba0af4b2a1eb40ee86ccfd4ca92e08852467cdc7d0879b9ce772ba2ebf238c116759af69a7084f97513b441453e4920aa9e4f9ed63a5b67efaa9bf1b501
-  data.tar.gz: 3787f52f4ce0a05a6c78c4af25377526d51a4b8a0fa8e829917a308b51fe8e1c3ba63034bd24983a4f7a30f7fe2fa62c45b5bb761571a26987049e5b0294369d
+  metadata.gz: 80ac95fe4fa508de3656ed0cc187657e9e3c2be0f68a76451dc4e1b0633a51b81e4f86ec0665163278daeb12d64e374f0496f6a1c1c7596aac673519cdc6fc87
+  data.tar.gz: c0ce19f6cc1b5cf3f7bad98a38448bf012dafb09dd74fade6934b797ab94f05f82971d5e49cad5a3067f862b29d3cb65f373d8b139468d5912cbc7f7cdb15271

data/README.md

@@ -1,5 +1,7 @@
 # JobTick
 
+[![Ruby](https://github.com/clearstack-labs/jobtick/actions/workflows/main.yml/badge.svg?branch=main)](https://github.com/clearstack-labs/jobtick/actions/workflows/main.yml)
+
 **Rails job monitoring for Whenever, Solid Queue, and Sidekiq.**
 Know when your scheduled jobs stop running — before your users do.
 
@@ -59,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
@@ -87,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)
@@ -101,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
@@ -119,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/client.rb

@@ -19,11 +19,13 @@ module JobTick
       post("/ping/#{monitor_key}", payload)
     end
 
-    def register(monitors)
+    def register(monitors, app_name: nil)
       return unless JobTick.config.enabled
       return if JobTick.config.api_key.nil?
 
-      post("/monitors/sync", { monitors: monitors })
+      payload = { monitors: monitors }
+      payload[:app_name] = app_name if app_name && !app_name.empty?
+      post("/monitors/sync", payload)
     end
 
     private

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,9 +9,14 @@ 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?
 
-      JobTick.client.register(monitors)
+      app_name = Rails.application.class.module_parent_name if defined?(Rails)
+      JobTick.client.register(monitors, app_name: app_name)
       monitors
     end
   end

data/lib/jobtick/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module JobTick
-  VERSION = "0.1.0"
+  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.0
+  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