1ZBXPCP(3)                  Library Functions Manual                  ZBXPCP(3)
2
3
4

NAME

6       zbxpcp - Zabbix Agent Loadable PCP Module
7

DESCRIPTION

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

CONFIGURATION

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

FILES

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

SEE ALSO

71       PCPIntro(1), pminfo(1), pmrep(1), zabbix_get(1) and zabbix_agentd(8).
72
73
74
75Performance Co-Pilot                  PCP                            ZBXPCP(3)
Impressum