rt-email-dashboards(8)

💌 rt-email-dashboards(8) — Request Tracker Reference 🎀

okay bestie, gather round, because this is the little script that emails people their dashboards and honestly? it's giving ✨unsung hero✨. it lives in the Request Tracker reference, it's a perl v5.38.2 situation, and it's about to become your whole personality.

---

✨ NAME ✨

rt-email-dashboards — send email dashboards 🦋

---

🌸 SYNOPSIS 🌸

rt-email-dashboards [options]

---

💖 DESCRIPTION 💖

so. this tool sends users email based on how they've subscribed to dashboards. a dashboard is a set of saved searches, and the subscription controls how often that dashboard gets sent and how it's displayed. no cap, that's the whole vibe. 📬

every subscription has an hour, and possibly a day of week or day of month. those are taken to be in the user's timezone if it's available, and in UTC otherwise. that's the rule, periodt. ⏰

---

🧚 SETUP 🧚

you're gonna need to have cron run this script every hour. here's an example crontab entry to do exactly that:

0 * * * * /usr/sbin/rt-email-dashboards

this runs the script every hour on the hour. 💅

heads up: this may need some further tweaking to be run as the correct user. don't skip that part bestie, i'm begging. 🙈

---

👑 OPTIONS 👑

this tool supports a few options. most of them are for debugging, which is honestly so real of them.

• -h, --help — display this documentation 📖
• --dryrun — figure out which dashboards would be sent, but don't actually generate or email any of them. it's the "imagine the email" option, iconic. 👀
• --time SECONDS — instead of using the current time to figure out which dashboards should be sent, use SECONDS (usually since midnight Jan 1st, 1970, so 1192216018 would be Oct 12 19:06:58 GMT 2007). time travel but make it epoch 🕰️
• --epoch SECONDS — back-compat for --time SECONDS. it's the same thing wearing a vintage jacket. 🧥
• --all — ignore subscription frequency when considering each dashboard. 🚨 should only be used with --dryrun for testing and debugging, so like, do not run this loose in production, i am on my knees. 🚨
• --user User NAME or ID — only check the specified user's subscriptions. one user, one vibe check. 🔍
• --log LEVEL — adjust LogToSTDERR config option. turn the volume knob on the logs, as a treat. 🔊

---

🌈 SEE ALSO 🌈

no extra references here, bestie — this page is self-contained and thriving. 💜

---

and that's the whole thing! 🫶 this page is from Request Tracker Reference, rt-email-dashboards(8), generated with perl v5.38.2 on 2023-10-29. slay, stay hydrated, and please actually set up your cron job. 💖✨🎀