pgbus 0.19.4 → 0.20.1

data/config/locales/en.yml

@@ -140,6 +140,11 @@ en:
         throughput: Throughput
         throughput_detail: jobs/min over the last %{minutes} min
         throughput_unavailable: needs job stats (rails g pgbus:add_job_stats)
+        workflows: Workflows
+        workflows_attention:
+          one: "%{count} needs attention"
+          other: "%{count} need attention"
+        workflows_detail: ongoing (%{paused} paused)
       verdict:
         links:
           dlq: Dead letters
@@ -723,6 +728,7 @@ en:
         processes: Processes
         queues: Queues
         recurring: Recurring
+        workflows: Workflows
       return_to_app: Back to app
       title: Pgbus Dashboard
       toggle_dark_mode: Toggle dark mode
@@ -1023,3 +1029,442 @@ en:
         disabled: Task disabled
         enabled: Task enabled
         failed: Failed to toggle task
+    workflow_insights:
+      back_to_classes: All workflow classes
+      back_to_runs: All workflow runs
+      bad_request: 'Bad request: %{reason}'
+      capped: 'Capped at workflow_retention (%{retention}): finished and cancelled runs older than that are deleted.'
+      few_samples:
+        one: n=%{count}, few samples
+        other: n=%{count}, few samples
+      index:
+        description: 'How each workflow class did over %{window}: the runs going on now, the runs that ended, and how long a run takes end to end.'
+        empty_hint: 'Define a Pgbus::Workflow subclass and start a run: YourWorkflow.start!(subject, **arguments).'
+        empty_title: No workflow class has run yet.
+        headers:
+          attention: Need attention
+          cancelled: Cancelled
+          duration_p50: Duration p50
+          duration_p95: Duration p95
+          finished: Finished
+          ongoing: Ongoing
+          paused: Paused
+          workflow_class: Workflow class
+        title: Workflow insights
+      links:
+        at_step: "%{status} runs at %{step}"
+        attention: runs of %{workflow} that need attention
+        cancelled: runs of %{workflow} cancelled in the window
+        cancelled_bucket: runs cancelled in this period
+        finished: runs of %{workflow} that finished in the window
+        finished_bucket: runs finished in this period
+        ongoing: ongoing runs of %{workflow}
+        paused: paused runs of %{workflow}
+        started: runs of %{workflow} started in the window
+        started_bucket: runs started in this period
+      not_found:
+        hint: No Pgbus::Workflow subclass and no run is called %{workflow} (or reading it failed, see the log).
+        title: Unknown workflow class
+      not_loaded: Definition not loaded
+      not_loaded_hint: 'This class does not load in this app any more: its steps come from its runs'' rows, in the order the runs reached them.'
+      percentile: "%{name} %{value}"
+      removed_in_flight:
+        one: "%{count} run on removed step %{step}"
+        other: "%{count} runs on removed step %{step}"
+      show:
+        by_revision:
+          all_steps: All steps
+          caption: 'The same numbers for the last five app revisions that finished an attempt in the window, newest first: a regression after a deploy shows as a row.'
+          empty: No attempt in this window recorded an app revision (config.app_revision).
+          headers:
+            attempts: Attempts
+            failed: Failed
+            reattempted: Reattempted
+            revision: Revision
+            run_time: Run time
+            skipped: Skipped
+            step: Step
+          seen_html: seen %{from} to %{to}
+          title: By app revision
+          worse: up from %{rate} on %{revision}
+        charts:
+          durations:
+            between: "%{from}–%{to}"
+            caption:
+              one: How long the %{count} run that finished in the window took, from start to finish.
+              other: How long the %{count} runs that finished in the window took, from start to finish.
+            headers:
+              range: Duration
+              runs: Runs
+            over: "%{from} or more"
+            title: End-to-end duration
+            under: under %{to}
+          series:
+            cancelled: Cancelled
+            finished: Finished
+            runs: Runs
+            started: Started
+          throughput:
+            caption: 'Runs started, finished and cancelled per %{bucket} over %{window}: %{started} started, %{finished} finished, %{cancelled} cancelled.'
+            headers:
+              cancelled: Cancelled
+              finished: Finished
+              from: From
+              started: Started
+            title: Runs per %{bucket}
+        description: 'Over %{window}: where its runs are now, how each step performs, and where runs stop.'
+        funnel:
+          caption:
+            one: 'Of the %{count} run started in the window: how many reached each step, and where it is now.'
+            other: 'Of the %{count} runs started in the window: how many reached each step, and where each one is now.'
+          empty: No run started in this window.
+          headers:
+            now_here: Now at this step
+            reached: Reached
+            share: Of started
+            step: Step
+          here:
+            cancelled:
+              one: "%{count} cancelled"
+              other: "%{count} cancelled"
+            finished:
+              one: "%{count} finished"
+              other: "%{count} finished"
+            paused:
+              one: "%{count} paused"
+              other: "%{count} paused"
+            performing:
+              one: "%{count} running"
+              other: "%{count} running"
+            ready:
+              one: "%{count} scheduled"
+              other: "%{count} scheduled"
+            waiting:
+              one: "%{count} waiting"
+              other: "%{count} waiting"
+          title: Funnel
+        pipeline:
+          attempts:
+            one: "%{count} attempt"
+            other: "%{count} attempts"
+          caption: 'Each step in order: the runs sitting at it now, and how its attempts that finished in the window did.'
+          empty: 'No step yet: no run of this class has a step in the window and none is going on.'
+          failed: Failed
+          kinds:
+            fan_out: Fan-out
+            removed: Removed
+            signal: Waits for a signal
+            undeclared: Not in the definition
+          live:
+            paused: Paused
+            performing: Running
+            ready: Scheduled
+            waiting: Waiting
+          now_label: Runs at this step now
+          pickup: Pickup
+          reattempted: Reattempted
+          run_time: Run time
+          skipped: Skipped
+          step_link: Ongoing runs at %{step}
+          title: Pipeline
+          window_label: Attempts that finished in the window
+        summary:
+          attention: Need attention
+          cancelled: Cancelled
+          duration: Duration p50
+          finished: Finished
+          ongoing: Ongoing
+          started: Started
+      window_label: Time window
+      windows:
+        1h: the last hour
+        24h: the last 24 hours
+        30d: the last 30 days
+        7d: the last 7 days
+    workflows:
+      actions:
+        bulk_cancel: Cancel all
+        bulk_resume: Resume all
+        cancel: Cancel
+        rerun: Rerun
+        resume: Resume
+        resume_at: Resume at step
+        run_now: Run now
+        signal: Send signal
+        skip_step: Skip step
+      attempt: attempt %{attempt}
+      attention:
+        at_step_html: at %{step}
+        back: "← Workflows"
+        cancel_all:
+          one: Cancel all %{count}
+          other: Cancel all %{count}
+        confirm:
+          cancel:
+            one: Cancel the run stuck at %{step}?
+            other: Cancel all %{count} runs stuck at %{step}?
+          cancel_error:
+            one: Cancel the run stuck at %{step} on %{error}?
+            other: Cancel all %{count} runs stuck at %{step} on %{error}?
+          resume:
+            one: Resume the run paused at %{step}?
+            other: Resume all %{count} runs paused at %{step}?
+          resume_error:
+            one: Resume the run paused at %{step} on %{error}?
+            other: Resume all %{count} runs paused at %{step} on %{error}?
+        description: Ongoing runs that wait on a person, grouped by what stopped them. Once the cause is fixed, act on the whole group.
+        empty_hint: No ongoing run is paused, stalled, overdue or waiting past workflow_waiting_visibility_threshold.
+        empty_title: Nothing needs attention.
+        first_seen_html: first %{time}
+        headers:
+          actions: Actions
+          reason: Reason
+          runs: Runs
+          seen: Seen
+          workflow: Workflow
+        last_seen_html: last %{time}
+        only_class_html: "%{workflow} only."
+        reasons:
+          overdue: 'Overdue: due, but not picked up'
+          paused_error: Paused on an error
+          paused_manual: Paused by hand
+          stalled: 'Stalled: its worker stopped responding'
+          waiting_overdue: Waiting too long
+        resume_all:
+          one: Resume all %{count}
+          other: Resume all %{count}
+        show_all: Show every class
+        show_runs: Show runs
+        title: Needs attention
+      audit:
+        by: "%{event} by %{actor}"
+        empty: No events recorded.
+        headers:
+          what: What happened
+          when: When
+        title: Audit trail
+        with_reason: "%{sentence}: %{reason}"
+        with_step: "%{sentence} (%{step} #%{attempt})"
+      bad_request: 'Bad request: %{reason}'
+      confirm:
+        cancel: Cancel this workflow? Its open steps are cancelled and it does not run again.
+        rerun: Start this workflow again as a new run, with the same subject and arguments?
+        resume: Resume this workflow?
+        resume_at: Resume this workflow at the chosen step? Its open steps are cancelled first.
+        run_now: Run the scheduled step now instead of waiting?
+        signal: Send this signal to the workflow?
+        skip_step: Skip the step this workflow waits on and move to the next one?
+      events:
+        cancelled: Cancelled
+        fan_out_finished: Fan-out finished
+        fan_out_opened: Fan-out opened
+        finished: Finished
+        late_completion_ignored: Late completion ignored
+        paused: Paused
+        rerun: Rerun
+        rescheduled: Rescheduled
+        resumed: Resumed
+        run_now: Run now
+        signal_claimed: Signal claimed
+        signal_received: Signal received
+        stall_detected: Stall detected
+        started: Started
+        step_completed: Step completed
+        step_failed: Step failed
+        step_reattempted: Step reattempted
+        step_scheduled: Step scheduled
+        step_skipped: Step skipped
+        step_started: Step started
+        step_waiting: Step waiting
+        wait_timed_out: Wait timed out
+      filters:
+        apply: Apply filters
+        clear: Clear
+        created_from: Created from
+        created_to: Created to
+        ended_from: Ended from
+        ended_to: Ended to
+        error_class: Error class
+        step: Current step
+        subject_id: Subject ID
+        subject_type: Subject type
+        workflow_class: Workflow class
+        workflow_id: Workflow ID
+      flash:
+        bad_group: That group is not valid.
+        bulk_cancel:
+          one: Cancelled %{count}.
+          other: Cancelled %{count}.
+        bulk_cancel_skipped: Cancelled %{count}; %{skipped} had already moved on.
+        bulk_failed: "%{count} could not be changed: %{reason}"
+        bulk_more: 'More runs may be waiting: press again for the next %{cap}.'
+        bulk_resume:
+          one: Resumed %{count}.
+          other: Resumed %{count}.
+        bulk_resume_skipped: Resumed %{count}; %{skipped} had already moved on.
+        cancel: Workflow cancelled.
+        choose_step: Choose a step to resume at.
+        failed:
+          not_allowed: 'Not done: the run is %{status} now.'
+          not_found: That workflow no longer exists.
+          other: "%{action} failed: %{reason}"
+        payload_not_object: 'Not sent: the payload is not a JSON object.'
+        payload_too_large: 'Not sent: the payload is over %{limit} bytes.'
+        rerun: Started a new run.
+        resume: Workflow resumed.
+        resume_at: Workflow resumed at %{step}.
+        run_now: The scheduled step runs now.
+        signal: Signal %{name} sent.
+        signal_duplicate: Signal %{name} was already delivered with this key; nothing new was sent.
+        signal_name_missing: 'Not sent: the signal needs a name.'
+        skip_step: Step skipped.
+      headers:
+        current_step: Current step
+        last_activity: Last activity
+        started: Started
+        status: Status
+        subject: Subject
+        workflow: Workflow
+      index:
+        attention_link:
+          one: Needs attention (%{count})
+          other: Needs attention (%{count})
+        description: 'Durable multi-step runs: what each one is doing and what happens next.'
+        empty_hint: Pick another status or clear the filters. A run starts with YourWorkflow.start!(subject, **arguments).
+        empty_title: No workflows match.
+        insights_link: Insights by class
+        status_label: Filter by status
+        title: Workflows
+      next:
+        cancelled_html: Cancelled %{ago}.
+        due_html: 'Ready: %{step} was due %{ago} and waits for a worker.'
+        finished_html: Finished %{ago}.
+        overdue_html: 'Overdue: %{step} was due %{ago}; the sweep sends it again.'
+        paused_error_html: 'Paused on %{step}: %{error} — resume or cancel.'
+        paused_manual_html: Paused on %{step} — resume or cancel.
+        performing_attempt_html: Performing %{step} (attempt %{attempt}).
+        performing_html: Performing %{step}.
+        ready_html: 'Ready: %{step} runs next.'
+        scheduled_html: 'Scheduled: %{step} runs %{time}.'
+        unknown_html: 'Status: %{status}.'
+        waiting_batch_html: Waiting for batch %{batch} (%{done} of %{total} jobs done).
+        waiting_signal_html: Waiting for signal %{signal} since %{ago}.
+        waiting_signal_late_html: Waiting for signal %{signal} since %{ago} (late since %{late}). The next late notice goes out %{time}.
+        waiting_signal_notify_html: Waiting for signal %{signal} since %{ago}. A late notice goes out %{time}, and the wait goes on.
+        waiting_signal_timeout_html: Waiting for signal %{signal} since %{ago}. The wait times out %{time}.
+        waiting_step_html: Waiting on %{step}.
+      not_found:
+        hint: It may have finished and been removed after workflow_retention, or the database could not be read (see the log).
+        title: Workflow not found
+      outcomes:
+        cancelled: cancelled
+        completed: completed
+        finished_early: finished the run early
+        paused: paused the run
+        reattempted: reattempted
+        skipped: skipped
+      resume:
+        carry_on: 'Resume: carry on with %{step}'
+        continue: 'Resume: continue with %{step}'
+        finish: 'Resume: finish the run'
+        resend: 'Resume: send %{step} again'
+        retry: 'Resume: retry %{step}'
+        rewait: 'Resume: wait again on %{step}'
+      show:
+        actions: Actions
+        arguments: Arguments
+        back: "← Workflows"
+        cancelled_at: Cancelled
+        class_missing: "%{workflow_class} is not loaded in this process: the run can still be cancelled, but not resumed."
+        definition_outdated: 'This run started on an older definition of %{workflow_class}: its steps have changed since it started.'
+        details: Details
+        finished_at: Finished
+        no_arguments: This run has no arguments.
+        paused_at: Paused
+        reason_hint: Recorded on the audit trail, next to who did it.
+        reason_label: Reason (optional)
+        rerun_of: Rerun of
+        reruns: Rerun as
+        resume_at_label: Step to resume at
+      signal:
+        hint: A step waiting for it wakes at once; otherwise it waits, pending, until a step takes it.
+        name: Signal name
+        payload: Payload (JSON)
+        send: Send signal
+        title: Send a signal
+      signal_statuses:
+        claimed: Claimed
+        consumed: Consumed
+        pending: Pending
+      signals:
+        empty: No signals delivered to this run.
+        headers:
+          claimed: Claimed
+          consumed: Consumed
+          idempotency_key: Idempotency key
+          name: Signal
+          received: Received
+          status: Status
+        payload: Payload
+        title: Signals
+      statuses:
+        cancelled: Cancelled
+        finished: Finished
+        gone: gone
+        paused: Paused
+        performing: Performing
+        ready: Ready
+        scheduled: Scheduled
+        waiting: Waiting
+      step_statuses:
+        cancelled: Cancelled
+        completed: Completed
+        failed: Failed
+        in_progress: Running
+        scheduled: Scheduled
+        skipped: Skipped
+        waiting: Waiting
+      steps:
+        batch: batch %{batch}
+        caused_by: Caused by %{error}
+        empty: No attempts yet.
+        headers:
+          finished: Finished
+          queued: Queued
+          ran: Ran
+          scheduled: Scheduled
+          started: Started
+          status: Status
+          step: Step
+          waited: Waited
+          worker: Worker
+        revision: revision %{revision}
+        show_backtrace: Show backtrace
+        title: Attempts
+        waiting_for: then waiting %{duration}
+        waits_for_html: waits for %{signal}
+      tabs:
+        all: All
+        cancelled: Cancelled
+        finished: Finished
+        ongoing: Ongoing
+        paused: Paused
+        performing: Performing
+        ready: Ready
+        waiting: Waiting
+      timeline:
+        caption: 'Each attempt, oldest at the top: waited (its wait), queued (due, not yet picked up), ran (coloured by how it ended) and waiting (for a signal or its batch), with the pauses on their own row. The attempts table below lists the same durations. A dashed line marks each time a wait passed its deadline.'
+        empty: No attempts yet.
+        paused_period_html: Paused at %{from} for %{duration}
+        paused_row: Paused
+        series:
+          paused: Paused
+          queued: Queued
+          ran_cancelled: Ran, cancelled
+          ran_failed: Ran, failed
+          ran_ok: Ran
+          ran_open: Running
+          waited: Waited
+          waiting: Waiting
+        title: Timeline
+        wait_timeout_html: "%{step}'s wait passed its deadline at %{time} (on_timeout: %{action})."