ObanDoctor.Check.Config.InsertTriggerEnabled (oban_doctor v0.2.2)

Copy Markdown View Source

Checks for Oban instances that have insert_trigger enabled (default behavior).

The insert_trigger option causes Oban to notify queues via PostgreSQL NOTIFY whenever a job is inserted. While this enables faster job pickup, it adds overhead for high-volume job insertion.

How to fix

Add insert_trigger: false to your Oban configuration:

config :my_app, Oban,
  insert_trigger: false,
  queues: [default: 10]

Warning

Disabling the insert trigger means jobs may wait up to 1 second before being picked up by a queue, as workers will rely on polling instead of notifications.

See Oban Triggers for more details.

Configuration

In .oban_doctor.exs:

checks: [
  insert_trigger_enabled: [
    # Disable the check entirely
    enabled: false,

    # Or exclude specific Oban instances from this check
    excluded_instances: [MyApp.SecondaryOban]
  ]
]