RQINFO(1)

💖 RQINFO(1) 💖

okay bestie, so you found the manual page for rqinfo — it lives in the General Commands Manual section (that's section 1, the user-commands girlies), and it is, no exaggeration, the cutest little window into your RQ world. Pull up a chair. 🫶

---

✨ NAME ✨

rqinfo — command line monitor for RQ. that's it. that's the whole job. and she EATS. 💅

---

🌈 SYNOPSIS 🌈

rqinfo [OPTIONS] [QUEUES]...

yes bestie, options first, then a whole little list of queues, plural, as many as your heart desires. [QUEUES]... — the three dots are doing the heavy lifting, they mean "keep going, give me more, I can take it." 🦋

---

🌸 DESCRIPTION 🌸

So. RQ is a command-line monitor for rq. Yes I know that sounds like it just said its own name twice, that's literally what the page says and we do NOT fact-check the source material in this house. 😭

It's part of the python-rq module package. So it ships with your RQ install, it's not some random third-party thing you have to go hunt down. She's built in. She's family. 💖

---

🎀 OPTIONS 🎀

okay this is the part you actually came for, and there are a LOT of them, so let's go one by one, no skipping, we don't do that here:

• -i, --interval FLOAT — updates stats every N seconds. the default is to NOT poll at all, so if you want that live refresh-y glow-up you gotta ask for it. say the number. she'll keep refreshing. ⏰
• -r, --raw — print only the raw numbers, no bar charts. just the digits, stripped down, no aesthetic, pure data. minimalism era. 🍓
• -Q, --only-queues — show only queue info. queues only. nothing else invited to the party. 👑
• -W, --only-workers — show only worker info. the worker girlies get the whole stage, queues can wait outside. 🧚
• -R, --by-queue — shows workers by queue. so instead of one big pile of workers, they're grouped by which queue they're serving. organised. structured. lowkey obsessed. 🦋
• -S, --serializer TEXT — path to serializer. defaults to rq.serializers.DefaultSerializer if you don't say otherwise. that default is doing a lot of unpaid labour tbh. ✨
• -P, --path TEXT — specify the import path. point her at where your stuff lives. 📍
• --connection-class TEXT — Redis client class to use. yes, the long form only, no short flag, she's mysterious like that. 💀
• --queue-class TEXT — RQ Queue class to use. again, long form only. main character energy, refuses a nickname. 👑
• -j, --job-class TEXT — RQ Job class to use. this one DOES have a short flag, she's approachable. 💜
• -w, --worker-class TEXT — RQ Worker class to use. yes -w here is worker-class and -W is only-workers. case matters bestie, do not mix those up, I am begging. 😭
• -c, --config TEXT — module containing RQ settings. your config module, hand it over. 📦
• -u, --url TEXT — URL describing Redis connection details. how to reach your Redis. very important. do not lose her. 🔥
• --help — show this message and exit. the universal escape hatch, always there for you. 🙈

heads up bestie: -w and -W are DIFFERENT OPTIONS. one takes a Worker class, one shows only workers. this is exactly the kind of thing that ruins your whole afternoon. 😭

---

💜 SEE ALSO 💜

• rq(1) — the main character herself.
• rqworker(1) — the worker manual, go read it, she's important too.
• Full rq documentation — the long-form version when the man page just isn't giving enough. iykyk.

---

and that's the whole page!! this one came out of the User Commands section of the RQINFO(1) manual, so if you're citing her, that's the source and the section. no date listed on this one, she's timeless, she's above calendars. ✨

okay ily, go monitor your queues, you're gonna slay. periodt. 💅🎀🦋