PMDAUWSGI(1)

💖 PMDAUWSGI(1) — the uwsgi PMDA, bestie edition 💖

okay so real quick: this is the manual page for pmdauwsgi, a General Commands Manual situation, and I'm about to make it make sense. no cap. 🫶

---

✨ NAME ✨

pmdauwsgi — the uwsgi performance metrics domain agent, aka a PMDA. slay.

---

🌸 DESCRIPTION 🌸

So pmdauwsgi is a Performance Metrics Domain Agent (PMDA) whose whole personality is exporting performance metrics from uwsgi. iconic behavior honestly.

For context bestie: uWSGI is often used together with web servers such as Nginx, which offer direct support for uWSGI's native uwsgi protocol, all so they can serve Python web applications such as Django. it's giving ✨the pipeline✨.

pmdauwsgi reads an optional ini-style configuration file:

$PCP_SYSCONF_DIR/uwsgi/uwsgi.conf

This file has a [pmda] section, like so:

[pmda]

and inside that section you got two lil settings:

• host = (127.0.0.1) — connect uwsgi stats server on the given hostname. that's it, that's the whole vibe check.
• port = (9051) — connect to the uwsgi stats server on the given port. 🎀

---

🛠️ INSTALLATION 🛠️

This PMDA requires that uwsgi is running on the local host, with a uwsgi stats server running on TCP port 9051 (by default) and stats-http enabled. no stats-http, no metrics, that's the deal. 💀

Install the uwsgi PMDA by using the Install script as root:

# cd $PCP_PMDAS_DIR/uwsgi
# ./Install

To uninstall, do the following as root:

# cd $PCP_PMDAS_DIR/uwsgi
# ./Remove

pmdauwsgi 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 all stays in sync. ✨

---

📁 FILES 📁

• $PCP_PMDAS_DIR/uwsgi/Install — installation script for the pmdauwsgi agent 🧚
• $PCP_PMDAS_DIR/uwsgi/Remove — undo installation script for the pmdauwsgi agent (the little "jk bestie, take it back" script)
• $PCP_LOG_DIR/pmcd/uwsgi.log — default log file for error messages from pmdauwsgi. when things go wrong, this is where the tea lives 💅
• $PCP_SYSCONF_DIR/uwsgi/uwsgi.conf — optional configuration file for the pmdauwsgi agent 🌸

---

🌈 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. 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 them, bestie, they're part of the lore. 📚

---

fr fr, that's the whole page — nothing skipped, nothing invented, all the facts kept their main character energy. 🫶

this has been Performance Co-Pilot (PCP), version PMDAUWSGI(1), delivered to you fresh. mwah. 💖✨🎀🦋