PMDAGLUSTER(1)

💖 PMDAGLUSTER 💖

okay so bestie, welcome to the pmdagluster manual page — that's from the General Commands Manual section of the Performance Co-Pilot docs, and we're gonna get you all the way caught up. no skimming, no skipping, we're doing this properly 💅

---

✨ NAME ✨

pmdagluster — the Gluster Filesystem PMDA. that's it, that's the name, iconic.

---

🌸 DESCRIPTION 🌸

pmdagluster is a Performance Metrics Domain Agent (PMDA) — and what it does is it exports metric values about your mounted gluster filesystems, using the gluster(8) command to get them. and like, not just the local stuff: this PMDA exports metrics about volumes and bricks, both local and remote to the node where pmdagluster is running. it's giving full coverage 🫶

here's the thing though — the gluster filesystem lets you have fine-grained control over enabling statistics on individual volumes. so the values are optionally enabled or disabled on systems where you don't want them monitored. your filesystem, your rules, no cap.

you can use the pmstore(1) command to enable and disable profiling of volumes. using the individual instances of the gluster.volume.profile metric, you set their values (and the associated profiling) either on (1) or off (0). and pminfo(1) can report on the current status of profiling of each volume. so you can peek before you poke 👑

# pminfo -f gluster.volume.profile

gluster.volume.profile
    inst [0 or "gv0"] value 0
    inst [1 or "gv1"] value 1

# pmstore -i "gv0" gluster.volume.profile 1
gluster.volume.profile inst [0 or "gv0"] old value=0 new value=1

see how gv0 went from 0 to 1? that's the glow-up ✨

if you want further details on the gluster filesystem, they live at http://www.gluster.org.

---

🎀 INSTALLATION 🎀

install the gluster PMDA by using the Install script as root:

# cd $PCP_PMDAS_DIR/gluster
# ./Install

to uninstall, do the following as root:

# cd $PCP_PMDAS_DIR/gluster
# ./Remove

lowkey important: pmdagluster is launched by pmcd(1) and should never be executed directly. like, don't. the Install and Remove scripts notify pmcd(1) when the agent is installed or removed, so it already knows what's up. let the scripts do their job 🙈

---

🦋 FILES 🦋

• $PCP_PMDAS_DIR/gluster/Install — installation script for the pmdagluster agent
• $PCP_PMDAS_DIR/gluster/Remove — undo installation script for the pmdagluster agent
• $PCP_LOG_DIR/pmcd/gluster.log — default log file for error messages from pmdagluster

---

🌈 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). customise responsibly, bestie 💜

---

💫 SEE ALSO 💫

PCPIntro(1), pmcd(1), pminfo(1), pmstore(1) and gluster(8).

---

and that's the whole page!! 💖 this one comes to you from Performance Co-Pilot, in the PCP collection, and it's the PMDAGLUSTER(1) page. go monitor those volumes, you absolute icon 👑✨