PMDANUTCRACKER(1)

💅 PMDANUTCRACKER(1) — bestie edition 💅

okay so. this is a page from the General Commands Manual, and it's all about pmdanutcracker, a NutCracker performance metrics domain agent (aka a PMDA). buckle up, it's actually not that long 🎀

---

✨ NAME ✨

pmdanutcracker — the NutCracker performance metrics domain agent, aka a PMDA 💖

---

🦋 DESCRIPTION 🦋

so this PMDA literally pulls performance data out of NutCracker (you might also know it as TwemProxy), which is a fast and lightweight proxy for the memcached and Redis protocol. it's giving middle-manager-but-make-it-speedy ✨

---

🎀 INSTALLATION 🎀

first things first, bestie: you gotta set NutCracker up so it exports its statistics through its stats interface — that's the --stats-port option on the nutcracker server, iykyk. and then you gotta mirror that config over in the $PCP_PMDAS_DIR/nutcracker/nutcracker.conf file, or none of this works 🙈

# cd $PCP_PMDAS_DIR/nutcracker
# [ edit nutcracker.conf ]

once that's all set up, you can go peek at the names and values for the nutcracker performance metrics by doing this as root 👑

# cd $PCP_PMDAS_DIR/nutcracker
# ./Install

and when you're done and you wanna uninstall? also as root:

# cd $PCP_PMDAS_DIR/nutcracker
# ./Remove

lowkey important: pmdanutcracker gets launched by pmcd(1) and should never be executed directly, okay? don't do it. the Install and Remove scripts are the ones that notify pmcd(1) when the agent gets installed or removed, so let them do their job 💅

---

🌸 FILES 🌸

• $PCP_PMDAS_DIR/nutcracker/nutcracker.conf — the mandatory configuration file, listing the memcache or Redis instances being monitored. mandatory means mandatory fr fr 💀
• $PCP_PMDAS_DIR/nutcracker/Install — the installation script for the pmdanutcracker agent 🫶
• $PCP_PMDAS_DIR/nutcracker/Remove — the undo-installation script for the pmdanutcracker agent, the reverse uno card 🌈
• $PCP_LOG_DIR/pmcd/nutcracker.log — the default log file where pmdanutcracker drops its error messages 📝

---

🧚 PCP ENVIRONMENT 🧚

environment variables with the PCP_ prefix are what parameterize all the file and directory names PCP uses — main character energy for config, honestly ✨

on every installation, the file /etc/pcp.conf holds the local values for these variables. and if you wanna point at a different configuration file, the $PCP_CONF variable is your girl — it's described over in pcp.conf(5) 📖

---

👑 SEE ALSO 👑

PCPIntro(1), pmcd(1), pmdamemcache(1) and pmdaredis(1) — go read those too, they're iconic ⭐

---

and that's the whole vibe, bestie 🎀 this page came to you from Performance Co-Pilot, version PCP, and it's the PMDANUTCRACKER(1) page from the General Commands Manual. slay, go monitor some proxies 💖✨🦋