NAME

       zbxpcp - Zabbix Agent Loadable PCP Module

DESCRIPTION

       The zbxpcp loadable module extends Zabbix agent by making Performance Co-Pilot (PCP) metrics available to
       it.   With  the zbxpcp module configured in zabbix_agentd.conf all the PCP metrics are available from the
       Zabbix agent like any other agent items.  As a loadable module (DSO) zbxpcp does not rely on any external
       programs but directly uses the PCP APIs to fetch PCP metrics when requested.

       A typical Linux PCP installation offers over 1,000 metrics by default and is in turn extensible with  its
       own  plugins, or PMDAs (``Performance Metrics Domain Agents'').  In addition to very complete /proc based
       statistics, readily available PCP PMDAs provide support for such system and application level  components
       as  389  Directory  Server,  Apache,  containers,  HAProxy,  GFS2,  Gluster, libvirt, MySQL, NFS, Oracle,
       Postfix, PostgreSQL, Samba, and Sendmail, among others.  PCP  also  runs  on  many  platforms,  including
       Linux, Mac OS X, FreeBSD, NetBSD, Solaris, and Windows.

       For  PCP  introduction,  see  PCPIntro(1).   To  investigate  the  available PCP metrics, use for example
       pminfo(1).  The PCP Quick Reference Guide is available at the PCP home page https://pcp.io/.

       For   general   information   about    Zabbix    data    collection    and    loadable    modules,    see
       https://www.zabbix.com/documentation/3.0/manual/config/items.  For Zabbix introduction and downloads, see
       https://www.zabbix.com/.

       zbxpcp is compatible with the Zabbix module API version 1.

CONFIGURATION

       First  make  sure PCP is installed and configured properly, see the above references for instructions and
       use for example pminfo(1) to make sure the PCP metrics can be fetched.  To  enable  the  zbxpcp  loadable
       module  in  a  Zabbix  agent,  the  following  lines must be added to the Zabbix agent configuration file
       zabbix_agentd.conf (make sure to use the correct LoadModulePath):

           LoadModulePath=/usr/lib64/zabbix/agent/
           LoadModule=zbxpcp.so

       After restarting the Zabbix agent all the PCP metrics will be available with the  ``pcp.''   prefix  like
       all the other agent items.  This can be verified with the commands:

           $ pminfo -t
           $ zabbix_agentd -p
           $ pminfo -f kernel.all.sysfork
           $ zabbix_get -s 127.0.0.1 -p 10050 -k pcp.kernel.all.sysfork

       Then  to  collect  PCP  metrics from Zabbix agents, the Zabbix server side configuration is as usual (see
       Zabbix documentation if needed).

       The PCP pmcd service must always be running when starting up a zbxpcp enabled Zabbix agent, otherwise the
       module will fail to load and the PCP metrics will not become available.  Special care must  be  taken  to
       make sure this happens also when rebooting the system.

FILES

       /etc/zabbix/zabbix_agentd.conf
              Typical Zabbix agent configuration file location.

       /etc/zabbix/zbxpcp-derived-metrics.conf
              Optional  PCP  derived metrics configuration file for zbxpcp.  See pmLoadDerivedConfig(3) for more
              info on derived metrics.

       $PCP_LIB_DIR/zabbix/agent/zbxpcp.so
              Zabbix agent loadable PCP module.

SEE ALSO

       PCPIntro(1), pminfo(1), pmrep(1), zabbix_get(1), pmLoadDerivedConfig(3) and zabbix_agentd(8).

Performance Co-Pilot                                   PCP                                             ZBXPCP(3)