koji-lag - Man Page

Quantify Koji build queue lag and per-arch build-time drag

Synopsis

koji-lag [-h|--help] [-V|--version] <subcommands>

Description

Quantify Koji build queue lag and per-arch build-time drag

Options

-h,  --help

Print help

-V,  --version

Print version

Commands

koji-lag fetch

koji-lag fetch [--instance] [--hub-url] [--since] [--until] [--days] [--owner] [--package] [-i|--inventory] <-o|--output> [--page-size] [--sleep-ms] [--retries] [-v|--verbose] [-h|--help]

Sweep a Koji completion window into a local dataset

--instance <INSTANCE> [default: fedora]

Known Koji instance (cbs, fedora, stream)

--hub-url <URL>

Explicit hub URL (overrides --instance; https only)

--since <YYYY-MM-DD>

Window start date (UTC midnight, inclusive)

--until <YYYY-MM-DD>

Window end date, inclusive (default: the last complete UTC day — the running day is never included implicitly)

--days <N>

Sweep the last N complete UTC days

--owner <NAME>

Keep only builds submitted by this user

--package <NAME,...>

Keep only these source packages (CSV or repeated)

-i, --inventory <FILE>

Keep only packages from these inventory files

-o, --output <FILE>

Dataset file to create or merge into

--page-size <PAGE_SIZE> [default: 1000]

Tasks per listTasks page

--sleep-ms <SLEEP_MS> [default: 500]

Pause between hub requests, in milliseconds

--retries <RETRIES> [default: 3]

Retries per failed hub request

-v, --verbose

Print progress to stderr

-h, --help

Print help

koji-lag merge

koji-lag merge <-o|--output> [-h|--help] <FILE>

Union datasets collected independently into one

-o, --output <FILE>

Merged output file

-h, --help

Print help

<FILE>

Dataset files to union

koji-lag report

koji-lag report [--since] [--until] [--arch] [--scratch] [--official] [--include-failed] [--min-samples] [--json] [-h|--help] <FILE>

Per-arch queue-wait / build-time / bottleneck report

--since <YYYY-MM-DD>

Only tasks completing on/after this date (UTC midnight)

--until <YYYY-MM-DD>

Only tasks completing on/before this date (UTC midnight)

--arch <ARCH,...>

Restrict to these arches (CSV or repeated)

--scratch

Only scratch builds

--official

Only official (non-scratch) builds

--include-failed

Include FAILED tasks in build-time statistics

--min-samples <MIN_SAMPLES> [default: 5]

Withhold human-output stats below this sample count

--json

Output machine-readable JSON instead of tables

-h, --help

Print help

<FILE>

Dataset file(s) to report over (merged in memory)

Info

2026-08-05 sandogasa 0.19.1 Sandogasa Manual