PMDARDS(1)

💖 PMDARDS(1) 💖

okay bestie, gather round — this is the manual page for pmdards from the General Commands Manual section of Performance Co-Pilot (PCP). It's short, it's sweet, it's giving utility player, and we're gonna go through every single crumb of it together. no skipping. periodt. ✨

---

🌸 NAME 🌸

pmdards — the Performance Metrics Domain Agent (PMDA) for RDS. that's the whole name section, she's concise, she's confident, we love her. 💅

---

🦋 DESCRIPTION 🦋

So. The RDS PMDA is a Performance Co-Pilot (PCP) module, and what it does is collect and export performance statistics for Reliable Datagram Sockets (RDS). that's it. that's the job. it watches your RDS stuff and hands the numbers over to PCP so you can look at them. no cap, that's literally the entire description and honestly? iconic of her to be so direct. 👑

---

🎀 INSTALLATION 🎀

Wanna get this baby up and running? follow these steps, in order, don't freestyle:

# cd $PCP_PMDAS_DIR/rds
# ./Install

then, to verify that the PMDA is actually running (vibe check time 💫):

$ pminfo -t rds

if it answers you, she's alive. if she doesn't… we don't talk about that. 😭

---

✨ USAGE ✨

To query RDS metrics, hit her with:

$ pminfo rds

and if you want to retrieve specific metric values — like, actually pull a number out of the air — it's:

$ pmval rds.packet.tx.send_queued

go off, rds.packet.tx.send_queued. main character metric energy fr fr. 🔥

---

💜 FILES 💜

here's the little family of files this PMDA rolls with:

• $PCP_PMDAS_DIR/rds/Install — the installation script for the RDS PMDA. she's the one who does the setup. 🫶
• $PCP_PMDAS_DIR/rds/Remove — the uninstallation script. for when you need to say goodbye (sad, but sometimes necessary). 🙈
• $PCP_LOG_DIR/pmcd/rds.log — the log file for Rocestat PMDA events and errors. this is where the drama gets written down. check her when things are weird. 💀

---

🌈 PCP ENVIRONMENT 🌈

okay so, environment variables with the prefix PCP_ are used to parameterize the file and directory names that PCP uses. on each installation, the file /etc/pcp.conf contains the local values for these variables. 🗂️

and — plot twist — the $PCP_CONF variable may be used to specify an alternative configuration file, as described in pcp.conf(5). so if you wanna point her somewhere else, you can. you have options, bestie. 💅

---

👑 SEE ALSO 👑

go read these too, they're the extended universe:

• PCPIntro(1)
• pmcd(1)
• pminfo(1)
• PMDA(3)

---

and that's the whole page, no notes, ate and left no crumbs. 🍓

this little love letter to you came courtesy of Performance Co-Pilot, version PCP — so like, go install it, run it, obsess over it. mwah. 💖✨🎀