delayed 0.1.0

data/spec/delayed/monitor_spec.rb

@@ -0,0 +1,276 @@
+require 'helper'
+
+RSpec.describe Delayed::Monitor do
+  before do
+    described_class.sleep_delay = 0
+  end
+
+  let(:default_payload) do
+    {
+      table: 'delayed_jobs',
+      database: current_database,
+      database_adapter: current_adapter,
+      queue: 'default',
+    }
+  end
+
+  it 'emits empty metrics for all default priorities' do
+    expect { subject.run! }
+      .to emit_notification("delayed.monitor.run").with_payload(default_payload.except(:queue))
+      .and emit_notification("delayed.job.count").with_payload(default_payload.merge(priority: 'interactive')).with_value(0)
+      .and emit_notification("delayed.job.count").with_payload(default_payload.merge(priority: 'user_visible')).with_value(0)
+      .and emit_notification("delayed.job.count").with_payload(default_payload.merge(priority: 'eventual')).with_value(0)
+      .and emit_notification("delayed.job.count").with_payload(default_payload.merge(priority: 'reporting')).with_value(0)
+      .and emit_notification("delayed.job.future_count").with_payload(default_payload.merge(priority: 'interactive')).with_value(0)
+      .and emit_notification("delayed.job.future_count").with_payload(default_payload.merge(priority: 'user_visible')).with_value(0)
+      .and emit_notification("delayed.job.future_count").with_payload(default_payload.merge(priority: 'eventual')).with_value(0)
+      .and emit_notification("delayed.job.future_count").with_payload(default_payload.merge(priority: 'reporting')).with_value(0)
+      .and emit_notification("delayed.job.locked_count").with_payload(default_payload.merge(priority: 'interactive')).with_value(0)
+      .and emit_notification("delayed.job.locked_count").with_payload(default_payload.merge(priority: 'user_visible')).with_value(0)
+      .and emit_notification("delayed.job.locked_count").with_payload(default_payload.merge(priority: 'eventual')).with_value(0)
+      .and emit_notification("delayed.job.locked_count").with_payload(default_payload.merge(priority: 'reporting')).with_value(0)
+      .and emit_notification("delayed.job.erroring_count").with_payload(default_payload.merge(priority: 'interactive')).with_value(0)
+      .and emit_notification("delayed.job.erroring_count").with_payload(default_payload.merge(priority: 'user_visible')).with_value(0)
+      .and emit_notification("delayed.job.erroring_count").with_payload(default_payload.merge(priority: 'eventual')).with_value(0)
+      .and emit_notification("delayed.job.erroring_count").with_payload(default_payload.merge(priority: 'reporting')).with_value(0)
+      .and emit_notification("delayed.job.failed_count").with_payload(default_payload.merge(priority: 'interactive')).with_value(0)
+      .and emit_notification("delayed.job.failed_count").with_payload(default_payload.merge(priority: 'user_visible')).with_value(0)
+      .and emit_notification("delayed.job.failed_count").with_payload(default_payload.merge(priority: 'eventual')).with_value(0)
+      .and emit_notification("delayed.job.failed_count").with_payload(default_payload.merge(priority: 'reporting')).with_value(0)
+      .and emit_notification("delayed.job.working_count").with_payload(default_payload.merge(priority: 'interactive')).with_value(0)
+      .and emit_notification("delayed.job.working_count").with_payload(default_payload.merge(priority: 'user_visible')).with_value(0)
+      .and emit_notification("delayed.job.working_count").with_payload(default_payload.merge(priority: 'eventual')).with_value(0)
+      .and emit_notification("delayed.job.working_count").with_payload(default_payload.merge(priority: 'reporting')).with_value(0)
+      .and emit_notification("delayed.job.workable_count").with_payload(default_payload.merge(priority: 'interactive')).with_value(0)
+      .and emit_notification("delayed.job.workable_count").with_payload(default_payload.merge(priority: 'user_visible')).with_value(0)
+      .and emit_notification("delayed.job.workable_count").with_payload(default_payload.merge(priority: 'eventual')).with_value(0)
+      .and emit_notification("delayed.job.workable_count").with_payload(default_payload.merge(priority: 'reporting')).with_value(0)
+      .and emit_notification("delayed.job.max_age").with_payload(default_payload.merge(priority: 'interactive')).with_value(0)
+      .and emit_notification("delayed.job.max_age").with_payload(default_payload.merge(priority: 'user_visible')).with_value(0)
+      .and emit_notification("delayed.job.max_age").with_payload(default_payload.merge(priority: 'eventual')).with_value(0)
+      .and emit_notification("delayed.job.max_age").with_payload(default_payload.merge(priority: 'reporting')).with_value(0)
+      .and emit_notification("delayed.job.max_lock_age").with_payload(default_payload.merge(priority: 'interactive')).with_value(0)
+      .and emit_notification("delayed.job.max_lock_age").with_payload(default_payload.merge(priority: 'user_visible')).with_value(0)
+      .and emit_notification("delayed.job.max_lock_age").with_payload(default_payload.merge(priority: 'eventual')).with_value(0)
+      .and emit_notification("delayed.job.max_lock_age").with_payload(default_payload.merge(priority: 'reporting')).with_value(0)
+      .and emit_notification("delayed.job.alert_age_percent").with_payload(default_payload.merge(priority: 'interactive')).with_value(0)
+      .and emit_notification("delayed.job.alert_age_percent").with_payload(default_payload.merge(priority: 'user_visible')).with_value(0)
+      .and emit_notification("delayed.job.alert_age_percent").with_payload(default_payload.merge(priority: 'eventual')).with_value(0)
+      .and emit_notification("delayed.job.alert_age_percent").with_payload(default_payload.merge(priority: 'reporting')).with_value(0)
+  end
+
+  context 'when named priorities are customized' do
+    around do |example|
+      Delayed::Priority.names = { high: 0, low: 7 }
+      example.run
+    ensure
+      Delayed::Priority.names = nil
+    end
+
+    it 'emits empty metrics for all custom priorities' do
+      expect { subject.run! }
+        .to emit_notification("delayed.monitor.run").with_payload(default_payload.except(:queue))
+        .and emit_notification("delayed.job.count").with_payload(default_payload.merge(priority: 'high')).with_value(0)
+        .and emit_notification("delayed.job.count").with_payload(default_payload.merge(priority: 'low')).with_value(0)
+        .and emit_notification("delayed.job.future_count").with_payload(default_payload.merge(priority: 'high')).with_value(0)
+        .and emit_notification("delayed.job.future_count").with_payload(default_payload.merge(priority: 'low')).with_value(0)
+        .and emit_notification("delayed.job.locked_count").with_payload(default_payload.merge(priority: 'high')).with_value(0)
+        .and emit_notification("delayed.job.locked_count").with_payload(default_payload.merge(priority: 'low')).with_value(0)
+        .and emit_notification("delayed.job.erroring_count").with_payload(default_payload.merge(priority: 'high')).with_value(0)
+        .and emit_notification("delayed.job.erroring_count").with_payload(default_payload.merge(priority: 'low')).with_value(0)
+        .and emit_notification("delayed.job.failed_count").with_payload(default_payload.merge(priority: 'high')).with_value(0)
+        .and emit_notification("delayed.job.failed_count").with_payload(default_payload.merge(priority: 'low')).with_value(0)
+        .and emit_notification("delayed.job.working_count").with_payload(default_payload.merge(priority: 'high')).with_value(0)
+        .and emit_notification("delayed.job.working_count").with_payload(default_payload.merge(priority: 'low')).with_value(0)
+        .and emit_notification("delayed.job.workable_count").with_payload(default_payload.merge(priority: 'high')).with_value(0)
+        .and emit_notification("delayed.job.workable_count").with_payload(default_payload.merge(priority: 'low')).with_value(0)
+        .and emit_notification("delayed.job.max_age").with_payload(default_payload.merge(priority: 'high')).with_value(0)
+        .and emit_notification("delayed.job.max_age").with_payload(default_payload.merge(priority: 'low')).with_value(0)
+        .and emit_notification("delayed.job.max_lock_age").with_payload(default_payload.merge(priority: 'high')).with_value(0)
+        .and emit_notification("delayed.job.max_lock_age").with_payload(default_payload.merge(priority: 'low')).with_value(0)
+        .and emit_notification("delayed.job.alert_age_percent").with_payload(default_payload.merge(priority: 'high')).with_value(0)
+        .and emit_notification("delayed.job.alert_age_percent").with_payload(default_payload.merge(priority: 'low')).with_value(0)
+    end
+  end
+
+  context 'when there are jobs in the queue' do
+    let(:now) { Time.now.change(nsec: 0) } # rubocop:disable Rails/TimeZone
+    let(:job_attributes) do
+      {
+        run_at: now,
+        queue: 'default',
+        handler: "--- !ruby/object:SimpleJob\n",
+        attempts: 0,
+      }
+    end
+    let(:failed_attributes) { { run_at: now - 1.week, last_error: '123', failed_at: now - 1.day, attempts: 4, locked_at: now - 1.day } }
+    let(:p0_attributes) { job_attributes.merge(priority: 1) }
+    let(:p10_attributes) { job_attributes.merge(priority: 13) }
+    let(:p20_attributes) { job_attributes.merge(priority: 23) }
+    let(:p30_attributes) { job_attributes.merge(priority: 999) }
+    let(:p0_payload) { default_payload.merge(priority: 'interactive') }
+    let(:p10_payload) { default_payload.merge(priority: 'user_visible') }
+    let(:p20_payload) { default_payload.merge(priority: 'eventual') }
+    let(:p30_payload) { default_payload.merge(priority: 'reporting') }
+    let!(:p0_workable_job) { Delayed::Job.create! p0_attributes.merge(run_at: now - 30.seconds) }
+    let!(:p0_failed_job) { Delayed::Job.create! p0_attributes.merge(failed_attributes) }
+    let!(:p0_future_job) { Delayed::Job.create! p0_attributes.merge(run_at: now + 1.hour) }
+    let!(:p0_working_job) { Delayed::Job.create! p0_attributes.merge(locked_at: now - 3.minutes) }
+    let!(:p10_workable_job) { Delayed::Job.create! p10_attributes.merge(run_at: now - 2.minutes) }
+    let!(:p10_failed_job) { Delayed::Job.create! p10_attributes.merge(failed_attributes) }
+    let!(:p10_future_job) { Delayed::Job.create! p10_attributes.merge(run_at: now + 1.hour) }
+    let!(:p10_working_job) { Delayed::Job.create! p10_attributes.merge(locked_at: now - 7.minutes) }
+    let!(:p20_workable_job) { Delayed::Job.create! p20_attributes.merge(run_at: now - 1.hour) }
+    let!(:p20_failed_job) { Delayed::Job.create! p20_attributes.merge(failed_attributes) }
+    let!(:p20_future_job) { Delayed::Job.create! p20_attributes.merge(run_at: now + 1.hour) }
+    let!(:p20_working_job) { Delayed::Job.create! p20_attributes.merge(locked_at: now - 9.minutes) }
+    let!(:p30_workable_job) { Delayed::Job.create! p30_attributes.merge(run_at: now - 6.hours) }
+    let!(:p30_failed_job) { Delayed::Job.create! p30_attributes.merge(failed_attributes) }
+    let!(:p30_future_job) { Delayed::Job.create! p30_attributes.merge(run_at: now + 1.hour) }
+    let!(:p30_working_job) { Delayed::Job.create! p30_attributes.merge(locked_at: now - 11.minutes) }
+    let!(:p30_workable_job_in_other_queue) { Delayed::Job.create! p30_attributes.merge(run_at: now - 4.hours, queue: 'banana') }
+
+    around do |example|
+      Timecop.freeze(now) { example.run }
+    end
+
+    it 'emits the expected results for each metric' do
+      expect { subject.run! }
+        .to emit_notification("delayed.monitor.run").with_payload(default_payload.except(:queue))
+        .and emit_notification("delayed.job.count").with_payload(p0_payload).with_value(4)
+        .and emit_notification("delayed.job.future_count").with_payload(p0_payload).with_value(1)
+        .and emit_notification("delayed.job.locked_count").with_payload(p0_payload).with_value(2)
+        .and emit_notification("delayed.job.erroring_count").with_payload(p0_payload).with_value(1)
+        .and emit_notification("delayed.job.failed_count").with_payload(p0_payload).with_value(1)
+        .and emit_notification("delayed.job.working_count").with_payload(p0_payload).with_value(1)
+        .and emit_notification("delayed.job.workable_count").with_payload(p0_payload).with_value(1)
+        .and emit_notification("delayed.job.max_age").with_payload(p0_payload).with_value(30.seconds)
+        .and emit_notification("delayed.job.max_lock_age").with_payload(p0_payload).with_value(3.minutes)
+        .and emit_notification("delayed.job.alert_age_percent").with_payload(p0_payload).with_value(30.0.seconds / 1.minute * 100)
+        .and emit_notification("delayed.job.count").with_payload(p10_payload).with_value(4)
+        .and emit_notification("delayed.job.future_count").with_payload(p10_payload).with_value(1)
+        .and emit_notification("delayed.job.locked_count").with_payload(p10_payload).with_value(2)
+        .and emit_notification("delayed.job.erroring_count").with_payload(p10_payload).with_value(1)
+        .and emit_notification("delayed.job.failed_count").with_payload(p10_payload).with_value(1)
+        .and emit_notification("delayed.job.working_count").with_payload(p10_payload).with_value(1)
+        .and emit_notification("delayed.job.workable_count").with_payload(p10_payload).with_value(1)
+        .and emit_notification("delayed.job.max_age").with_payload(p10_payload).with_value(2.minutes)
+        .and emit_notification("delayed.job.max_lock_age").with_payload(p10_payload).with_value(7.minutes)
+        .and emit_notification("delayed.job.alert_age_percent").with_payload(p10_payload).with_value(2.0.minutes / 3.minutes * 100)
+        .and emit_notification("delayed.job.count").with_payload(p20_payload).with_value(4)
+        .and emit_notification("delayed.job.future_count").with_payload(p20_payload).with_value(1)
+        .and emit_notification("delayed.job.locked_count").with_payload(p20_payload).with_value(2)
+        .and emit_notification("delayed.job.erroring_count").with_payload(p20_payload).with_value(1)
+        .and emit_notification("delayed.job.failed_count").with_payload(p20_payload).with_value(1)
+        .and emit_notification("delayed.job.working_count").with_payload(p20_payload).with_value(1)
+        .and emit_notification("delayed.job.workable_count").with_payload(p20_payload).with_value(1)
+        .and emit_notification("delayed.job.max_age").with_payload(p20_payload).with_value(1.hour)
+        .and emit_notification("delayed.job.max_lock_age").with_payload(p20_payload).with_value(9.minutes)
+        .and emit_notification("delayed.job.alert_age_percent").with_payload(p20_payload).with_value(1.hour / 1.5.hours * 100)
+        .and emit_notification("delayed.job.count").with_payload(p30_payload).with_value(4)
+        .and emit_notification("delayed.job.future_count").with_payload(p30_payload).with_value(1)
+        .and emit_notification("delayed.job.locked_count").with_payload(p30_payload).with_value(2)
+        .and emit_notification("delayed.job.erroring_count").with_payload(p30_payload).with_value(1)
+        .and emit_notification("delayed.job.failed_count").with_payload(p30_payload).with_value(1)
+        .and emit_notification("delayed.job.working_count").with_payload(p30_payload).with_value(1)
+        .and emit_notification("delayed.job.workable_count").with_payload(p30_payload).with_value(1)
+        .and emit_notification("delayed.job.max_age").with_payload(p30_payload).with_value(6.hours)
+        .and emit_notification("delayed.job.max_lock_age").with_payload(p30_payload).with_value(11.minutes)
+        .and emit_notification("delayed.job.alert_age_percent").with_payload(p30_payload).with_value(100) # 6 hours / 4 hours (overflow)
+        .and emit_notification("delayed.job.workable_count").with_payload(p30_payload.merge(queue: 'banana')).with_value(1)
+        .and emit_notification("delayed.job.max_age").with_payload(p30_payload.merge(queue: 'banana')).with_value(4.hours)
+    end
+
+    context 'when named priorities are customized' do
+      around do |example|
+        Delayed::Priority.names = { high: 0, low: 20 }
+        example.run
+      ensure
+        Delayed::Priority.names = nil
+      end
+      let(:p0_payload) { default_payload.merge(priority: 'high') }
+      let(:p20_payload) { default_payload.merge(priority: 'low') }
+
+      it 'emits the expected results for each metric' do
+        expect { subject.run! }
+          .to emit_notification("delayed.monitor.run").with_payload(default_payload.except(:queue))
+          .and emit_notification("delayed.job.count").with_payload(p0_payload).with_value(8)
+          .and emit_notification("delayed.job.future_count").with_payload(p0_payload).with_value(2)
+          .and emit_notification("delayed.job.locked_count").with_payload(p0_payload).with_value(4)
+          .and emit_notification("delayed.job.erroring_count").with_payload(p0_payload).with_value(2)
+          .and emit_notification("delayed.job.failed_count").with_payload(p0_payload).with_value(2)
+          .and emit_notification("delayed.job.working_count").with_payload(p0_payload).with_value(2)
+          .and emit_notification("delayed.job.workable_count").with_payload(p0_payload).with_value(2)
+          .and emit_notification("delayed.job.max_age").with_payload(p0_payload).with_value(2.minutes)
+          .and emit_notification("delayed.job.max_lock_age").with_payload(p0_payload).with_value(7.minutes)
+          .and emit_notification("delayed.job.alert_age_percent").with_payload(p0_payload).with_value(0)
+          .and emit_notification("delayed.job.count").with_payload(p20_payload).with_value(8)
+          .and emit_notification("delayed.job.future_count").with_payload(p20_payload).with_value(2)
+          .and emit_notification("delayed.job.locked_count").with_payload(p20_payload).with_value(4)
+          .and emit_notification("delayed.job.erroring_count").with_payload(p20_payload).with_value(2)
+          .and emit_notification("delayed.job.failed_count").with_payload(p20_payload).with_value(2)
+          .and emit_notification("delayed.job.working_count").with_payload(p20_payload).with_value(2)
+          .and emit_notification("delayed.job.workable_count").with_payload(p20_payload).with_value(2)
+          .and emit_notification("delayed.job.max_age").with_payload(p20_payload).with_value(6.hours)
+          .and emit_notification("delayed.job.max_lock_age").with_payload(p20_payload).with_value(11.minutes)
+          .and emit_notification("delayed.job.alert_age_percent").with_payload(p20_payload).with_value(0)
+          .and emit_notification("delayed.job.workable_count").with_payload(p20_payload.merge(queue: 'banana')).with_value(1)
+          .and emit_notification("delayed.job.max_age").with_payload(p20_payload.merge(queue: 'banana')).with_value(4.hours)
+      end
+
+      context 'when alert thresholds are specified' do
+        around do |example|
+          Delayed::Priority.alerts = { high: { age: 3.hours }, low: { age: 1.year } }
+          example.run
+        ensure
+          Delayed::Priority.alerts = nil
+        end
+
+        it 'emits the expected alert_age_percent results' do
+          expect { subject.run! }
+            .to emit_notification("delayed.job.alert_age_percent").with_payload(p0_payload).with_value(2.0.minutes / 3.hours * 100)
+            .and emit_notification("delayed.job.alert_age_percent").with_payload(p20_payload).with_value(6.0.hours / 1.year * 100)
+        end
+      end
+    end
+
+    context 'when worker queues are specified' do
+      around do |example|
+        Delayed::Worker.queues = %w(banana gram)
+        Delayed::Priority.names = { interactive: 0 } # avoid splitting by priority for simplicity
+        Delayed::Priority.alerts = { interactive: { age: 8.hours } }
+        example.run
+      ensure
+        Delayed::Priority.names = nil
+        Delayed::Worker.queues = []
+      end
+      let(:banana_payload) { default_payload.merge(queue: 'banana', priority: 'interactive') }
+      let(:gram_payload) { default_payload.merge(queue: 'gram', priority: 'interactive') }
+
+      it 'emits the expected results for each queue' do
+        expect { subject.run! }
+          .to emit_notification("delayed.monitor.run").with_payload(default_payload.except(:queue))
+          .and emit_notification("delayed.job.count").with_payload(banana_payload).with_value(1)
+          .and emit_notification("delayed.job.future_count").with_payload(banana_payload).with_value(0)
+          .and emit_notification("delayed.job.locked_count").with_payload(banana_payload).with_value(0)
+          .and emit_notification("delayed.job.erroring_count").with_payload(banana_payload).with_value(0)
+          .and emit_notification("delayed.job.failed_count").with_payload(banana_payload).with_value(0)
+          .and emit_notification("delayed.job.working_count").with_payload(banana_payload).with_value(0)
+          .and emit_notification("delayed.job.workable_count").with_payload(banana_payload).with_value(1)
+          .and emit_notification("delayed.job.max_age").with_payload(banana_payload).with_value(4.hours)
+          .and emit_notification("delayed.job.max_lock_age").with_payload(banana_payload).with_value(0)
+          .and emit_notification("delayed.job.alert_age_percent").with_payload(banana_payload).with_value(4.0.hours / 8.hours * 100)
+          .and emit_notification("delayed.job.count").with_payload(gram_payload).with_value(0)
+          .and emit_notification("delayed.job.future_count").with_payload(gram_payload).with_value(0)
+          .and emit_notification("delayed.job.locked_count").with_payload(gram_payload).with_value(0)
+          .and emit_notification("delayed.job.erroring_count").with_payload(gram_payload).with_value(0)
+          .and emit_notification("delayed.job.failed_count").with_payload(gram_payload).with_value(0)
+          .and emit_notification("delayed.job.working_count").with_payload(gram_payload).with_value(0)
+          .and emit_notification("delayed.job.workable_count").with_payload(gram_payload).with_value(0)
+          .and emit_notification("delayed.job.max_age").with_payload(gram_payload).with_value(0)
+          .and emit_notification("delayed.job.max_lock_age").with_payload(gram_payload).with_value(0)
+          .and emit_notification("delayed.job.alert_age_percent").with_payload(gram_payload).with_value(0)
+      end
+    end
+  end
+end

data/spec/delayed/plugins/instrumentation_spec.rb

@@ -0,0 +1,49 @@
+require 'helper'
+
+RSpec.describe Delayed::Plugins::Instrumentation do
+  let!(:job) { Delayed::Job.enqueue SimpleJob.new, priority: 13, queue: 'test' }
+
+  it 'emits delayed.job.run' do
+    expect { Delayed::Worker.new.work_off }.to emit_notification('delayed.job.run').with_payload(
+      job_name: 'SimpleJob',
+      priority: 13,
+      queue: 'test',
+      table: 'delayed_jobs',
+      database: current_database,
+      database_adapter: current_adapter,
+      job: job,
+    )
+  end
+
+  context 'when the job errors' do
+    let!(:job) { Delayed::Job.enqueue ErrorJob.new, priority: 7, queue: 'foo' }
+
+    it 'emits delayed.job.error' do
+      expect { Delayed::Worker.new.work_off }.to emit_notification('delayed.job.error').with_payload(
+        job_name: 'ErrorJob',
+        priority: 7,
+        queue: 'foo',
+        table: 'delayed_jobs',
+        database: current_database,
+        database_adapter: current_adapter,
+        job: job,
+      )
+    end
+  end
+
+  context 'when the job fails' do
+    let!(:job) { Delayed::Job.enqueue FailureJob.new, priority: 3, queue: 'bar' }
+
+    it 'emits delayed.job.failure' do
+      expect { Delayed::Worker.new.work_off }.to emit_notification('delayed.job.failure').with_payload(
+        job_name: 'FailureJob',
+        priority: 3,
+        queue: 'bar',
+        table: 'delayed_jobs',
+        database: current_database,
+        database_adapter: current_adapter,
+        job: job,
+      )
+    end
+  end
+end

data/spec/delayed/priority_spec.rb

@@ -0,0 +1,154 @@
+require 'helper'
+
+RSpec.describe Delayed::Priority do
+  let(:custom_names) { nil }
+  let(:custom_alerts) { nil }
+
+  around do |example|
+    described_class.names = custom_names
+    described_class.alerts = custom_alerts
+    example.run
+  ensure
+    described_class.alerts = nil
+    described_class.names = nil
+  end
+
+  describe '.names, .ranges, .alerts, method_missing' do
+    it 'defaults to interactive, user_visible, eventual, reporting' do
+      expect(described_class.names).to eq(
+        interactive: 0,
+        user_visible: 10,
+        eventual: 20,
+        reporting: 30,
+      )
+      expect(described_class.ranges).to eq(
+        interactive: (0...10),
+        user_visible: (10...20),
+        eventual: (20...30),
+        reporting: (30...Float::INFINITY),
+      )
+      expect(described_class.alerts).to eq(
+        interactive: { age: 1.minute, run_time: 30.seconds, attempts: 3 },
+        user_visible: { age: 3.minutes, run_time: 90.seconds, attempts: 5 },
+        eventual: { age: 1.5.hours, run_time: 5.minutes, attempts: 8 },
+        reporting: { age: 4.hours, run_time: 10.minutes, attempts: 8 },
+      )
+      expect(described_class).to respond_to(:interactive)
+      expect(described_class).to respond_to(:user_visible)
+      expect(described_class).to respond_to(:eventual)
+      expect(described_class).to respond_to(:reporting)
+      expect(described_class.interactive).to eq 0
+      expect(described_class.user_visible).to eq 10
+      expect(described_class.eventual).to eq 20
+      expect(described_class.reporting).to eq 30
+    end
+
+    context 'when customized to high, medium, low' do
+      let(:custom_names) { { high: 0, medium: 100, low: 500 } }
+
+      it 'returns the customized value' do
+        expect(described_class.names).to eq(
+          high: 0,
+          medium: 100,
+          low: 500,
+        )
+        expect(described_class.ranges).to eq(
+          high: (0...100),
+          medium: (100...500),
+          low: (500...Float::INFINITY),
+        )
+        expect(described_class.alerts).to eq({})
+        expect(described_class).not_to respond_to(:interactive)
+        expect(described_class).not_to respond_to(:user_visible)
+        expect(described_class).not_to respond_to(:eventual)
+        expect(described_class).not_to respond_to(:reporting)
+        expect(described_class).to respond_to(:high)
+        expect(described_class).to respond_to(:medium)
+        expect(described_class).to respond_to(:low)
+        expect(described_class.high).to eq 0
+        expect(described_class.medium).to eq 100
+        expect(described_class.low).to eq 500
+      end
+
+      context 'when custom alert thresholds are defined' do
+        let(:custom_alerts) { { high: { age: 1.minute }, medium: { run_time: 1.minute }, low: { attempts: 10 } } }
+
+        it 'returns the customized value' do
+          expect(described_class.alerts).to eq(
+            high: { age: 1.minute },
+            medium: { run_time: 1.minute },
+            low: { attempts: 10 },
+          )
+        end
+      end
+    end
+  end
+
+  it 'provides the name of the priority range' do
+    expect(described_class.new(0).name).to eq :interactive
+    expect(described_class.new(3).name).to eq :interactive
+    expect(described_class.new(10).name).to eq :user_visible
+    expect(described_class.new(29).name).to eq :eventual
+    expect(described_class.new(999).name).to eq :reporting
+    expect(described_class.new(-123).name).to eq nil
+  end
+
+  it 'supports initialization by symbol value' do
+    expect(described_class.new(:interactive)).to eq(0)
+    expect(described_class.new(:user_visible)).to eq(10)
+    expect(described_class.new(:eventual)).to eq(20)
+    expect(described_class.new(:reporting)).to eq(30)
+  end
+
+  it "supports predicate ('?') methods" do
+    expect(described_class.new(0).interactive?).to eq true
+    expect(described_class.new(3)).to be_interactive
+    expect(described_class.new(3).user_visible?).to eq false
+    expect(described_class.new(10)).to be_user_visible
+    expect(described_class.new(29)).to be_eventual
+    expect(described_class.new(999)).to be_reporting
+    expect(described_class.new(-123).interactive?).to eq false
+  end
+
+  it 'supports alert threshold methods' do
+    described_class.alerts = {
+      interactive: { age: 77.seconds },
+      user_visible: { run_time: 11.seconds },
+      eventual: { attempts: 7 },
+    }
+    expect(described_class.interactive.alert_age).to eq 77.seconds
+    expect(described_class.user_visible.alert_run_time).to eq 11.seconds
+    expect(described_class.eventual.alert_attempts).to eq 7
+    expect(described_class.reporting.alert_age).to be_nil
+    expect(described_class.reporting.alert_run_time).to be_nil
+    expect(described_class.reporting.alert_attempts).to be_nil
+  ensure
+    described_class.alerts = nil
+  end
+
+  it 'supports comparisons' do
+    expect(described_class.new(3)).to be < described_class.new(5)
+    expect(described_class.new(10)).to be >= described_class.new(10)
+    expect(described_class.new(101)).to eq described_class.new(101) # rubocop:disable RSpec/IdenticalEqualityAssertion
+  end
+
+  it 'suports coercion' do
+    expect(described_class.new(0)).to eq 0
+    expect(described_class.new(8)).to be > 5
+    expect(described_class.new(5)).to be < 8
+    expect(0 == described_class.new(0)).to eq true
+    expect(8 > described_class.new(5)).to eq true
+    expect(5 < described_class.new(8)).to eq true
+  end
+
+  it 'supports sorting' do
+    expect(
+      [
+        described_class.new(5),
+        described_class.new(40),
+        described_class.new(3),
+        described_class.new(-13),
+      ].sort,
+    ).to eq [-13, 3, 5, 40]
+  end
+end