PMDAELASTICSEARCH(1)

💅 PMDAELASTICSEARCH 💅

okay bestie, sit down, hydrate, and let me tell you about pmdaelasticsearch — a page from the General Commands Manual, no cap. this is the whole vibe, top to bottom, and yes we're keeping every single detail because that's just how we are 🫶

---

✨ NAME ✨

pmdaelasticsearch — the elasticsearch performance metrics domain agent (aka a PMDA, if you're in the know, iykyk) 💖

---

🌸 DESCRIPTION 🌸

so. pmdaelasticsearch is a Performance Metrics Domain Agent (PMDA, bestie, keep up 💅) and its whole job — its entire main character arc — is exporting performance metrics from elasticsearch. that's it. that's the gig. iconic behavior honestly ✨

---

🎀 INSTALLATION 🎀

before any of this works, real talk: this PMDA requires that elasticsearch is running on the local host and is accepting queries on TCP port 9200. no elasticsearch on port 9200, no metrics, no slay. 🙈

to install the elasticsearch PMDA, use the Install script as root:

# cd $PCP_PMDAS_DIR/elasticsearch
# ./Install

and to uninstall, do this as root:

# cd $PCP_PMDAS_DIR/elasticsearch
# ./Remove

now the important part, do not skip this 🚨: pmdaelasticsearch is launched by pmcd(1) and should never be executed directly. like, ever. it's not that kind of program. the Install and Remove scripts are the ones that notify pmcd(1) when the agent is installed or removed — they handle the whole communication thing so you don't have to. periodt 💅

---

🦋 FILES 🦋

• $PCP_PMDAS_DIR/elasticsearch/elasticsearch.conf — optional configuration file for pmdaelasticsearch. optional!! so if you don't need it, don't stress 🌸
• $PCP_PMDAS_DIR/elasticsearch/Install — the installation script for the pmdaelasticsearch agent
• $PCP_PMDAS_DIR/elasticsearch/Remove — the undo installation script for the pmdaelasticsearch agent (the "never mind, take it back" button 💀)
• $PCP_LOG_DIR/pmcd/elasticsearch.log — default log file for error messages from pmdaelasticsearch. when something goes wrong, this is where the tea is ☕

---

🌈 PCP ENVIRONMENT 🌈

environment variables with the prefix PCP_ are used to parameterize the file and directory names used by PCP — think of them as the little name tags everything wears 🏷️

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). so if you wanna point it somewhere else, you absolutely can, bestie ✨

---

👑 SEE ALSO 👑

PCPIntro(1) and pmcd(1). go read those next, they're the supporting cast and they ate 💖

---

and that's the whole page, you're officially educated 🎓✨

this has been Performance Co-Pilot, PCP — the PMDAELASTICSEARCH(1) moment, brought to you fresh and forever. stay metrics-obsessed, stay hydrated, and never run the agent directly. mwah 💋🦋