koji-lag - Man Page
Quantify Koji build queue lag and per-arch build-time drag
Synopsis
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)