PMDAACTIVEMQ(1)

💖 PMDAACTIVEMQ 💖

okay so bestie, gather round, because we're reading a General Commands Manual page for pmdaactivemq and it's lowkey iconic ✨

---

🌸 NAME 🌸

pmdaactivemq — the ActiveMQ performance metrics domain agent, aka a PMDA 🐝

---

✨ DESCRIPTION ✨

pmdaactivemq is a Performance Metrics Domain Agent (PMDA), and what that means is: it's the little guy whose whole job is exporting performance metrics from ActiveMQ. that's it. that's the gig. metrics out, vibes in 💅

---

🎀 INSTALLATION 🎀

so before any of this works, this PMDA needs ActiveMQ to be installed with the Jolokia JMX-HTTP bridge enabled. no Jolokia, no metrics, periodt.

by default the PMDA will connect to localhost at port 8161, with a username and password of admin. yes, admin/admin, iconic insecure behavior but that's the default fr fr. if you wanna change any of that, it's configurable in PCP_PMDAS_DIR/activemq/activemq.conf 🫶

install the ActiveMQ PMDA by running the Install script as root:

# cd $PCP_PMDAS_DIR/activemq
# ./Install

and to uninstall, do this as root:

# cd $PCP_PMDAS_DIR/activemq
# ./Remove

heads up bestie: pmdaactivemq is launched by pmcd(1) and should never be executed directly. like, never ever. 🙈 the Install and Remove scripts are the ones that notify pmcd(1) when the agent is installed or removed, so let them do their thing.

---

🦋 FILES 🦋

• $PCP_PMDAS_DIR/activemq/activemq.conf — the optional configuration file for pmdaactivemq (this is where you customize stuff)
• $PCP_PMDAS_DIR/activemq/Install — the installation script for the pmdaactivemq agent
• $PCP_PMDAS_DIR/activemq/Remove — the undo installation script for the pmdaactivemq agent
• $PCP_LOG_DIR/pmcd/activemq.log — the default log file for error messages from pmdaactivemq (when things go wrong, look here 👀)

---

🌈 PCP ENVIRONMENT 🌈

environment variables with the prefix PCP_ are used to parameterize the file and directory names used by PCP. on each installation, the file /etc/pcp.conf contains the local values for these variables. and the $PCP_CONF variable may be used to specify an alternative configuration file, as described in pcp.conf(5). iykyk 💜

---

👑 SEE ALSO 👑

PCPIntro(1) and pmcd(1). go read those next, bestie, they're part of the lore 📚

---

and that's the whole page!! 💖 this was Performance Co-Pilot, PCP, PMDAACTIVEMQ(1) — thanks for reading, mwah 🫶✨