Oban
Oban

Changelog

All notable changes to Oban.Web will be documented in this file.

v2.5.0 — 2021-01-15

Web Resolver Behaviour

A new Oban.Web.Resolver behaviour module allows users to resolve the current user when loading the dashboard, apply per-user access controls and set per-user refresh rates.

defmodule MyApp.Resolver do
  @behaviour Oban.Web.Resolver

  @impl true
  def resolve_user(conn) do
    conn.private.current_user
  end

  @impl true
  def resolve_access(user) do
    if user.admin? do
      [cancel_jobs: true, delete_jobs: true, retry_jobs: true]
    else
      :read_only
    end
  end

  @impl true
  def resolve_refresh(_user), do: 1
end

Pass your Resolver callback to oban_dashboard in your router:

scope "/" do
  pipe_through :browser

  oban_dashboard "/oban", resolver: MyApp.Resolver
end

Viola, your dashboard now has per-user access controls! Now only admins can cancel, retry or delete jobs while other users can still monitor running jobs and check stats.

See the new Customization guide for more examples and a rundown of available access controls.

Telemetry Integration

The Oban.Web.Telemetry module adds events for instrumentation, logging, error reporting and activity auditing.

Action events are emitted whenever a user performs a write operation with the dashboard, e.g. pausing a queue, cancelling a job, etc. Web now ships with a log handler that you can attach to get full dashboard audit logging. Add this call at application start:

Oban.Web.Telemetry.attach_default_logger(:info)

It will output structured JSON logs matching the format that Oban uses, including the user that performed the action:

  {
    "action":"cancel_jobs",
    "duration":2544,
    "event":"action:stop",
    "job_ids":[290950],
    "oban_name":"Oban",
    "source":"oban_web",
    "user":1818
  }

See the new Telemetry guide for event details!

Other Improvements

  • Remove a hard dependency on oban_pro. If you rely on any Pro plugins be sure to specify an oban_pro dependency in your mix.exs.

  • Remove erroneous batch "Delete" action from states where it shouldn't apply, e.g. executing.

  • Require confirmation before deleting jobs. Deleting is permanent and irreversible, unlike cancelling or other possible actions.

  • Optimize the query that calculates queue and state counts in the sidebar. With millions of jobs the query could take longer than the refresh rate, leading to problems.

v2.4.0 — 2020-12-11

Added

  • Allow default_refresh option when mounting a dashboard in a router.

    The refresh rate controls how frequently the server pulls statistics from the database, and when data is pushed from the server. The default refresh rate is 1 second, but you can now customize it when mounting a dashboard. For example, to set the default refresh to 5 seconds:

    scope "/" do
  pipe_through :browser
  oban_dashboard "/oban", default_refresh: 5
end

    This makes it easy to reduce the load on your database when a lot of users are viewing Oban dashboards.

v2.3.1 — 2020-11-27

Changed

  • Upgrade minimum Phoenix Live View dependency to 0.15.

Fixed

  • Allow retrying or deleting cancelled jobs when they were never attempted.

v2.3.0 — 2020-11-06

Added

  • Cancelling a job transitions the job to the cancelled state rather than discarded. The discarded state is now reserved for jobs that exhaust retry attempts or are purposefully discarded through a {:discard, reason} tuple.

  • Display meta in the job details view.

Changed

  • Upgrade Oban dependency to ~> 2.3.0 to support the new cancelled state, and meta field.

v2.2.3 — 2020-10-15

Changed

  • Replace the queue scale slider with a number input and a submit button. Aside from how difficult it was to scale accurately with a slider, it would fire erroneous update events due to DOM changes.

v2.2.2 — 2020-10-11

Changed

v2.2.1 — 2020-09-29

Fixed

  • Prevent layout jumb between initial render and subsequent mount. This was caused by the lack of a closing tag that was later injected on DOM update.

  • Prevent bleeding events between nested components. The lack of a closing tag seemed to confuse event handling and allowed the wrong component to receive events.

  • Correct touch event handling in the sidebar for mobile devices.

v2.2.0 — 2020-09-11

Added

  • Support multiple isolated dashboards by providing an oban_name option to oban_dashboard/2 calls in the Phoenix router.

    For example, to mount dashboards for multiple Oban instances in an umbrella:

    defmodule MyAppWeb.Router do
  use Phoenix.Router
  import Oban.Web.Router
  scope "/", MyAppWeb do
    pipe_through [:browser]
    oban_dashboard "/oban/web", oban_name: MyWeb.Oban
    oban_dashboard "/oban/ops", oban_name: MyOps.Oban
    oban_dashboard "/oban/ingestion", oban_name: MyIngestion.Oban
  end
end

Changed

  • Clicking anywhere on a job row now opens the details view. Previously only clicking the rightmost "expand" icon opened details, and clicking on the worker name would search for other jobs with the same worker. Now the rightmost "document search" icon performs a related job search.

  • Close the job details view when a user clicks a node name, job state, or queue name in the sidebar.

  • Prevent ugly overflow issues when there are long node or queue names in the sidebar. Note that the full name is still visible on hover.

v2.1.1 — 2020-08-24

Fixed

  • Correct expected plugin naming scheme for compatibility with Oban >= 2.1.

  • Increase stats collection and activation timeouts to compensate for spikes in table size or additional load on the database pool from other processes.

v2.1.0 — 2020-08-06

Added

  • Support alternate live socket transports, namely the "longpoll" transport. Users can specify either "websocket" or "longpoll" directly from the oban_dashboard/2 call in their Phoenix router (which avoids global configuration).

Fixed

  • Skip full text search for PostgreSQL versions < 11.0. Older PG versions don't have proper support for JSONB vectorization or web style search operations.

v2.0.0 — 2020-07-10

Changed

  • Upgrade to Oban 2.0.0, LiveView ~> 0.14, and add a dependency on Oban Pro 0.3.0.

  • Add simple load less/load more pagination for browsing through jobs

  • Move details view inline, eliminating modal sizing and scrolling issues

  • Display queue_time and run_time in the job details view

  • Restore worker filtering using auto-populated search terms

  • Introduce Oban.Web.Router for more convenient and flexible dashboard routing. The new module provides an oban_dashboard/2 macro, which prevents scoping mistakes and provides the foundation of better route support.

    Here is how to mount a dashboard at /oban with the new macro:

    defmodule MyAppWeb.Router do
  use Phoenix.Router
  import Oban.Web.Router
  scope "/", MyAppWeb do
    pipe_through [:browser]
    oban_dashboard "/oban"
  end
end

  • Add bulk actions for all jobs in table view. It's now possible to select one or more jobs in the table and then cancel, run, retry or delete them all.

  • Add a dropdown that controls the refresh rate of jobs and stats in the dashboard. Lowering the refresh rate can reduce query overhead, or pause updates entirely.

  • Expose pause/resume controls and a slider for scaling in the queue side bar.

  • Eliminate migrations. Migrations are no longer necessary for updates or full text searching. You may safely undo previous migrations.

  • Consider job tags along with args and worker name when searching.

  • More intelligent search using "and", "or" and respecting parenthesis.

  • Consistently toggle filters on and off from the sidebar, rather than matching on a filter list in the header.

v1.5.0 — 2020-04-27

Changed

  • Upgrade to Phoenix ~> 1.5, LiveView ~> 0.12 and PubSub ~> 2.0. None of these upgrades required changes to ObanWeb, they are meant to enable upgrades for host applications.

v1.4.0 — 2020-03-24

Changed

  • Upgrade to LiveView ~> 0.10 along with requisite changes to use @inner_content in the layout template. This prevents the view from hanging with a blank screen on load.

v1.3.1 — 2020-03-18

Fixed

v1.3.0 — 2020-03-10

Changed

  • Upgrade to LiveView ~> 0.9 along with the requisite changes to flash handling. Note, this requires pipelines in the host app to use fetch_live_flash instead of fetch_flash.

v1.2.0 — 2020-02-07

Fixes

  • Prevent flash map key issue on initial mount. The lack of a show key on the empty flash map caused runtime errors.

  • Prevent losing stats cache on restart by shifting table ownership into the supervisor.

Changed

  • Clear completed_at and discarded_at timestamps when descheduling jobs.

  • Upgrade to LiveView ~> 0.7.

Added

  • Display job priority value in the table and detail views.

  • Display job tags in the detail view.

v1.1.2 — 2020-02-07

Fixes

  • Correct syntax used for descheduling and discarding jobs

  • Set the discarded_at timestamp when discarding jobs

v1.1.1 — 2020-02-06

Fixes

  • Fix job detail refreshing on tick events

v1.1.0 — 2020-02-06

Changes

  • Add verbose setting to control log levels. This command mirrors the behavior in Oban and is respected by all queries.

  • Deprecate stats configuration. The stats module is entirely overhauled so that it only refreshes when one or more users are connected. That prevents it from using any connections or performing any queries while testing, which renders the stats option pointless.

  • Add stats_interval to control how often node and queue counts are refreshed. The default value is every 1s.

  • Add tick_interval to control how often the jobs table and job details are refreshed. The default value is every 500ms.

v1.0.1 — 2020-01-29

Fixes

  • Display discarded_at time in detail timeline view.
  • Prevent jitter when clearing stats cache.

v1.0.0 — 2020-01-29

Changed

  • Upgrade Oban and set dependency to ~> 1.0.0
  • Update stats and the queries that power stats to rely on more frequent refreshes and fewer database calls. The average refresh time dropped from ~310ms to ~180ms.

v0.8.0 — 2020-01-23

Changed

  • Upgrade to LiveView ~> 0.5 and test with 0.6.

v0.7.0 — 2020-01-08

Added

  • Add detail modal for inspecting job arguments, errors and state timings.

v0.6.3 — 2019-12-15

Changed

  • Display duration or distance in words depending on job state. This clarifies timestamp information. Relative timestamps have an formatted absolute value as the "title" attribute as well.

  • Improved ordering for various job states. Many states were reversed, making the table view seem broken.

Fixes

  • Ensure all assigns are available on render when a disconnected node reconnects. This fixes an issue when viewing the UI in development.

v0.6.2 — 2019-12-05

Changed

  • Add support for explicitly disabling stats rather than inferring based on queue configuration. This prevents issues in production environments where certain nodes (i.e. web) aren't processing any queues, but the the UI is accessed.

    ObanWeb configuration now differs from Oban configuration and you'll need to specify it separately. Specify the repo in config.exs:

    config :my_app, ObanWeb, repo: MyApp.Repo

    Disable the stats tracker in the test environment:

    config :my_app, ObanWeb, stats: false

v0.6.1 — 2019-11-22

Fixes

  • Ignore the stats server when queues is empty.