PMDASAMBA(1)

📦
version 7.2.2 · 11 versions
, in fedora 43, fedora 44

💅 PMDASAMBA 💅

okay bestie, gather round, we're talking about pmdasamba — the Samba performance metrics domain agent (PMDA), part of the Performance Co-Pilot crew. she's the plug that gets your Samba numbers out into the open. periodt.

✨ DESCRIPTION ✨

so pmdasamba is a Performance Metrics Domain Agent (PMDA), and what she does is export metric values straight out of Samba, aka the Windows SMB/CIFS server for UNIX. iconic behavior honestly.

but listen, there's a catch, and it's giving prerequisite energy: for those values to actually be available through this PMDA, Samba must have been built with profiling support. how do you know? you go check for WITH_PROFILE in the output of smbd -b. no WITH_PROFILE, no metrics, sorry babe. 😭

this PMDA is also kinda extra in the best way — she dynamically enumerates a whole bunch of her metric hierarchy, based on whatever's in smbstatus --profile. she's flexible like that. 🦋

and when the agent gets installed (peep the next section), the Install script will try to switch on Samba statistics gathering, using smbcontrol --profile. she's proactive, we love that.

🎀 INSTALLATION 🎀

you want access to the names and values for the samba performance metrics? say less. as root, do this:

# cd $PCP_PMDAS_DIR/samba
# ./Install

and if you wanna undo the whole thing (no judgment, sometimes we change our minds), as root do:

# cd $PCP_PMDAS_DIR/samba
# ./Remove
real talk though: pmdasamba gets launched by pmcd(1) and should never be executed directly. do not run her yourself, she has a whole launch situation handled. 💀

the Install and Remove scripts are the ones that notify pmcd(1) when the agent gets installed or removed. they're the group chat that keeps everyone in the loop. 🫶

🌸 FILES 🌸

  • $PCP_PMDAS_DIR/samba/Install — the installation script for the pmdasamba agent
  • $PCP_PMDAS_DIR/samba/Remove — the undo-installation script for the pmdasamba agent
  • $PCP_LOG_DIR/pmcd/samba.log — the default log file where pmdasamba's error messages go

👑 SEE ALSO 👑

pmcd(1), samba(7) and smbd(8). go read 'em, iykyk. 💜

and that's the whole vibe, bestie — this was version 7.2.2 of the Performance Co-Pilot manual, dated with all the PCP energy it deserves. mwah, stan a well-documented PMDA. 💖✨🎀

📦 where this page comes from