1ZBXPCP(3) Library Functions Manual ZBXPCP(3)
2
3
4
6 zbxpcp - Zabbix Agent Loadable PCP Module
7
9 The zbxpcp loadable module extends Zabbix agent by making Performance
10 Co-Pilot (PCP) metrics available to it. With the zbxpcp module config‐
11 ured in zabbix_agentd.conf all the PCP metrics are available from the
12 Zabbix agent like any other agent items. As a loadable module (DSO)
13 zbxpcp does not rely on any external programs but directly uses the PCP
14 APIs to fetch PCP metrics when requested.
15
16 A typical PCP installation on Linux offers over 1000 metrics by default
17 and is in turn extensible with its own plugins, or PMDAs (``Performance
18 Metrics Domain Agents''). In addition to very complete /proc based sta‐
19 tistics, readily available PCP PMDAs provide support for such system
20 and application level components as Apache, CIFS, 389 Directory Server,
21 GFS2, Gluster, InfiniBand, KVM, MySQL, NFS, Postfix, PostgreSQL, Samba,
22 and Sendmail, among others. In addition to Linux, PCP also runs on Mac
23 OS X, FreeBSD, NetBSD, Solaris, and Windows.
24
25 For PCP introduction, see PCPIntro(5). To investigate the available
26 PCP metrics, use for example pminfo(1). The PCP Quick Reference Guide
27 is available at its home page http://pcp.io/.
28
29 For general information about Zabbix data collection and loadable mod‐
30 ules, see https://www.zabbix.com/documentation/3.0/manual/config/items.
31 For Zabbix introduction and downloads, see http://www.zabbix.com/.
32
33 zbxpcp is compatible with the Zabbix module API version 1.
34
36 First make sure PCP is installed and configured properly, see the above
37 references for instructions and use for example pminfo(1) to make sure
38 the PCP metrics can be fetched. To enable the zbxpcp loadable module in
39 a Zabbix agent, the following lines must be added to the Zabbix agent
40 configuration file zabbix_agentd.conf (make sure to use the correct
41 LoadModulePath):
42
43 LoadModulePath=/usr/lib64/zabbix/agent/
44 LoadModule=zbxpcp.so
45
46 After restarting the Zabbix agent all the PCP metrics will be available
47 with the ``pcp.'' prefix like all the other agent items. This can be
48 verified with the commands:
49
50 $ pminfo -t
51 $ zabbix_agentd -p
52 $ pminfo -f kernel.all.sysfork
53 $ zabbix_get -s 127.0.0.1 -p 10050 -k pcp.kernel.all.sysfork
54
55 Then to collect PCP metrics from Zabbix agents, the Zabbix server side
56 configuration is as usual (see Zabbix documentation if needed).
57
58 The PCP pmcd service must always be running when starting up a zbxpcp
59 enabled Zabbix agent, otherwise the module will fail to load and the
60 PCP metrics will not become available. Special care must be taken to
61 make sure this happens also when rebooting the system. A pmcd restart
62 needs to be followed by a Zabbix agent restart.
63
65 /etc/zabbix/zabbix_agentd.conf
66 Typical Zabbix agent configuration file location.
67 $(PCP_LIB_DIR)/zabbix/agent/zbxpcp.so
68 Zabbix agent loadable PCP module.
69
71 PCPIntro(1), pminfo(1), pmrep(1), zabbix_get(1) and zabbix_agentd(8).
72
73
74
75Performance Co-Pilot PCP ZBXPCP(3)