BKR-SYSTEM-HISTORY-LIST(1)

📦
version 29.2 · 3 versions
, in epel 9

💖 bkr-system-history-list(1) — the Beaker girlie's guide 💖

okay so real quick: this is a page from the Beaker manual (section 1 ofc), and it's literally just about dumping the activity history of a system as JSON. no cap, that's the whole vibe. let's get into it 🫶

✨ NAME ✨

bkr-system-history-list — export history of activity for the given system

like, you point it at a system and it gives you the receipts of everything that's happened to it. main character energy for your machines tbh 👑

🌸 SYNOPSIS 🌸

bkr system-history-list [options] <fqdn>
  [--pretty]
  [--since <date>]

see how <fqdn> is chillin' there all by itself? yeah, that one's required, bestie. the options are optional (iconic behaviour). 💅

🦋 DESCRIPTION 🦋

JSON history of activity for a given system is printed to stdout. that's it, that's the whole thing — it goes straight to your terminal, no files, no drama. 🎀

New in version 27. — so if you're on something ancient, sorry babe 😭

💜 OPTIONS 💜

  • --since <date> — pass this and you get all the history entries between that timestamp and, like, right now. if you don't pass it, the default is the past 24 hours (yes, just a day, don't come for me). the date has to be in UTC format YYYY-MM-DD fr fr, so format it right or it's giving chaos. 🗓️
  • --pretty — pretty-prints the results in JSON, with indentation and line breaks, suitable for human consumption. i.e. actually readable by a human eyeball instead of one giant cursed line of text. lowkey essential ngl 🙈

also, the common bkr options are described in the Options section of bkr(1) — go skim that if you're nosy (respectfully). 🔍

😭 EXIT STATUS 😭

Non-zero on error, otherwise zero. so: zero = slay, non-zero = something went sideways. simple as that. 💀

🌈 EXAMPLES 🌈

display history of a system in JSON format from the past 24 hours:

bkr system-history-list system1.example.invalid

display history of a system in JSON format started from 2019-06-25:

bkr system-history-list system1.example.invalid --since 2019-06-25

see? no --since, last 24h. with --since, from that date onward. ate. 🔥

⭐ SEE ALSO ⭐

  • bkr(1) — the mothership, go read it 🧚

🍓 AUTHOR 🍓

The Beaker team <beaker-devel@lists.fedorahosted.org> — absolute legends, we stan 💖

2013-2025 Red Hat, Inc.

okay bye bestie, hope your history is juicy and your JSON is pretty 💅✨

this was version 29.2, dated May 26, 2025 — catch you on the next page, mwah 🫶🎀

📦 where this page comes from