How-to

Read job forensics

Open a completed job's detail page and read its verification evidence. The example shows a completed encode whose correctness report covers eleven verifiers.

This article shows where the evidence lives. For what each verifier establishes and how to interpret a pass, a skip and a fail, see Correctness & QC.

Open the job detail#

From the Queue, click a job's row. The detail page at /jobs/<job-id> opens with the progress hero — job id, status, preset, source path, the completion percentage with rate readouts, and the action buttons — above the tab bar, with the assigned workers and the spec in the right rail.

A completed job's detail page showing the progress hero at 100.0% with FPS, bitrate, speed and ETA readouts, the tab bar with the Chunks tab active over a four-chunk map, and the right rail listing the assigned worker and the spec
The job detail page. The tab bar carries Chunks, Workers, Logs, Spec, Forensics and Localization.

The detail tabs#

TabContains
ChunksThe chunk map and per-chunk state.
WorkersWhich machines encoded this job.
LogsThe job's event stream.
SpecThe effective encode specification, with any per-job overrides tagged.
ForensicsThe Correctness, QC, Lineage and Chunk-argv panels.
LocalizationPer-territory conformance evidence, for localization jobs.

Read the Forensics tab#

Click Forensics. The tab carries four panels: Correctness lists each verifier with its outcome and the measured values it recorded — not only a pass mark; QC holds the loudness and true-peak report; Lineage records source fixity and a source-versus-output metadata comparison, and states when no comparison is available; Chunk argv shows the exact FFmpeg command each chunk ran, with a copy-to-clipboard action per command.

The Forensics tab showing the correctness report: eleven verifiers with an overall pass, measured PSNR, SSIM and VMAF minimums against their thresholds, packet and sample counts, and skipped captions-survival and codec-conformance checks with their reasons
The correctness report records measured values, not only outcomes. A skipped verifier states its reason.

In the example, the metrics row records the measured floors — PSNR 44.44 against a threshold of 38, SSIM 0.9988 against 0.95, VMAF 96.45 against 90 — the timing audit records the 900 packets it walked, and the audio verifiers record expected versus actual sample totals. The two skipped rows state why they could not run: no captions were detected in the source, and the preset carries no codec-conformance specification.

Interpreting results#

  • Passed — the verifier ran and was satisfied. The values shown are the evidence.
  • Skipped — the verifier could not run, with the reason stated. Not a failure and not a pass: no evidence either way.
  • Failed — the verifier ran and was not satisfied. On a completed job this is information to weigh before shipping, because correctness verifiers report rather than gate.
Note

To package this evidence for support, run master support-bundle --job <ID> on the master. It works even when the console does not. See the CLI reference.

Event drawer detail#

The same evidence surfaces as events. Selecting an entry in the activity feed opens a drawer rendered for that event type — job, chunk, worker, correctness, QC, localization, MAM, watch-folder and Flow events each render as a readable account with the relevant measured values, not a raw payload. A correctness or QC event opens directly to the figures the verifier recorded.

Use the Forensics tab when the question is about one job; use the event drawer when the question is about when something happened, or about events that belong to no single job — a worker approval, a watch-folder pickup, a Flow write-back.