PMDALIO(1)

📦
version 7.2.2 · 2 versions
, in arch rolling, centos-stream 10, centos-stream 9, debian trixie, fedora 43, fedora 44, ubuntu questing, ubuntu resolute, ubuntu stonking

💅 pmdalio — the Linux LIO subsystem PMDA

okay bestie, welcome to pmdalio(1), the manual page for the Linux LIO subsystem Performance Metrics Domain Agent ✨

🎀 NAME

pmdalio — Linux LIO subsystem PMDA 🦋

✨ DESCRIPTION

okay so pmdalio is a Performance Metrics Domain Agent (PMDA), and what it does is chef's kiss — it exports metric values all about the Linux I/O target subsystem, which is the thing that brings you protocols like iSCSI, FCP, and FCoE. The whole vibe of those protocols is letting storage that lives on one host get exported and then consumed by other hosts using industry standard protocols. sharing is caring, no cap 💖

This PMDA exports summary metrics, which are performance value aggregations plus configuration, per LIO target instance. And on top of that? it also gives you per LUN performance metrics, including IOPS, and READ and WRITE throughput. literally the full picture, we love to see it 🔥

The LIO configuration is maintained inside the kernel's configfs virtual filesystem. The python-rtslib module provides an interface to configfs, which is what lets tools like pmdalio interact with the settings and metadata held in configfs. iconic teamwork honestly 👑

🌸 INSTALLATION

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

# cd $PCP_PMDAS_DIR/lio
# ./Install

To uninstall, do the following as root:

# cd $PCP_PMDAS_DIR/lio
# ./Remove
bestie listen: pmdalio is launched by pmcd(1) and should never be executed directly. like, never ever. 🙈

The Install and Remove scripts notify pmcd(1) when the agent is installed or removed, so everybody stays in the loop 🫶

🦋 FILES

  • $PCP_PMDAS_DIR/lio/Install — installation script for the pmdalio agent ✨
  • $PCP_PMDAS_DIR/lio/Remove — undo installation script for the pmdalio agent 🎀
  • $PCP_LOG_DIR/pmcd/lio.log — default log file for error messages from pmdalio 📓

💜 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). slay, configurable 💅

🌈 SEE ALSO

PCPIntro(1), pmcd(1), pminfo(1) and pmpython(1). go read those too, iykyk 💖

that's the whole page bestie! this one comes to you from Performance Co-Pilot, PCP edition — pmdalio(1), periodt. 🎀✨🦋

📦 where this page comes from